Skip to content

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 |.

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.

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 même 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 : 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 l’étiquette assign pour remplacer l’attribut personnalisé de current_rewards_balance par 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. Utilisez le filtre plus pour combiner le solde de la carte cadeau de chaque utilisateur avec son solde de récompenses, indiqué par l’objet {{balance}}.

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).

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

Si vous saisissez un attribut personnalisé (comme account_balance), vous devez toujours utiliser le filtre money pour placer les décimales au bon endroit et éviter que des zéros ne tombent à la fin des nombres :

1

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

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

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 :

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 fonctions, y compris 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.

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 :

1

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

1

1433351621

Filtre fuseau horaire

En plus des filtres que vous trouverez dans la documentation de Shopify, Braze prend également en charge le filtre time_zone.

Le filtre time_zone prend une heure, un fuseau horaire et un format de date et restitue l’heure dans ce fuseau horaire dans le format de date spécifié. Par exemple, supposons que la valeur de {{custom_attribute.$date_attribute}}} est 2021-08-04 9:00:00 UTC :

1

{{custom_attribute.${date_attribute} | time_zone: 'America/Los_Angeles' | date: '%a %b %e %T' }}

1

Wed August 4 2:00:00

Vous pouvez également utiliser la variable réservée now pour accéder à la date et à l’heure actuelles pour les manipuler.

1

{{ 'now' | date: '%Y-%m-%d %H:%M:%S' }}

1

2021-08-04 18:13:13
Github   Modifier cette page sur GitHub
CETTE PAGE A-T-ELLE ÉTÉ UTILE?
New Stuff!