Utiliser Liquid

Cet article vous montre comment utiliser différents attributs utilisateur pour insérer dynamiquement des informations personnelles dans vos messages.

Liquid est un langage de modèles open source développé par Shopify et écrit en Ruby. Vous pouvez l’utiliser dans Braze pour extraire les données du profil utilisateur dans vos messages et personnaliser ces données. Par exemple, vous pouvez utiliser des étiquettes Liquid pour créer des messages conditionnels, comme envoyer différentes offres en fonction de la date anniversaire d’abonnement d’un utilisateur. De plus, les filtres peuvent manipuler les données, par exemple en convertissant la date d’inscription d’un utilisateur d’un horodatage vers un format plus lisible, tel que « 15 janvier 2022 ». Pour plus de détails sur la syntaxe Liquid et ses fonctionnalités, consultez Étiquettes de personnalisation prises en charge.

Comment ça fonctionne

Les étiquettes Liquid agissent comme des marques substitutives dans vos messages. Elles peuvent extraire des informations consenties du compte de votre utilisateur et permettre la personnalisation ainsi que des pratiques d’envoi de messages pertinentes.

Dans le bloc suivant, vous pouvez voir une double utilisation d’une étiquette Liquid pour appeler le prénom de l’utilisateur, ainsi qu’une étiquette par défaut au cas où l’utilisateur n’aurait pas enregistré son prénom.

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

Pour une utilisatrice nommée Janet Doe, le message apparaîtrait de l’une des manières suivantes :

1
Hi Janet, thanks for using the App!

Ou…

1
Hi Valued User, thanks for using the App!

Important

Les commentaires HTML (<!-- -->) sont supprimés avant toute lecture du Liquid, de sorte que les étiquettes Liquid à l’intérieur des commentaires HTML ne s’affichent pas dans votre message. Pour un rendu correct, assurez-vous que toutes les étiquettes Liquid que vous souhaitez utiliser se trouvent en dehors des commentaires HTML.

Valeurs prises en charge pour la substitution

Les valeurs suivantes peuvent être substituées dans un message, en fonction de leur disponibilité :

• Informations utilisateur de base (par exemple, first_name, last_name, email_address)
• Attributs personnalisés
  • Attributs personnalisés imbriqués
• Propriétés d’événement personnalisé
• Informations sur l’appareil le plus récemment utilisé
• Informations sur l’appareil ciblé

Vous pouvez également extraire du contenu directement depuis un serveur web grâce au Contenu connecté de Braze.

Important

Braze prend actuellement en charge Liquid jusqu’à la version Liquid 5 de Shopify incluse.

Utiliser Liquid

En utilisant les étiquettes Liquid, vous pouvez améliorer la qualité de vos messages en les enrichissant d’une touche personnelle.

Syntaxe Liquid

Liquid suit une structure, ou syntaxe, spécifique que vous devez garder à l’esprit lorsque vous créez une personnalisation dynamique. Voici quelques règles de base à retenir :

1. Utilisez des guillemets droits dans Braze : il y a une différence entre les guillemets courbes (’ ‘) et les guillemets droits (' '). Utilisez des guillemets droits (' ') dans votre Liquid dans Braze. Vous pouvez voir des guillemets courbes lors du copier-coller depuis certains éditeurs de texte, ce qui peut causer des problèmes dans votre Liquid. Si vous saisissez les guillemets directement dans le tableau de bord de Braze, tout ira bien !
2. Les accolades vont par paires : chaque accolade doit être ouverte et fermée { }. Assurez-vous d’utiliser des accolades !
3. Les instructions if vont par paires : pour chaque if, vous avez besoin d’un endif pour indiquer que l’instruction if est terminée.
4. Les instructions case vont par paires : pour chaque case, vous avez besoin d’un endcase pour fermer le bloc.
5. Les noms de variables doivent utiliser des caractères ASCII : les noms de variables Liquid (créés avec assign ou capture) ne prennent en charge que les lettres ASCII, les chiffres et les underscores. Les noms d’attributs de personnalisation Braze (à l’intérieur de custom_attribute.${...} ou event_properties.${...}) peuvent inclure des caractères non ASCII.

Où utiliser les opérateurs et les filtres

Les opérateurs (tels que ==, !=, >, and, or) et les filtres (tels que | size, | plus) ne peuvent être utilisés que dans des contextes Liquid spécifiques.

Lorsque vous avez besoin d’une valeur filtrée dans un contexte qui ne prend pas en charge les filtres, assignez d’abord le résultat à une variable.

Utiliser le résultat d’un filtre dans une condition

