Objectif de cet article
Découvrez comment utiliser les variables de personnalisation, ou tags, de Klaviyo dans vos messages marketing afin d’offrir une expérience personnalisée à vos abonnés.
Les tags de personnalisation peuvent être utilisés dans les e-mails (y compris l’objet de l’e-mail), les messages SMS/MMS et les notifications push. Cet article présente certains tags disponibles, leurs structures et leurs formes, ainsi que la manière de les personnaliser. Pour savoir comment personnaliser vos messages, consultez notre article dédié.
Les tags de personnalisation étaient auparavant appelés balises de modèle et syntaxe des variables.
À propos des tags de personnalisation
Lorsque vous saisissez des tags dans un champ de texte d’un message, ils se présentent comme la phrase de gauche dans le tableau ci-dessous. Lorsque vous envoyez le message, les tags sont remplacés par des données provenant du profil du destinataire ou des détails de l’événement, et se présentent comme la phrase de droite.
|
Bonjour |
Bonjour George Washington, votre couleur préférée est le vert |
La personnalisation du profil commence généralement par person, à l’exception de quelques tags spéciaux comme first_name et last_name. Les variables d’événement, qui peuvent être utilisées dans des flux déclenchés par des indicateurs, commencent par event. Les tags sur votre organisation (comme le nom et l’adresse de votre organisation) commencent par organization.
Tous les tags de personnalisation sont sensibles à la casse et doivent correspondre exactement aux noms des propriétés auxquelles ils font référence. Veillez à ce que vos tags soient correctement orthographiés et à utiliser la même casse que celle qui apparaît sur vos profils.
Personnalisation du profil
Affichez les propriétés spéciales de Klaviyo dans vos messages en personnalisant votre profil. La liste ci-dessous couvre toutes les personnalisations de profil (par exemple, les propriétés intégrées de Klaviyo). Des tags de personnalisation de profil sont disponibles dans le menu Personnalisation de l’éditeur d’e-mails ou dans la fenêtre d’aperçu des SMS et des notifications push.
Si vous souhaitez ajouter des propriétés personnalisées à vos messages, passez directement à la section sur la personnalisation sur mesure.
|
Tag |
Propriété de profil |
|
|
|
|
|
First name |
|
|
Last name |
|
|
Recipient organization |
|
|
Address 1 |
|
|
Unique ID ($id/external ID) |
|
|
Latitude |
|
|
Longitude |
|
|
Klaviyo ID |
|
|
Full name |
|
|
Title |
|
|
Phone Number |
|
|
Address 2 |
|
|
City |
|
|
State / Region |
|
|
Country |
|
|
Zip Code |
|
|
Source |
|
|
Consent |
|
|
$consent_form_id |
|
|
$consent_form_version |
|
|
$consent_method |
|
|
Recipient timezone |
|
|
$consent_timestamp |
|
|
$phone_number_region |
|
|
Recently viewed items |
|
|
Expected date of next order |
Tags sur l’organisation
Les tags sur l’organisation vous permettent d’inclure des données sur votre entreprise ou votre organisation dans vos messages. Vous pouvez gérer ces informations en accédant à Compte > Coordonnées > Organisation. Tous les tags sur l’organisation commencent par organization. La liste des tags sur l’organisation est détaillée dans le tableau ci-dessous.
|
Tag sur l’organisation |
Description |
|
|
Nom de votre organisation |
|
|
Site web de votre organisation |
|
|
Adresse complète de votre organisation, y compris la ville, l’état/la région et le code postal |
|
|
Adresse postale de votre organisation |
|
|
Deuxième partie de l’adresse de votre organisation (par exemple, le numéro d’appartement ou de bâtiment) |
|
|
Ville de votre organisation |
|
|
État, province ou région de votre organisation |
|
|
Code postal de votre organisation |
Tags de lien et de prévisualisation
Les tags de lien et de prévisualisation permettent aux destinataires de gérer leurs préférences d’abonnement et de visualiser votre message dans leur navigateur. En voici quelques exemples :
Ces tags ne sont pris en charge que pour les modèles d’e-mails, pas pour les SMS/MMS. Si vous cliquez sur l’un de ces liens dans un e-mail de prévisualisation, vous serez dirigé vers une page de remplissage plutôt que vers un aperçu ou une page de consentement en ligne.
Se désabonnerSe désabonner
Klaviyo Email exige un lien de désabonnement dans tous les e-mails. Utilisez un simple tag de désabonnement pour un lien intitulé « Se désabonner », ou ajoutez votre propre texte entre les guillemets.
|
Tag |
Résultat |
|
|
Se désabonner |
|
Si vous ne souhaitez plus recevoir d’e-mails, |
Si vous ne souhaitez plus recevoir d’e-mails, cliquez ici. |
Vous pouvez également utiliser le tag {% unsubscribe_link %} pour générer une URL de désabonnement. Plutôt que de générer un mot ou une phrase lié complet, ce tag crée uniquement l’URL de désabonnement. Utilisez ce tag si vous souhaitez utiliser pour votre lien de désabonnement une couleur différente de celle définie dans les styles de votre modèle, ou si vous souhaitez utiliser un bouton ou une image plutôt qu’un lien textuel.
|
Tag |
Résultat |
|
|
Ceci est un lien de désabonnement sophistiqué. |
Lorsqu’un destinataire clique sur le lien de désabonnement, il est dirigé vers une page de confirmation personnalisable.
Gérer les préférencesGérer les préférences
Les pages de préférences permettent aux destinataires de mettre à jour leurs préférences, ce qui vous permet de segmenter et de cibler plus efficacement vos messages. Pour inclure un lien vers cette page pour chaque destinataire, utilisez le tag de gestion des préférences.
Vous pouvez créer des pages de gestion des préférences générales ou propres à une liste. Les pages propres à une liste sont utilisées lorsque vous envoyez un message à une seule liste. La page générale de gestion des préférences est utilisée lorsque vous envoyez un message à un segment, à une combinaison de listes et dans les flux qui ne sont pas déclenchés par une liste. En savoir plus sur les pages de gestion des préférences.
Utilisez un simple tag de gestion des préférences pour un lien intitulé « Gérer les préférences », ou ajoutez votre propre texte entre les guillemets.
|
Tag |
Résultat |
|
|
Gérer les préférences |
|
Vous souhaitez mettre à jour vos préférences ? |
Vous souhaitez mettre à jour vos préférences ? Cliquez ici. |
Vous pouvez également utiliser le tag {% manage_preferences_link %} pour générer une URL de gestion des préférences. Plutôt que de générer un mot ou une phrase lié complet, ce tag crée uniquement l’URL de la page de préférences du destinataire. Utilisez ce tag si vous souhaitez utiliser pour votre lien une couleur différente de celle définie dans les styles de votre modèle, ou si vous souhaitez utiliser un bouton ou une image plutôt qu’un lien textuel.
|
Tag |
Résultat |
|
|
Ceci est un lien de gestion des préférences sophistiqué. |
Affichage web
Pour donner aux destinataires la possibilité de visualiser un e-mail dans leur navigateur web, vous pouvez utiliser le tag d’affichage web.
|
Tag |
Résultat |
|
|
Voir dans votre navigateur |
|
Cet e-mail ne s’affiche pas correctement ? |
Cet e-mail ne s’affiche pas correctement ? Ouvrez-le dans votre navigateur. |
|
| Ceci est un lien d’affichage web sophistiqué. |
Aperçu du texte
Dans certains cas, vous pouvez souhaiter afficher votre texte de prévisualisation dans le corps de votre modèle. Vous pouvez faire référence à tout texte d’aperçu que vous avez défini dans l’écran d’aperçu/de configuration de l’e-mail en utilisant le tag {% render_variable preview_text %}.
Si vous mettez à jour le texte de l’aperçu dans l’écran d’aperçu de l’e-mail, ce tag montre votre texte d’aperçu mis à jour.
Personnalisation sur mesure et tags d’événementsPersonnalisation sur mesure et tags d’événements
Les tags personnalisés font référence aux propriétés de profil personnalisées (c’est-à-dire toutes les données que vous collectez sur vos contacts autres que les propriétés et événements spéciaux de Klaviyo), comme la date d’anniversaire d’une personne ou ses préférences en matière de contact. Les tags d’événement font référence aux données d’un événement spécifique (par exemple, un événement de commande passée) et ne peuvent être utilisés que dans les flux déclenchés par cet événement.
Pour ajouter un tag personnalisé, cliquez sur Personnalisation dans le champ de texte d’un e-mail et localisez le tag. Pour ajouter un tag d’événement, prévisualisez votre message et copiez le tag de variable d’événement à partir des données de prévisualisation. Vous pouvez également utiliser les formats décrits ci-dessous pour ajouter manuellement des tags personnalisés à vos modèles.
|
Format du tag |
Description |
Exemple |
|
|
Un simple tag de personnalisation de profil |
|
|
|
Un tag de personnalisation de profil, si le nom de la propriété contient des espaces ou des caractères spéciaux |
|
|
|
Un simple tag de variable d’événement |
|
|
|
Un tag de variable d’événement, si le nom de la variable contient des espaces ou des caractères spéciaux |
|
|
|
Un tag de variable d’événement, si la variable d’événement est imbriquée dans les données de l’événement |
|
|
|
Un tag de variable d’événement, si la variable d’événement est imbriquée dans une autre variable dont le nom contient un espace ou un caractère spécial |
|
Utilisez la notation par points (.) pour les tags sans espace ni caractère spécial. Si les noms de vos propriétés contiennent des espaces ou des caractères spéciaux (par exemple, $), utilisez la notation « lookup ».
Veuillez noter que, dans le cas de propriétés imbriquées, si le nom d’une propriété utilise la notation « lookup », toutes les propriétés suivantes doivent également utiliser la notation « lookup ». Cela signifie que event|lookup:'Collection
Names'|lookup:'0' est correct, mais que event|lookup:'Collection Names'.0 ne l’est pas.
Personnaliser les tags avec des filtres
Pour personnaliser l’apparence de vos tags, appliquez des filtres de modèles. Les filtres peuvent être utilisés pour appliquer une casse aux titres, définir le nombre de décimales d’un nombre, et bien d’autres choses encore. Les deux filtres les plus courants sont le filtre par défaut et le filtre de titre.
Le filtre par défaut définit une valeur par défaut qui apparaît si le destinataire d’un message n’a pas défini cette propriété. Dans l’exemple ci-dessous, « friend » et « tasty treats » sont définis comme valeurs par défaut au cas où le nom ou le plat préféré d’un destinataire n’est pas défini dans son profil Klaviyo.
|
Texte avec tags de personnalisation |
Résultat |
|
Hey |
Hey friend, any interest in some tasty treats? |
Le filtre de titre vous permet d’appliquer une casse de titre à n’importe quel tag de texte, afin qu’il apparaisse de manière cohérente une fois le message envoyé. Par exemple, certains abonnés peuvent utiliser des lettres majuscules ou minuscules lorsqu’ils remplissent votre formulaire d’inscription. Sans filtre, leur prénom conserve la casse utilisée lors de la saisie. Cependant, le filtre de titre corrige la casse pour que leur nom apparaisse correctement.
|
Texte avec tags de personnalisation |
Résultat |
|
Bonjour |
Bonjour Élise, avez-vous vu notre nouveauté ? |
Des dizaines d’autres filtres sont disponibles pour vos messages. En savoir plus sur l’utilisation des filtres pour personnaliser les tags.
Tags de dateTags de date
Les tags de date vous permettent d’insérer rapidement une date dans un e-mail. La date correspond au fuseau horaire de votre compte et reflète le jour ou l’heure d’envoi d’un message.
Le tag {{ today }} est l’un des tags de date les plus courants. Il affiche un horodatage au moment de l’envoi du message. Pour l’utiliser, insérez la ligne de code suivante dans votre modèle :
{% today "%Y-%m-%d" as today %} {{ today }}
Veuillez noter que l’utilisation du tag {{ today }} sans le code qui le précède est sans effet. Vous devez donc utiliser la ligne de code complète.
Pour savoir comment utiliser ou personnaliser les tags de date, consultez notre article sur les tags de date dans les modèles.
Tags de deviseTags de devise
Les données d’événements tels que Commande Passée, Ajouté au Panier, etc., sont souvent associées à une valeur monétaire (par exemple, le prix d’un produit ou la valeur du panier d’un client). Utilisez le tag {% currency_format … %} pour appliquer le format de la devise de votre pays à cette valeur.
Prenons l’exemple du champ « $value » dans l’indicateur Commande Débutée ci-dessous :
Si vous utilisez uniquement la variable {{ event|lookup:"$value" }}, cette propriété s’affichera avec une seule décimale et sans symbole de devise dans l’e-mail :
Cependant, avec le tag de format de devise ({% currency_format event|lookup:"$value" %}), le nombre s’affiche avec un symbole de devise et le bon nombre de décimales :
Pour utiliser un tag de format de devise, remplacez le texte de remplissage (« placeholder ») dans {% currency_format PLACEHOLDER %} par votre variable.
Par exemple, si votre variable est {{ event.item.price }}, le tag de format de devise complet sera {% currency_format event.item.price %}. Si votre tag comprend des filtres (par exemple, une valeur par défaut au cas où la propriété serait vide), incluez-les également dedans : {% currency_format event.item.price|default:”0” %}.
Sélectionner un pays
Vous pouvez définir le format de devise de vos messages à deux endroits :
-
Pour l’ensemble de votre compte
Accédez à Paramètres > Organisation > Langue de l’organisation et format régional et sélectionnez la Langue de l’organisation. -
Pour un message spécifique
Sélectionnez un format de devise différent pour un seul message dans l’onglet Styles du modèle, dans la section Devise.
Résoudre les problèmes liés au tag currency_format
Ce tag n’est pris en charge que pour les variables qui sont des nombres (par exemple, 10 ou 24,56). Les propriétés comportant un symbole de devise (par exemple, 40 € ou 76,30 €) sont des chaînes, et le tag de format de devise ne peut donc pas les modifier.
ConditionsConditions
Les tags conditionnels vous permettent d’inclure du contenu dans vos messages pour les destinataires qui répondent à certains critères, et de ne pas l’inclure pour les autres. Ils vous permettent de personnaliser efficacement vos messages pour chaque destinataire.
Instructions IfInstructions If
Les instructions If vous permettent de contrôler le contenu qu’une personne reçoit en fonction des données de profil ou d’événement.
Dans l’exemple ci-dessous, une personne verra la première ligne de texte si elle a plus de 150 points de fidélité. Si son nombre de points est inférieur à 150, mais supérieur à 0, elle verra la deuxième ligne. Enfin, si elle n’a pas de points de fidélité, elle verra le troisième message.
{% if person|lookup:'Loyalty Points' > 150 %}
En tant que membre de notre programme VIP, vous bénéficiez toujours de la livraison et des retours gratuits.
{% elif person|lookup:'Loyalty Points' > 0 %}
Vous avez {{ person|lookup:'Loyalty Points' }} points. Accumulez-en 150 pour devenir VIP !
{% else %}
Avez-vous entendu parler de notre programme VIP ? Inscrivez-vous dès aujourd’hui sur notre site web pour commencer à gagner des récompenses.
{% endif %}
Dans une instruction If, une condition initiale {% if … %} est requise, ainsi que le tag de fermeture {% endif %}. Tous les autres éléments (c’est-à-dire les tags {% elif %} et {% else
%}) sont facultatifs. Vous pouvez utiliser un nombre illimité de tags {% elif %}, suivis au maximum d’un tag {% else %}. Chaque destinataire d’un e-mail ne verra que le premier message pour lequel il est qualifié.
Instructions For
Les blocs « For » vous permettent d’itérer sur chaque élément d’une variable qui stocke une liste et de les rendre individuellement. Vous trouverez ci-dessous un exemple d’instruction :
|
|
Couverture de plage grand format × 1 Chaises de plage × 4 Crème solaire SPF × 2 Glacière en plastique × 1 |
Chaque instruction For doit contenir les éléments suivants :
- Un tag
{% for … %}d’ouverture, contenant un alias de ligne (item dans l’exemple ci-dessus) et une collection de lignes (event.shopping_cart_items dans l’exemple ci-dessus). - Un tag
{% endfor %}de fermeture.
Entre les deux tags obligatoires, vous pouvez inclure tout le texte que vous souhaitez. Pour inclure des variables imbriquées dans la collection de lignes, remplacez le début du nom de la variable (la collection de lignes plus le nombre qui suit la collection de lignes) par votre alias de ligne. Par exemple, la variable {{ event.shopping_cart_items.0.name }} devient {{ item.name }}.
Les conditions et l’éditeur de texte en ligne
Lorsque vous ajoutez certaines conditions à un bloc de texte, elles peuvent disparaître de l’éditeur de texte en ligne. Le code est toujours présent, il est simplement caché. Pour afficher et modifier les conditions, ouvrez le champ Code source du bloc de texte.
Les tags suivants ne sont visibles que dans le champ Code source du bloc de texte :
- {% for ... %}
- {% endfor %}
- {% if ... %}
- {% elif ... %}
- {% else %}
- {% endif %}
- {% with ... %}
- {% endwith %}