Foire aux questions

Sur cette page, vous trouverez des réponses à certaines questions fréquemment posées au sujet de Liquid.

Braze ne prend actuellement pas en charge 100 % du Liquid de Shopify, mais seulement certaines parties que nous avons tenté de présenter dans notre documentation. Nous recommandons vivement de tester tous les messages utilisant Liquid avant de les envoyer pour réduire le risque d’erreurs ou d’utiliser du Liquid non pris en charge.

Comment utiliser les extraits de code Liquid dans Braze ?

Dans de nombreux cas, vous pouvez incorporer des extraits de code Liquid en accédant à vos campagnes ou canvas, et en insérant le code Liquid dans la fenêtre modale de personnalisation, dans des zones telles que le corps du message de l’e-mail ou dans vos segments.

Où puis-je en savoir plus ?

Pour en savoir plus sur Liquid, consultez notre parcours d’apprentissage guidé Personnalisation dynamique avec Liquid ! Vous pouvez également vous référer à la bibliothèque de cas d’utilisation Liquid pour trouver l’inspiration et une série d’exemples de personnalisation à l’aide de Liquid.

Quelle est la différence entre l’utilisation du contenu liquide et du contenu connecté pour la personnalisation ?

Le contenu connecté de Braze est un exemple d’étiquette Liquid. Elles sont également utilisées pour la personnalisation, mais ces données proviennent d’un endpoint externe plutôt que de données stockées au sein de Braze. Consultez notre section dédiée au contenu connecté pour en savoir plus sur l’élargissement de la personnalisation de vos messages.

Qu’est-ce que la « modélisation Liquid » ?

Il s’agit de la façon la plus courante d’utiliser Liquid dans Braze. La modélisation Liquid (Liquid Templating) consiste à intégrer dans un message des données provenant du profil d’un utilisateur. Ces données peuvent aller du prénom d’un utilisateur aux événements personnalisés d’un message déclenché.

Reportez-vous à la section Balises de personnalisation prises en charge pour obtenir la liste complète des étiquettes Liquid prises en charge.

Comment affecter des variables avec Liquid ?

Vous pouvez créer et affecter des variables en utilisant l’étiquette assign. Cela crée une variable dans le compositeur du message qui peut également être référencée dans votre message.

L’utilisation de Liquid enregistre-t-elle des points de données ?

Non.

Comment puis-je utiliser Liquid pour envoyer un message d’accueil personnalisé ?

Pour un message d’accueil personnalisé utilisant le prénom de l’utilisateur, vous pouvez récupérer les attributs standard du profil utilisateur, tels que {{${first_name}}}, {{${last_name}}}.

Vous pouvez également utiliser une instruction Liquid {% if X %} pour effectuer un rendu conditionnel basé sur n’importe quoi, comme le jour de la semaine ou des attributs personnalisés. Pour plus d’informations sur les opérateurs Liquid pris en charge et pouvant être utilisés dans les instructions conditionnelles, consultez la rubrique Opérateurs.

Comment puis-je personnaliser un message en fonction de l’emplacement/localisation d’un client ?

Il existe un attribut par défaut pour l’emplacement/localisation de l’utilisateur : {{${most_recent_location}}}.

Quelle est la différence entre {{campaign.${name}}} et {{campaign.${message_name}}} ?

Les étiquettes de personnalisation liquide {{campaign.${name}}} et {{campaign.${message_name}}} sont toutes deux prises en charge. Les deux tags font référence aux attributs de la campagne. {{campaign.${name}}} indique le nom de votre campagne, et {{campaign.${message_name}}} le nom de votre variante de message.

Comment utiliser Liquid avec des objets imbriqués ?

Braze dispose d’une fonctionnalité intégrée qui génère le code Liquid pour les segments pouvant être utilisés dans un message. Plus précisément, vous pouvez créer un segment qui correspond à plusieurs critères d’un objet.

Pour en savoir plus, consultez la rubrique Segmentation multicritères.

Comment utiliser les attributs d’événement pour personnaliser un message déclenché par un événement ?

Vous pouvez accéder aux propriétés des événements déclenchés par l’API à l’aide du tag api_triggered_property : {{api_trigger_properties.${attribute_key}}}.

Qu’est-ce que la logique d’abandon et comment puis-je l’utiliser ?

La logique conditionnelle vous permet d’interrompre l’envoi d’un message si les conditions sont remplies. Cela permet notamment d’éviter l’envoi de messages incomplets à vos utilisateurs. Pour connaître des exemples de logique d’abandon dans vos campagnes marketing, lisez la rubrique Abandon des messages.

Qu’est-ce que la logique de la boucle for et comment puis-je l’utiliser ?

Les boucles “for” sont également connues sous le nom d’étiquettes d’itération. L’utilisation de la logique de boucle dans vos extraits de code Liquid vous permet de répéter des blocs de Liquid jusqu’à ce qu’une condition soit remplie.

Dans Braze, cela pourrait être utilisé pour vérifier les éléments d’un attribut personnalisé de type tableau, ou une liste de valeurs et d’objets renvoyés par un catalogue, une sélection ou une réponse à un appel de contenu connecté. Plus précisément, vous pouvez utiliser une logique de boucle dans le cadre de votre communication pour vérifier si un produit est en stock ou si un produit présente une cote minimale.

Par exemple, supposons que vous disposiez d’un catalogue intitulé « Jeux » contenant une sélection nommée”cheap_games”.. Pour extraire les titres des jeux,”cheap_games”,vous pourriez utiliser cet extrait de code Liquid :

1
2
3
4
{% catalog_selection_items Games cheap_games %}
{% for item in items %}
 Get this game: {{ item.title }}
{% endfor %}

Une fois que les conditions fixées sont remplies, votre message peut être transmis. L’utilisation de cette logique est un moyen utile de gagner du temps, au lieu de répéter les blocs Liquid pour différentes conditions.

Pourquoi y a-t-il des espaces supplémentaires dans les messages qui utilisent des blocs de contenu ?

Si vous remarquez des espaces supplémentaires dans les messages envoyés qui utilisent des blocs de contenu avec Liquid, il se peut que vos instructions conditionnelles contiennent des sauts de paragraphe ou de ligne inutiles. Veuillez rédiger vos instructions conditionnelles sur une seule ligne plutôt que sur plusieurs lignes.

Exemple

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% if {{custom_attribute.${has_discount}}} == true %}Discounted Item{% elsif {{custom_attribute.${is_new_arrival}}} == true %}New Arrival{% else %}Regular Item{% endif %}


### When should I use `assign` versus `capture`?

Both `assign` and `capture` create Liquid variables, but they serve different purposes:

- `assign` is for simple variables that store a single value, such as a boolean, number, or simple string. You can also apply a single filter in the same line.
- `capture` is for storing a block of text that may include multiple variables, strings, or complex expressions. Use `capture` when the value is too complex for a single `assign` statement, such as URLs that utilize other Liquid variables or custom attributes as parameters. `capture` is also preferred when implementing Liquid variables in the body of Connected Content calls.

#### Examples


```liquid
{% comment %} Valid assign usage {% endcomment %}
{% assign name = {{custom_attribute.${first_name}}} %}
{% assign price = {{custom_attribute.${price}}} | plus: 0 %}

{% comment %} Use capture for complex strings {% endcomment %}
{% capture greeting %}Hello, {{custom_attribute.${first_name}}}! Your order #{{custom_attribute.${order_id}}} is ready.{% endcapture %}
{{ greeting }}