Vous ne pouvez pas utiliser un filtre directement dans une instruction conditionnelle. Ceci est incorrect :

1
2
3
{% if my_array | size > 3 %}
You have more than 3 items!
{% endif %}

À la place, assignez le résultat du filtre à une variable :

1
2
3
4
{% assign array_size = my_array | size %}
{% if array_size > 3 %}
You have more than 3 items!
{% endif %}

Utiliser le résultat d’un filtre dans une boucle for

Vous ne pouvez pas appliquer un filtre à l’itérable dans une boucle for. Ceci est incorrect :

1
2
3
{% for item in my_array | reverse %}
{{ item }}
{% endfor %}

À la place, assignez la valeur filtrée à une variable :

1
2
3
4
{% assign reversed = my_array | reverse %}
{% for item in reversed %}
{{ item }}
{% endfor %}

Utiliser le résultat d’un filtre pour l’accès aux tableaux

Vous ne pouvez pas utiliser un filtre à l’intérieur de crochets. Ceci est incorrect :

1
{{ my_array[my_var | minus: 1] }}

À la place, assignez d’abord la valeur filtrée :

1
2
{% assign adjusted_index = my_var | minus: 1 %}
{{ my_array[adjusted_index] }}

Stocker le résultat d’une comparaison dans une variable

Vous ne pouvez pas utiliser un opérateur dans une instruction assign. Ceci est incorrect :

1
2
3
4
{% assign is_vip = total_spend > 100 %}
{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

À la place, utilisez une condition pour définir la variable :

1
2
3
4
5
6
7
8
{% assign is_vip = false %}
{% if total_spend > 100 %}
{% assign is_vip = true %}
{% endif %}

{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

Attributs par défaut et attributs personnalisés

Si vous incluez le texte suivant dans votre message : {{${first_name}}}, le prénom de l’utilisateur (extrait du profil utilisateur) sera substitué lors de l’envoi du message. Vous pouvez utiliser le même format avec d’autres attributs utilisateur par défaut.

Si vous souhaitez utiliser la valeur d’un attribut personnalisé, vous devez ajouter l’espace de noms « custom_attribute » à la variable. Par exemple, pour utiliser un attribut personnalisé nommé « zip code », vous incluriez {{custom_attribute.${zip code}}} dans votre message.

Insérer des étiquettes

Vous pouvez insérer des étiquettes en tapant deux accolades ouvrantes {{ dans n’importe quel message, ce qui déclenchera une fonctionnalité d’auto-complétion qui continuera à se mettre à jour au fur et à mesure de votre saisie. Vous pouvez même sélectionner une variable parmi les options qui apparaissent pendant que vous tapez.

Si vous utilisez une étiquette personnalisée, vous pouvez copier et coller l’étiquette dans le message de votre choix.

Exceptions pour les doubles accolades

Si vous utilisez une étiquette à l’intérieur d’une autre étiquette Liquid, comme {% assign %} ou {% if %}, vous pouvez utiliser soit les doubles accolades, soit aucune accolade. Ce n’est que lorsque l’étiquette est utilisée seule qu’elle doit être encadrée par des doubles accolades. Par souci de simplicité, vous pouvez toujours utiliser les doubles accolades.

Les étiquettes suivantes sont toutes correctes :

1
2
3
4
5
{% if custom_attribute.${Number_Game_Attended} == 1 %}
{% if {{custom_attribute.${Number_Game_Attended}}} == 1 %}

{% assign value_one = {{custom_attribute.${one}}} %}
{% assign value_one = custom_attribute.${one} %}

Remarque

Si vous utilisez Liquid dans vos e-mails, veillez à :

1. L’insérer en utilisant l’éditeur HTML plutôt que l’éditeur classique. L’éditeur classique peut interpréter le Liquid comme du texte brut. Par exemple, le Liquid serait interprété comme Hi {{ ${first_name} }}, thanks for using our service! au lieu d’insérer le prénom de l’utilisateur.
2. Placer le code Liquid uniquement à l’intérieur de la balise <body>. Le placer en dehors de cette balise peut entraîner un rendu incohérent lors de la réception.

Insérer des variables pré-formatées

Vous pouvez insérer des variables pré-formatées avec des valeurs par défaut via la fenêtre modale Ajouter une personnalisation située à proximité de tout champ de texte avec modèle.

La fenêtre modale insérera le Liquid avec votre valeur par défaut spécifiée à l’endroit où se trouvait votre curseur. Le point d’insertion est également indiqué par la zone de prévisualisation, qui affiche le texte avant et après. Si un bloc de texte est surligné, le texte surligné sera remplacé.