Comment utiliser des filtres pour personnaliser les variables

Objectif de cet article

Découvrez comment fonctionnent les filtres et comment les utiliser pour personnaliser des variables. Les filtres vous permettent de personnaliser le format et le contenu des variables (par exemple, les balises de modèle) dans vos messages. Pour obtenir une liste des filtres disponibles à utiliser dans l’éditeur de modèles, consultez le glossaire des filtres pour les variables de Klaviyo.

Avant de commencer

Avant de commencer, familiarisez-vous avec le fonctionnement de la personnalisation dans Klaviyo. Pour utiliser les filtres, vous devez pouvoir identifier les variables de base correctes et les ajouter à votre modèle.

Comment les filtres fonctionnent

Des filtres sont appliqués aux balises de modèle pour ajuster les résultats obtenus. Voici les cas d’utilisation possibles :

• Appliquez une capitalisation cohérente à un extrait de texte (par exemple, vous pouvez utiliser le filtre upper pour prendre n’importe quelle variable et la mettre entièrement en majuscules).
• Affichez le prix d’un article après l’application d’une promotion en utilisant le filtre multiply.
• Définissez le nombre de décimales à afficher pour une variable numérique à l’aide du filtre floatformat.

Pour obtenir une liste des filtres pris en charge, consultez notre glossaire des filtres pour les variables.

Appliquer un filtre à une variable

Pour appliquer un filtre à une variable :

1. Identifiez votre tag de personnalisation (p. ex., {{ item.price }}).
2. Ajoutez un symbole de barre verticale ( | ) après le nom de la variable.
3. Ajoutez un nom de filtre, comme floatformat, pour spécifier le nombre de décimales à afficher.
4. Si le filtre accepte des arguments (c’est-à-dire des paramètres ou des entrées supplémentaires), ajoutez un deux-points, suivi du ou des arguments.

N’ajoutez pas d’espaces supplémentaires. Voici un exemple de variable avec un filtre appliqué :

{{ item.price|floatformat:2 }}

Dans cet exemple, item.price est le nom de la variable, floatformat est le filtre et 2 est l’argument requis par le filtre.

Si l’argument est un morceau de texte, il doit être entouré de guillemets simples droits (c’est-à-dire ', et non ‘). Les guillemets ne sont pas nécessaires si l’argument est un nombre. Consultez le glossaire des filtres de variables de Klaviyo pour obtenir des exemples.

Conseils pour utiliser les filtres

Si vous copiez des filtres et que vous les collez dans votre modèle, veillez à les coller en tant que texte brut afin d’éviter de coller la mise en forme en même temps que le filtre lui-même. Utilisez le raccourci clavier de collage en tant que texte brut (Ctrl+Maj+V ou Cmd+Maj+V).

Il est important de s’assurer que les données référencées dans vos variables conviennent au filtre utilisé. Certains filtres ne peuvent être appliqués qu’aux types de données de texte, tandis que d’autres ne fonctionnent que sur des listes ou des nombres. Si le filtre ne fonctionne pas comme prévu, vérifiez les données d’événement ou de profil que vous utilisez pour vous assurer qu’il s’agit du type correct.

Application de plusieurs filtres

Si nécessaire, vous pouvez appliquer plusieurs filtres à une seule variable. Pour ce faire, connectez chaque filtre à l’aide d’un symbole de barre verticale (|), et gardez à l’esprit que les filtres seront généralement appliqués dans l’ordre (du premier au dernier). Voici quelques exemples de variables avec plusieurs filtres appliqués :

{{ first_name|title|default:'there' }}

Le premier filtre met une majuscule à la première lettre du prénom du destinataire, et le deuxième filtre fournit un mot par défaut à utiliser si aucun prénom n’a été fourni.

{{ item.price|multiply:.8|floatformat:2 }}

Le premier filtre multiplie le prix de l’article de base par 0,8 (pour afficher le prix si un code de réduction de 20 % a été appliqué), et le second filtre précise que deux décimales doivent apparaître.

Ressources supplémentaires