Filtres

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

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

Syntaxe du filtre

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ère, et upcase est le filtre appliqué.

Syntaxe pour les filtres multiples

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

• input
• output

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

1
SALE

Filtres de tableau

Les filtres de tableau servent à modifier leur sortie.

Filtres de couleur

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

Filtres de polices

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 seule sortie, ils seront appliqués de gauche à droite.

Opérations mathématiques avec attributs personnalisés

N’oubliez pas 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 parce que vous ne pouvez pas référencer plusieurs attributs personnalisés dans une ligne de Liquid. Au lieu de cela, vous devez attribuer une variable à au moins une de ces valeurs avant de réaliser les fonctions mathématiques. L’ajout de deux attributs personnalisés nécessite deux lignes de Liquid :

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

Cas d’utilisation : Veuillez calculer le solde actuel.

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

1. Veuillez utiliser l’étiquetteassign pour remplacer l’attribut personnalisé decurrent_rewards_balancepar le terme « balance ». Cela signifie que vous avez maintenant une variable intitulée balance que vous pouvez manipuler.

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

2. Veuillez utiliser leplusfiltre pour associer le solde de la carte cadeau de chaque utilisateur à son solde de récompenses, représenté par {{balance}}l’objet.

• 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 mettez à jour un utilisateur sur son achat, un solde de compte ou tout ce qui concerne une somme d’argent, vous devez utiliser des filtres monétaires. Les filtres monétaires permettent de garantir que vos décimales sont à l’endroit approprié et qu’aucun élément de votre mise à jour n’est perdu (comme ce problème 0 à la fin).

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

Comparaison du filtre monétaire Shopify avec celui de Braze.

Si vous saisissez un attribut personnalisé (tel que account_balance), il est recommandé de toujours utiliser lemoneyfiltre afin de placer les décimales au bon endroit et d’éviter que les zéros ne disparaissent à la fin des nombres :

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

AVEC LE FILTRE MONÉTAIRE	SANS LE FILTRE MONÉTAIRE
Où account_balance est une saisie à 17.8.	Où account_balance est une saisie à 17.8.

Lemoneyfiltre de Braze diffère de celui de Shopify, car il n’applique pas automatiquement les décimales selon un paramètre prédéfini. Prenons par exemple le scénario suivant : rewards_redeemed contient une valeur de 145 :

• input
• output

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

1
$145.00

Selon le filtre money de Shopify, cela devrait générer $1.45, cependant dans Braze, cela va générer $145.00. En tant que solution de contournement, nous pouvons utiliser le filtre divided_by pour manipuler le nombre en une décimale, avant d’appliquer le filtre monétaire :

• input
• output

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

1
$1.45

Filtres de chaîne de caractère

Les filtres de chaîne de caractère sont utilisés pour manipuler les sorties et les variables des 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.

Filtres supplémentaires

Les filtres généraux suivants ont de nombreuses utilités, notamment le formatage ou la conversion de contenu.

Vous pouvez trouver plus de 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 servir à convertir un horodatage en un format de date différent. Vous pouvez transmettre des paramètres au filtre date pour reformater l’horodatage. Pour obtenir des exemples de ces paramètres, consultez strfti.me.

Par exemple, supposons que la valeur de date_attribute est 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 de date %s. Par exemple, pour obtenir date_attribute en temps Unix :

• input
• output

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

1
1433351621