Cloudinary

Selecciona dinámicamente los activos de la campaña en función de los atributos de segmentación

Este método de integración habilita la personalización dinámica de los medios, seleccionando de forma inteligente el mejor activo para cada usuario en función de sus atributos en tiempo real.

Si incluyes etiquetas Liquid como parámetros en un enlace Cloudinary dentro de un mensaje de campaña Braze, cuando se envíe el mensaje, los atributos Braze asociados sustituirán dinámicamente a las etiquetas Liquid. Puede tratarse de datos específicos del usuario, como el idioma o el nivel de cliente. Cloudinary utilizará entonces esos atributos para determinar qué activo de la campaña se ajusta mejor a ese usuario, y le devolverá automáticamente la imagen o el video correctos. Esto hace que los destinatarios sólo reciban activos que sean contextualmente relevantes y aprobados por la marca.

Cómo funciona

Cloudinary organiza los activos de la campaña mediante etiquetas y metadatos estructurados (SMD ) para facilitar su búsqueda.

Cada activo de campaña se agrupa bajo una etiqueta de campaña (por ejemplo, spring_launch) y se enriquece con campos de metadatos estructurados que corresponden a atributos Braze como language=en o tier=gold. Cuando Braze llama al enlace Cloudinary, una función personalizada procesa los atributos entrantes, busca el activo con etiquetas y metadatos coincidentes y, a continuación, devuelve la coincidencia más adecuada.

Si no se encuentra una coincidencia exacta, la función selecciona automáticamente una alternativa o “siguiente mejor” opción para la continuidad en cada experiencia. Cuando se selecciona el activo, la capa de transformación de Cloudinary (por ejemplo, f_auto o q_auto) optimiza los medios para su entrega. Esta combinación de etiquetado, metadatos y funciones personalizadas ofrece a los desarrolladores una forma flexible, basada en API, de automatizar la entrega personalizada de activos.

Requisitos previos

Para habilitar la selección dinámica de activos, Cloudinary debe ser capaz de devolver un conjunto de activos basados en etiquetas y metadatos. Si el tipo de entrega de la lista está restringido, Cloudinary no puede proporcionar la lista dinámica necesaria para la selección personalizada de activos en las campañas Braze.

• Desbloquea el tipo de entrega de la lista: Abre la Configuración de Seguridad en tu Consola Cloudinary, y borra el elemento de la lista Recursos en Tipos de imagen restringidos.

Configuración de selección dinámica

1. Configura la etiqueta y los metadatos de los activos en Cloudinary.
2. Sube tu función personalizada al DAM de Cloudinary.
3. Crea la URL Cloudinary para la etiqueta deseada.
4. Utilizando la URL de la etiqueta como base, añade etiquetas Liquid de imagen dinámica para incorporar atributos Braze y la función personalizada.

Ejemplo de URL

Este ejemplo supone que los activos en Cloudinary tienen dos campos SMD definidos (“localización” y “audiencia”) rellenados con los valores esperados correspondientes a los atributos Braze. Además, los activos necesarios para la campaña han recibido la etiqueta “muestras”, y la función personalizada segmentedBanner.js se ha cargado en la cuenta de 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"> 

URL de salida

• URL de salida para usuarios con audiencia internal y localización 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 salida para usuarios con audiencia external y localización es:

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

• URL de la imagen alternativa:

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