Comment utiliser les filtres pour personnaliser les variables

Vous apprendrez

Apprenez comment fonctionnent les filtres et comment les utiliser pour personnaliser les variables. Les filtres vous permettent de personnaliser le format et le contenu des variables (c'est-à-dire des balises de personnalisation) dans les messages que vous envoyez. Pour une liste des filtres disponibles dans l'éditeur de modèles, référez-vous au glossaire des filtres variables de Klaviyo. 

Avant de commencer

Avant de commencer, familiarisez-vous avec le fonctionnement de la personnalisation des messages dans Klaviyo. Pour utiliser les filtres, vous devez être en mesure d'identifier les variables de base correctes et de les ajouter à votre modèle. 

Fonctionnement des filtres

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

• Appliquez des majuscules cohérentes à un texte (par exemple, vous pouvez utiliser le filtre supérieur pour prendre n'importe quelle variable et la mettre en majuscules).
• Affichez le prix d'un article après l'application d'une promotion à l'aide du filtre multiplicateur. 
• Définissez le nombre de décimales à afficher pour une variable numérique en utilisant le filtre floatformat.

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

Appliquer un filtre à une variable

Pour appliquer un filtre à une variable :

1. Identifiez votre étiquette de personnalisation (par exemple, {{ item.price }}).
2. Ajoutez un symbole de pipe ( | ) 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 prend des arguments (c'est-à-dire des paramètres ou des entrées supplémentaires), ajoutez deux points, suivis du ou des arguments. 

N'ajoutez pas d'espaces supplémentaires. Voici un exemple de variable à laquelle un filtre a été 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 texte, il doit être entouré de guillemets simples (c'est-à-dire ' et non '). Les guillemets ne sont pas nécessaires si l'argument est un nombre. Reportez-vous au glossaire des filtres variables de Klaviyo pour des exemples. 

Conseils pour l'utilisation des filtres

Si vous copiez des filtres et les collez dans votre modèle, veillez à les coller en texte brut pour éviter de coller la mise en forme avec le filtre lui-même. Utilisez le raccourci clavier "coller en texte brut" (Ctrl+Shift+V ou Cmd+Shift+V). 

Il est important de s'assurer que les données référencées dans vos variables sont adaptées au filtre utilisé. Certains filtres ne peuvent être appliqués qu'à des types de données textuelles, tandis que d'autres ne fonctionnent qu'avec des listes ou des nombres. Si le filtre ne fonctionne pas comme prévu, vérifiez que les données d'événement ou de profil que vous utilisez sont du bon type. 

Appliquer plusieurs filtres

Si nécessaire, vous pouvez appliquer plusieurs filtres à une seule variable. Pour ce faire, reliez chaque filtre à l'aide du symbole du tuyau ( | ) et considérez que les filtres seront généralement appliqués dans l'ordre (du premier au dernier). Voici quelques exemples de variables auxquelles plusieurs filtres ont été appliqués : 

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

Le premier filtre applique la casse au prénom du destinataire et le second 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 base de l'article par 0,8. (pour afficher le prix si un coupon de réduction de 20 % a été appliqué), et le second filtre spécifie que deux décimales doivent apparaître. 

Ressources complémentaires

• Glossaire des filtres variables
• Variables de date dans les modèles de référence
• Guide de personnalisation des messages