Filtres

Cet article de référence fournit un aperçu des filtres dans Liquid et présente les filtres pris en charge par Braze. Vous cherchez des idées sur la façon d’utiliser ces filtres ? Consultez notre bibliothèque de cas d’utilisation Liquid.

Les filtres permettent de modifier la sortie de nombres, chaînes de caractères, variables et objets dans Liquid. Vous pouvez utiliser des filtres pour reformater du texte statique ou dynamique, par exemple pour convertir une chaîne de caractères de minuscules en majuscules ou pour effectuer des opérations mathématiques comme l’addition ou la division.

Important

Braze ne prend pas en charge tous les filtres Liquid de Shopify. Cette page tente de répertorier les filtres Liquid que Braze a testés, mais il ne s’agit pas nécessairement d’une liste exhaustive. Testez toujours votre code Liquid avant d’envoyer des messages.

Si vous avez des questions sur un filtre qui n’est pas répertorié ici, contactez votre gestionnaire de la satisfaction client.

Syntaxe des filtres

Les filtres doivent être placés dans une balise de sortie {{ }} et sont indiqués par un caractère pipe |.

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

Dans cet exemple, Big Sale est une chaîne de caractères et upcase est le filtre appliqué.

Remarque

Les filtres peuvent être utilisés dans les instructions assign et les balises de sortie ({{ }}), mais pas dans les conditions (if, elsif, unless), les blocs case/when, les boucles for ou les crochets d’accès aux tableaux. Pour utiliser une valeur filtrée dans l’un de ces contextes, assignez d’abord le résultat à une variable. Pour plus de détails, consultez Où utiliser les opérateurs et les filtres.

Syntaxe pour plusieurs filtres

Vous pouvez utiliser plusieurs filtres sur une même sortie. Ils sont appliqués de gauche à droite.

• input
• output

1
 {{ "Big Sale" | upcase | remove: "BIG" }}

1
SALE

Filtres de tableaux

Les filtres de tableaux sont utilisés pour modifier la sortie des tableaux.

Filtres de couleur

Les filtres de couleur ne sont pas pris en charge dans Braze.

Filtres de police

Les filtres de police ne sont pas pris en charge dans Braze.

Filtres mathématiques

Les filtres mathématiques vous permettent d’effectuer des opérations mathématiques. Si vous utilisez plusieurs filtres sur une même sortie, ils seront appliqués de gauche à droite.

Conseil

Lorsque vous divisez des entiers par des entiers dans Liquid, si le résultat est un float (nombre à décimales), Liquid arrondira automatiquement à l’entier inférieur. En revanche, diviser des entiers par des floats donnera toujours un float. Vous pouvez donc convertir vos entiers en float (1.0, 2.0, 3.0) pour obtenir un float en retour.

Par exemple, {{15 | divided_by: 2}} renverra 7, tandis que {{15 | divided_by: 2.0}} renverra 7.5.

Opérations mathématiques avec des attributs personnalisés

Gardez à l’esprit que vous ne pouvez pas effectuer d’opérations mathématiques entre deux attributs personnalisés.

1
{{custom_attribute.${current_rewards_balance} | plus: {{custom_attribute.${giftcard_balance}}}}}

Cet exemple ne fonctionnerait pas car vous ne pouvez pas référencer plusieurs attributs personnalisés dans une seule ligne de Liquid. Vous devez plutôt assigner une variable à au moins l’une de ces valeurs avant d’exécuter les fonctions mathématiques. L’addition de deux attributs personnalisés nécessite deux lignes de Liquid :

1. Une pour assigner l’attribut personnalisé à une variable,
2. Une pour effectuer l’addition.

Cas d’utilisation : calculer le solde actuel

Supposons que nous voulions calculer le solde actuel d’un utilisateur en additionnant le solde de sa carte cadeau et le solde de ses récompenses.

1. Utilisez la balise assign pour substituer l’attribut personnalisé current_rewards_balance par le terme « balance ». Vous disposez maintenant d’une variable nommée balance que vous pouvez manipuler.

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

2. Utilisez le filtre plus pour combiner le solde de la carte cadeau de chaque utilisateur avec son solde de récompenses, représenté par l’objet {{balance}}.

• input
• output

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

1
You have $35 to spend!

Filtres monétaires

Si vous informez un utilisateur de son achat, d’un solde de compte ou de tout ce qui concerne de l’argent, vous devriez utiliser les filtres monétaires. Ces filtres garantissent que vos décimales sont au bon endroit et qu’aucune partie de votre mise à jour n’est perdue (comme ce 0 gênant à la fin).

Important

Pour formater correctement un nombre avec le filtre money, supprimez les virgules dans le nombre et ajoutez le filtre plus: 0 avant le filtre money. Par exemple, consultez le code Liquid suivant :

1
2
{% assign my_int = "350000.25" | plus: 0 %}
{{ my_int | money }}

Filtre money de Shopify versus filtre money de Braze

Avertissement

Le comportement du filtre money de Shopify diffère de son utilisation dans Braze. Consultez les exemples suivants pour une description précise du comportement attendu.

Si vous saisissez un attribut personnalisé (comme account_balance), vous devriez toujours utiliser le filtre money pour placer vos décimales au bon endroit et empêcher les zéros de disparaître à la fin des nombres :

1
${{custom_attribute.${account_balance} | money}}

AVEC LE FILTRE MONEY	SANS LE FILTRE MONEY
Où account_balance est saisi à 17.8.	Où account_balance est saisi à 17.8.

Le filtre money dans Braze diffère de celui de Shopify car il n’applique pas automatiquement les points décimaux selon un paramètre prédéfini. Par exemple, prenons le scénario suivant où rewards_redeemed contient une valeur de 145 :

• input
• output

1
${{event_properties.${rewards_redeemed} | money }}

1
$145.00

Selon le filtre money de Shopify, la sortie devrait être $1.45, mais dans Braze, la sortie sera $145.00. Pour contourner ce problème, vous pouvez utiliser le filtre divided_by pour convertir le nombre en décimal avant d’appliquer le filtre money :

• input
• output

1
${{event_properties.${rewards_redeemed} | divided_by: 100.00 | money }}

1
$1.45

Filtres de chaînes de caractères

Les filtres de chaînes de caractères sont utilisés pour manipuler les sorties et les variables de chaînes de caractères. Les chaînes de caractères sont une combinaison de caractères alphanumériques et doivent être entourées de guillemets droits.

Remarque

Les guillemets droits sont différents des guillemets courbes dans Liquid. Faites attention lorsque vous copiez et collez du code Liquid depuis un éditeur de texte dans Braze, car les guillemets courbes provoqueront des erreurs dans votre code Liquid. Si vous écrivez votre code Liquid directement dans Braze, les guillemets droits seront appliqués automatiquement.

Filtres supplémentaires

Les filtres généraux suivants servent à de nombreuses fins, notamment le formatage ou la conversion de contenu.

Vous trouverez d’autres filtres pris en charge, tels que les filtres d’encodage et d’URL, sur notre page Filtres avancés.

Filtre date

Le filtre date peut être utilisé pour convertir un horodatage dans un format de date différent. Vous pouvez passer des paramètres au filtre date pour reformater l’horodatage. Pour des exemples de ces paramètres, consultez strfti.me.

Par exemple, supposons que la valeur de date_attribute soit l’horodatage 2021-06-03 17:13:41 UTC.

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%b %d'}}

1
03 June

En plus des options de formatage strftime, Braze prend également en charge la conversion d’un horodatage en temps Unix avec le filtre date %s. Par exemple, pour obtenir date_attribute en temps Unix :

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%s' }}

1
1433351621