Utilisation de Liquid

Cet article montre comment vous pouvez utiliser une variété d’attributs d’utilisateur pour insérer dynamiquement des informations personnelles dans votre envoi de messages.

Liquid est un langage de modélisation open-source développé par Shopify et écrit en Ruby. Vous pouvez l’utiliser dans Braze pour intégrer les données du profil utilisateur dans vos messages et personnaliser ces données. Par exemple, vous pouvez utiliser les étiquettes Liquid pour créer des messages conditionnels, comme l’envoi d’offres différentes en fonction de la date anniversaire de l’abonnement d’un utilisateur. En outre, les filtres peuvent manipuler les données, par exemple en formatant la date d’inscription d’un utilisateur à partir d’un horodatage dans un format plus lisible, tel que “15 janvier 2022”. Pour plus de détails sur la syntaxe Liquid et ses possibilités, reportez-vous à la section Tags de personnalisation pris en charge.

Fonctionnement

Les balises Liquid agissent comme des indicateurs de niveau dans vos messages qui peuvent tirer des informations soumises à consentement sur le compte de votre utilisateur, et permettre la personnalisation et les pratiques de messagerie pertinentes.

Dans le bloc suivant, vous pouvez voir qu’une double utilisation d’une balise Liquid pour appeler le prénom de l’utilisateur, ainsi qu’une balise par défaut si le prénom d’un utilisateur n’est pas enregistré.

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

Pour un utilisateur nommé Janet Doe, le message s’affiche comme suit :

1
Hi Janet, thanks for using the App!

OU

1
Hi Valued User, thanks for using the App!

Valeurs prises en charge à remplacer

Les valeurs suivantes peuvent être remplacées par un message, selon leur disponibilité :

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

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

Utilisation de Liquid

Grâce aux étiquettes Liquid, vous pouvez rehausser la qualité de vos messages en les enrichissant d’une touche de personnalisation.

Syntaxe en Liquid

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

1. Utilisez des guillemets droits dans Braze : Il existe une différence entre les guillemets frisés (‘’) et les guillemets droits (‘’). Utilisez des guillemets droits (‘’) dans votre liquide dans Braze. Vous pouvez voir des guillemets courbes lorsque vous copiez-collez certains éditeurs de texte, ce qui peut entraîner des problèmes dans votre Liquid. Si vous saisissez des guillemets directement dans le tableau de bord de Braze, cela sera parfait !
2. Les parenthèses fonctionnent par deux : Une parenthèse ouverte doit être suivie d’une parenthèse fermée { }. Assurez-vous d’utiliser des parenthèses courbes !
3. Les déclarations sont présentées par paires : Pour chaque if, vous avez besoin d’un endif pour indiquer que l’énoncé if a pris fin.

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 (tiré du profil de l’utilisateur) sera remplacé lorsque le message est envoyé. Vous pouvez utiliser le même format avec d’autres attributs par défaut de l’utilisateur.

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é « code postal », vous ajoutez {{custom_attribute.${zip code}}} à votre message.

Insertion des balises

Vous pouvez insérer des balises en saisissant deux parenthèses courbes {{ dans n’importe quel message, ceci déclenchera une fonctionnalité d’achèvement automatique qui continuera à être mise à jour lors de votre saisie. Vous pouvez même sélectionner une variable à partir des options qui s’affichent alors que vous saisissez.

Si vous utilisez une balise personnalisée, vous pouvez copier et coller la balise dans le message que vous souhaitez.

Insérer des variables préformatées

Vous pouvez insérer des variables préformatées avec des valeurs par défaut par le biais de la fenêtre modale/boîte de dialogue Ajouter une personnalisation située en haut à droite de n’importe quel champ de texte modélisé.

Le message modal insère votre valeur par défaut spécifiée dans Liquid à l’endroit où se trouvait votre curseur. Le point d’insertion est également spécifié par la boîte de prévisualisation, qui contient le texte avant et après. Si un bloc de texte est mis en surbrillance, le texte mis en surbrillance sera remplacé.

Attribution des variables

Certaines opérations dans Liquid exigent que vous stockiez la valeur que vous souhaitez manipuler comme variable. C’est souvent le cas si votre énoncé Liquid comprend plusieurs attributs, propriétés de l’événement ou filtres.

Supposons par exemple que vous souhaitiez ajouter deux entiers de données personnalisés.

Exemple de liquide incorrect

Vous ne pouvez pas utiliser :

1
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}

Ce Liquid ne fonctionne pas parce que vous ne pouvez pas référencer plusieurs attributs en une seule ligne ; vous devez affecter une variable à au moins l’une de ces valeurs avant que les fonctions mathématiques n’interviennent. L’ajout de deux attributs personnalisés nécessiterait deux lignes de Liquid : l’une pour attribuer l’attribut personnalisé à une variable et l’autre pour l’ajout.

Exemple de liquide correct

Vous pouvez utiliser :

1
2
{% assign value_one = {{custom_attribute.${one}}} %}
{% assign result = value_one | plus: {{custom_attribute.${two}}} %}

Tutoriel : Utiliser des variables pour calculer un solde

Calculons le solde actuel d’un utilisateur en additionnant le solde de sa carte cadeau et le solde de ses récompenses :

Tout d’abord, utilisez la balise assign pour remplacer l’attribut personnalisé de current_rewards_balance par le terme « solde ». Cela signifie que vous avez maintenant une variable intitulée balance que vous pouvez manipuler.

1
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}

Ensuite, nous utiliserons le filtre plus pour combiner le solde de la carte cadeau de chaque utilisateur avec son solde de récompenses, signifié par {{balance}}.

1
2
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!