Cloudinary

Selecione dinamicamente os ativos da campanha com base nos atributos de direcionamento

Esse método de integração ativa a personalização dinâmica de mídia, selecionando de forma inteligente o melhor ativo para cada usuário com base em seus atributos em tempo real.

Se você incluir Liquid tags como parâmetros em um link do Cloudinary dentro de uma mensagem de Campaign da Braze, quando a mensagem for enviada, os atributos associados da Braze substituirão dinamicamente as Liquid tags. Podem ser dados específicos do usuário, como idioma ou nível de cliente. O Cloudinary usará esses atributos para determinar qual ativo de campanha é mais adequado para esse usuário e retornará automaticamente a imagem ou o vídeo correto. Isso faz com que os destinatários recebam apenas ativos que sejam contextualmente relevantes e aprovados pela marca.

Como funciona

O Cloudinary organiza os ativos da campanha usando tags e metadados estruturados (SMD) para torná-los pesquisáveis.

Cada ativo de campanha é agrupado em uma tag de campanha (por exemplo, spring_launch) e enriquecido com campos de metadados estruturados que correspondem a atributos da Braze como language=en ou tier=gold. Quando a Braze chama o link do Cloudinary, uma função personalizada processa os atributos recebidos, procura o ativo com tags e metadados correspondentes e retorna a correspondência mais adequada.

Se uma correspondência exata não for encontrada, a função seleciona automaticamente uma opção de fallback ou a “próxima melhor” para garantir continuidade em cada experiência. Quando o ativo é selecionado, a camada de transformação do Cloudinary (por exemplo, f_auto ou q_auto) otimiza a mídia para entrega. Essa combinação de tags, metadados e funções personalizadas oferece aos desenvolvedores uma maneira flexível e orientada por API para automatizar a entrega personalizada de ativos.

Pré-requisitos

Para ativar a seleção dinâmica de ativos, o Cloudinary deve ser capaz de retornar um conjunto de ativos com base em tags e metadados. Se o tipo de entrega de lista for restrito, o Cloudinary não poderá fornecer a lista dinâmica necessária para a seleção personalizada de ativos nas Campaigns da Braze.

• Libere o tipo de entrega de lista: abra as Configurações de segurança no Console do Cloudinary e desmarque o item de lista de recursos em Tipos de imagem restritos.

Configuração de seleção dinâmica

1. Configure a tag e os metadados dos ativos no Cloudinary.
2. Faça upload da sua função personalizada para o Cloudinary DAM.
3. Crie a URL do Cloudinary para a tag desejada.
4. Usando a URL da tag como base, adicione Liquid tags de imagem dinâmica para incorporar os atributos da Braze e a função personalizada.

Exemplo de URL

Este exemplo presume que os ativos no Cloudinary têm dois campos SMD definidos (“locale” e “audience”) preenchidos com os valores esperados correspondentes aos atributos da Braze. Além disso, os ativos necessários para a campanha receberam a tag “samples”, e a função personalizada segmentedBanner.js foi carregada na conta do Cloudinary.

1
2
3
4
5
6
7
// Use the appropriate Braze attributes.
{% assign audience = {{custom_attribute.${sample_audience_identifier}}} %}
{% assign locale = {{${language}}}%}

// The URL for the "samples" tag used in the campaign is https://papish.cloudinary.us/image/list/v1690000000/samples.json, which is the base for the dynamic image URL.
<img src="https://papish.cloudinary.us/image/list/f_auto,q_auto/$locale_#{locale}/$audience_!{audience}!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/campaigns/samples.json" alt="Banner">

URLs de saída

• URL de saída para usuários com público internal e locale en:

  1
  https://papish.cloudinary.us/image/list/f_auto,q_auto/$locale_!en!/$audience_!Internal!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json
  

• URL de saída para usuários com público external e locale es:

  1
  https://papish.cloudinary.us/image/list/$locale_!es!/$audience_!External!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json
  

• URL da imagem de fallback:

  1
  https://papish.cloudinary.us/image/list/$locale_!unknown!/$audience_!unknown!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json