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 da mídia, selecionando de forma inteligente o melhor ativo para cada usuário com base em suas atribuições em tempo real.

Se você incluir tags Liquid como parâmetros em um link Cloudinary em uma mensagem de campanha do Braze, quando a mensagem for enviada, as atribuições associadas do Braze substituirão dinamicamente as tags Liquid. Podem ser dados específicos do usuário, como idioma ou nível de cliente. O Cloudinary usará essas atribuições 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 atribuições Braze como language=en ou tier=gold. Quando o Braze chama o link do Cloudinary, uma função personalizada processa os atributos recebidos, procura o ativo com tags e metadados correspondentes e, em seguida, retorna a correspondência mais adequada.

Se uma correspondência exata não for encontrada, a função seleciona automaticamente uma opção fallback ou “next best” para 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 tag, metadados e funções personalizadas oferece aos desenvolvedores uma maneira flexível e orientada por API para automatizar o fornecimento personalizado 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 da lista for restrito, o Cloudinary não poderá fornecer a lista dinâmica necessária para a seleção personalizada de ativos nas campanhas do Braze.

• Liberar o tipo de entrega de lista: Abra as Configurações de segurança em seu Console do Cloudinary e desmarque o item da 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 de sua função personalizada para o Cloudinary DAM.
3. Crie o URL do Cloudinary para a tag desejada.
4. Usando o URL da tag como base, adicione tags Liquid de imagem dinâmica para incorporar os atributos do Braze e a função personalizada.

Exemplo de URL

Este exemplo presume que os ativos no Cloudinary têm dois campos SMD definidos (“localização” e “público”) preenchidos com os valores esperados correspondentes às atribuições do Braze. Além disso, os ativos necessários para a campanha receberam a tag “samples”, e a função personalizada segmentedBanner.js foi feita upload 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 localização 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 localização es:

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

• URL da imagem fallback:

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