Skip to content

Étiquette Liquid message extras

Utilisez l’étiquette Liquid message_extras pour annoter vos événements d’envoi avec des données dynamiques provenant du Contenu connecté, des Catalogues, des attributs personnalisés (tels que la langue, le pays), des propriétés d’entrée Canvas ou d’autres sources de données.

L’étiquette Liquid message_extras ajoute des paires clé-valeur à l’événement d’envoi correspondant dans Currents et le Partage de données Snowflake.

Pour renvoyer des données dynamiques ou supplémentaires à votre événement d’envoi Currents ou Partage de données Snowflake, insérez l’étiquette Liquid appropriée dans le corps de votre message.

Voici un exemple du format standard de l’étiquette Liquid pour message_extras :

1

{% message_extras :key test :value 123 %}

Vous pouvez ajouter ces étiquettes selon vos besoins pour vos paires clé-valeur dans le corps du message. Cependant, la longueur totale de toutes les clés et valeurs ne doit pas dépasser 1 000 octets (1 Ko). Dans Currents et le Partage de données Snowflake, vous verrez un nouveau champ d’événement appelé message_extras pour vos événements d’envoi. Celui-ci génère une chaîne de caractères sérialisée en JSON dans un seul champ.

Comment les données message extras sont envoyées via Currents

Les message extras sont des paires clé-valeur attachées au moment de l’envoi. La configuration dépend du canal. Pour l’e-mail, elles sont ajoutées via les en-têtes. Pour les notifications push iOS, elles sont incluses dans le payload push. Tous les événements d’envoi pris en charge exposent le même champ message_extras dans Currents (et Snowflake) une fois le message envoyé.

Canaux pris en charge

L’étiquette message_extras est prise en charge pour tous les types de messages avec un événement d’envoi, ainsi que pour les événements d’impression de messages in-app. L’utilisation de message_extras avec les messages in-app nécessite que certaines versions minimales du SDK soient respectées.

Comment utiliser l’étiquette message_extras

  1. Dans le corps du message pour le canal, saisissez l’étiquette Liquid message_extras. Vous pouvez également utiliser la fenêtre modale Add Personalization et sélectionner Message Extras comme type de personnalisation.

La fenêtre modale Add Personalization avec Message Extras sélectionné comme type de personnalisation.

  1. Saisissez la paire clé-valeur pour chaque étiquette message_extras.

Un exemple de paires clé-valeur pour l'étiquette message extras. Le champ de titre indique « Your New Favorites ». Le message contient des paires clé-valeur pour l'étiquette message extras et la phrase suivante : « We're excited to bring you a side selection of fresh and exciting products that are sure to become your new go-to favorites »

  1. Une fois votre campagne ou votre Canvas envoyé, Braze attachera les données dynamiques au moment de l’envoi via les événements d’envoi Currents ou Partage de données Snowflake au champ message_extras.

Vérification de la syntaxe

Toute autre saisie qui ne correspond pas au standard d’étiquette décrit ci-dessus risque de ne pas être transmise à Currents ou Snowflake. Vérifiez que votre syntaxe ou votre formatage ne contient aucun des éléments suivants :

  • Délimiteurs inexistants, vides ou mal orthographiés
  • Clés en double (Braze enverra par défaut la première paire clé-valeur rencontrée)
  • Texte supplémentaire avant la définition des clés ou des valeurs
  • Clés et valeurs dans le mauvais ordre
    • Par exemple, {% message_extras :value 123 :key test %}

Envoi d’informations de codes de promotion à Currents

Vous pouvez combiner message_extras avec les codes de promotion pour envoyer des informations relatives à ces codes à Currents. Utilisez la balise capture pour enregistrer le code de promotion dans une variable, puis référencez cette variable dans message_extras :

1
2
3
4
5

{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}

Considérations

  • Les paires clé-valeur dépassant 1 000 octets (1 Ko) sont tronquées.
  • Les espaces sont comptabilisés dans le nombre de caractères. Notez que Braze supprime les espaces en début et en fin de chaîne.
  • Le JSON résultant ne produit que des valeurs de type chaîne de caractères.
  • Vous pouvez inclure des variables Liquid comme clé ou valeur, mais vous ne pouvez pas imbriquer d’autres étiquettes Liquid à l’intérieur de message_extras.
    • Par exemple, vous pourriez utiliser le Liquid suivant : {% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

Questions fréquemment posées

Comment puis-je associer le champ message_extras dans les événements d’envoi à mes événements d’engagement comme les ouvertures et les clics ?

Un dispatch_id est généré et fourni dans vos événements d’envoi. Il peut être utilisé comme identifiant unique pour relier des événements spécifiques de clic, d’ouverture ou de livraison. Vous pouvez interroger ce champ dans Currents ou Snowflake. Pour en savoir plus, consultez le comportement du Dispatch ID.

Puis-je utiliser message_extras avec les messages in-app ?

Oui, vous pouvez utiliser message_extras dans vos messages in-app à condition que les appareils de vos utilisateurs disposent des versions minimales du SDK suivantes :
New Stuff!