Cloudinary

Sélectionner dynamiquement les ressources de la campagne en fonction des attributs de ciblage.

Cette méthode d’intégration permet une personnalisation dynamique des médias en sélectionnant intelligemment la meilleure ressource pour chaque utilisateur en fonction de ses attributs en temps réel.

Si vous incluez des étiquettes Liquid en tant que paramètres dans un lien Cloudinary au sein d’un message de campagne Braze, lors de l’envoi du message, les attributs Braze associés remplaceront dynamiquement les étiquettes Liquid. Il peut s’agir de données spécifiques à l’utilisateur, telles que la langue ou le niveau de clientèle. Cloudinary utilisera alors ces attributs pour déterminer quelle ressource de campagne correspond le mieux à cet utilisateur, et renverra automatiquement la bonne image ou vidéo. Ainsi, les destinataires ne reçoivent que des ressources pertinentes en termes de contexte et approuvées par la marque.

Fonctionnement

Cloudinary organise les ressources de la campagne à l’aide de tags et de métadonnées structurées (SMD) pour les rendre consultables.

Chaque ressource de la campagne est regroupée sous une étiquette de campagne (par exemple, spring_launch) et enrichie de champs de métadonnées structurés qui correspondent à des attributs de Braze tels que language=en ou tier=gold. Lorsque Braze appelle le lien Cloudinary, une fonction personnalisée traite les attributs entrants, recherche la ressource avec les étiquettes et métadonnées correspondantes, puis renvoie la meilleure correspondance.

Si une correspondance exacte n’est pas trouvée, la fonction sélectionne automatiquement une solution de repli ou une “meilleure option suivante” pour assurer la continuité de chaque expérience. Lorsque la ressource est sélectionnée, la couche de transformation de Cloudinary (par exemple, f_auto ou q_auto) optimise le média pour la réception/distribution. Cette combinaison d’étiquettes, de métadonnées et de fonctions personnalisées offre aux développeurs un moyen flexible, basé sur l’API, d’automatiser la réception/distribution de ressources personnalisées.

Conditions préalables

Pour permettre une sélection dynamique des ressources, Cloudinary doit pouvoir renvoyer un ensemble de ressources en fonction des tags et des métadonnées. Si le type de réception/distribution de la liste est restreint, Cloudinary ne peut pas fournir la liste dynamique nécessaire à la sélection personnalisée des ressources dans les campagnes de Braze.

• Libérez le type de réception/distribution de la liste : Ouvrez les paramètres de sécurité dans votre console Cloudinary, et décochez l’élément de la liste des ressources sous Types d’images restreints.

Configuration de la sélection dynamique

1. Configurez l’étiquette et les métadonnées des ressources dans Cloudinary.
2. Téléchargez votre fonction personnalisée sur le DAM de Cloudinary.
3. Créez l’URL Cloudinary pour l’étiquette souhaitée.
4. En utilisant l’URL de la balise comme base, ajoutez des étiquettes Liquid d’image dynamique pour incorporer les attributs Braze et la fonction personnalisée.

Exemple d’URL

Cet exemple suppose que les ressources dans Cloudinary ont deux champs SMD définis (“locale” et “audience”) renseignés avec les valeurs attendues correspondant aux attributs Braze. En outre, les ressources nécessaires à la campagne ont reçu l’étiquette “samples” et la fonction personnalisée segmentedBanner.js a été téléchargée sur le compte 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 sortie

• URL de sortie pour les utilisateurs ayant l’audience internal et la 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 sortie pour les utilisateurs ayant l’audience external et la locale es:

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

• URL de l’image de repli :

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