Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Questions fréquentes

Sur cette page, vous trouverez des réponses aux questions fréquemment posées sur Liquid.

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

Comment utiliser les extraits de code Liquid dans Braze ?

Dans de nombreux cas, vous pouvez intégrer des extraits de code Liquid en accédant à vos Campaigns ou Canvas, puis en insérant du Liquid dans la fenêtre modale de personnalisation, par exemple dans le corps d’un e-mail ou dans vos segments.

Où puis-je en savoir plus ?

Pour en savoir plus sur Liquid, consultez notre parcours guidé Personnalisation dynamique avec Liquid sur Braze Learning ! Vous pouvez également consulter la bibliothèque de cas d’utilisation Liquid pour trouver de l’inspiration et une variété d’exemples de personnalisation utilisant Liquid.

Quelle est la différence entre l’utilisation de Liquid et du Contenu connecté pour la personnalisation ?

Le Contenu connecté de Braze est un exemple d’étiquette Liquid. Il est également utilisé pour la personnalisation, mais les données proviennent d’un endpoint externe plutôt que de données stockées dans Braze. Consultez notre section dédiée au Contenu connecté pour en savoir plus sur les possibilités de personnalisation de vos messages.

Qu’est-ce que le templating Liquid ?

C’est la manière la plus courante d’utiliser Liquid dans Braze. Le templating Liquid consiste à extraire des données du profil d’un utilisateur pour les insérer dans un message. Ces données peuvent aller du prénom de l’utilisateur aux événements personnalisés issus d’un message déclenché par un événement.

Consultez les Étiquettes 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 composeur de messages qui peut également être référencée dans l’ensemble de votre message.

L’utilisation de Liquid consomme-t-elle des points de donnée ?

Non.

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

Pour un message d’accueil personnalisé utilisant le prénom de l’utilisateur, vous pouvez extraire 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 quel critère, comme le jour de la semaine ou des attributs personnalisés. Pour plus d’informations sur les opérateurs Liquid pris en charge dans les instructions conditionnelles, consultez Opérateurs.

Comment personnaliser un message en fonction de la localisation d’un client ?

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

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

{{campaign.${name}}} et {{campaign.${message_name}}} sont toutes deux des étiquettes de personnalisation Liquid prises en charge. Ces deux étiquettes font référence aux attributs de la Campaign. {{campaign.${name}}} désigne le nom de votre Campaign, et {{campaign.${message_name}}} est 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 du code Liquid pour les segments pouvant être utilisés dans un message. Plus précisément, vous pouvez créer un segment correspondant à plusieurs critères au sein d’un objet.

Pour plus d’informations, consultez Segmentation multicritères.

Comment utiliser les propriétés 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 API avec l’étiquette api_triggered_property : {{api_trigger_properties.${attribute_key}}}.

Pourquoi mon Liquid déclenché par API échoue-t-il dans Braze ?

Une paire d’accolades supplémentaire est une cause fréquente. Par exemple, {{{api_trigger_properties.${attribute_key}}}} n’est pas une syntaxe de personnalisation Braze valide. Utilisez exactement deux accolades ouvrantes et deux accolades fermantes : {{api_trigger_properties.${attribute_key}}}.

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

La logique d’abandon vous permet d’empêcher l’envoi d’un message si les conditions sont remplies. Cela est particulièrement utile pour éviter d’envoyer des messages incomplets à vos utilisateurs. Pour des exemples de logique d’abandon dans vos campagnes marketing, consultez Abandon de messages.

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

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

Dans Braze, cela peut être utilisé pour vérifier des éléments dans un attribut personnalisé de type tableau, ou une liste de valeurs et d’objets renvoyés par un appel de catalogue, de sélection ou de Contenu connecté. Plus précisément, vous pouvez utiliser la logique de boucle for dans vos messages pour vérifier si un produit est en stock ou s’il a une note minimale.

Par exemple, supposons que vous ayez un catalogue appelé « Games » avec une sélection appelée « cheap_games ». Pour extraire les titres des jeux dans « cheap_games », vous pouvez utiliser cet extrait de code Liquid :

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

Une fois les conditions définies remplies, votre message peut être envoyé. Cette logique est un moyen pratique de gagner du temps, plutôt que de répéter des blocs Liquid pour différentes conditions.

Pourquoi y a-t-il des espaces supplémentaires dans les messages utilisant des Content Blocks ?

Si vous remarquez des espaces supplémentaires dans les messages envoyés qui utilisent des Content Blocks avec Liquid, il se peut que vous ayez des sauts de paragraphe ou de ligne inutiles dans vos instructions conditionnelles. Écrivez vos instructions conditionnelles sur une seule ligne plutôt que sur plusieurs lignes.

Exemple

{% if {{custom_attribute.${has_discount}}} == true %}Discounted Item{% elsif {{custom_attribute.${is_new_arrival}}} == true %}New Arrival{% else %}Regular Item{% endif %}

Quand utiliser `assign` plutôt que `capture` ?

assign et capture créent tous deux des variables Liquid, mais ils ont des usages différents :

assign est destiné aux variables simples qui stockent une seule valeur, comme une valeur booléenne, un nombre ou une chaîne de caractères simple. Vous pouvez également appliquer un seul filtre sur la même ligne.
capture est destiné au stockage d’un bloc de texte pouvant inclure plusieurs variables, chaînes de caractères ou expressions complexes.

Utilisez capture lorsque la valeur est trop complexe pour une seule instruction assign, comme des URL utilisant d’autres variables Liquid ou des attributs personnalisés en tant que paramètres. capture est également préféré lors de l’implémentation de variables Liquid dans le corps des appels de Contenu connecté.

Exemples

{% comment %}Use assign for custom attributes{% endcomment %}
{% assign name = {{custom_attribute.${first_name}}} %}
{% assign price = {{custom_attribute.${price}}} | plus: 0 %}

{% comment %}Use assign for a simple variable{% endcomment %}
{% assign discount_label = "20% off" %}
Hello {{ customer.first_name | default: "there" }}, enjoy {{ discount_label }} on your next order!

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

{% comment %}Use capture to create conditional content{% endcomment %}
{% capture promo_block %}
{% if customer.vip == true %}
As a VIP member, you get free shipping.
{% else %}
Join our VIP program to unlock free shipping.
{% endif %}
{% endcapture %}

New Stuff!