Utilisez le langage de template de Brevo pour personnaliser vos messages avec des données spécifiques aux contacts ou aux événements, masquer ou afficher du contenu pour des destinataires spécifiques et ajuster la mise en forme des valeurs dans vos messages.

💬 Variables

Les variables, également appelées placeholders ou balises de fusion, sont des balises que vous pouvez insérer dans vos messages pour les personnaliser. Lorsque vous envoyez un message, chaque variable est automatiquement remplacée par les informations du contact correspondantes.

Dans le langage de template de Brevo, les variables doivent être entourées d’accolades doubles, comme {{ ... }} ou {{...}}. Elles peuvent être utilisées pour des insertions simples ou combinés à des expressions conditionnelles et des filtres pour une personnalisation avancée.

Le langage de template de Brevo prend en charge différents types de variables :

👤 Variables de contact

Les variables de contact vous permettent d’afficher les données des attributs du contact, comme le prénom d’un contact, dans vos messages. Ces variables sont mises en forme de cette manière : {{ contact.ATTRIBUTE }}, où vous devez remplacer ATTRIBUTE par le nom exact de votre attribut du contact tel qu’il apparaît sur la page Attributs du contact dans votre compte Brevo. Vous pouvez utiliser à la fois les attributs Brevo par défaut et les attributs personnalisés.

Voici quelques exemples de variables de contact avec trois attributs Brevo par défaut et un attribut personnalisé :

➡️ Pour en savoir plus sur les différents types d’attributs du contact disponibles et la manière d'en créer des personnalisés, consultez nos articles dédiés :

• À propos des attributs de contact
• Créer et gérer des attributs de contact

🔗 Variables de lien email et d’aperçu

Les variables de lien email et d’aperçu permettent aux destinataires de consulter votre email dans leur navigateur, de se désabonner de vos communications et de gérer leurs préférences. Ces variables doivent être placées à l’intérieur d’une balise HTML <a>, entourant le texte qui sera affiché dans l’email.

Les variables de lien email et d’aperçu suivantes sont disponibles :

➡️ Pour en savoir plus, consultez nos articles dédiés :

• Insérer un lien « Afficher dans le navigateur » dans vos campagnes
• Insérer un lien de désinscription dans vos campagnes
• Mettre à jour les informations et préférences de vos contacts (formulaire de mise à jour du profil)
• Créer un template email de confirmation en double opt-in (DOI) personnalisé pour vos formulaires d'inscription Brevo

📅 Variables de date

Les variables de date vous permettent d’insérer un horodatage de la date et de l’heure exactes de l’envoi d’un email. La date est basée sur le fuseau horaire de votre compte Brevo. Si aucun fuseau horaire n’est défini dans votre compte, la variable utilisera par défaut l’horodatage actuel en UTC. 

La variable de date suivante est disponible :

➡️ Pour en savoir plus sur l’ajustement de la mise en forme des dates, consultez notre article dédié Modifiez le formatage de vos placeholders avec des filtres.

⚡ Variables d'événement

Les variables d’événement vous permettent d’afficher les données d’événements spécifiques déclenchés par les actions d’un contact, comme le prix du dernier article qu'il a acheté ou le nom du rendez-vous qu’il a réservé.

Pour identifier les variables d’événement de votre message, consultez votre appel API ou vos logs d’événements dans Brevo. Voici un exemple de structure JSON classique, où :

data est l'objet racine qui contient les propriétés suivantes : id → L'ID du panier total → Le montant total du panier currency → Le type de devise url → Un lien vers le panier items est un tableau de produits du panier, chacun contenant les propriétés suivantes : name → Le nom du produit price → Le prix du produit url → L'URL de la page du produit image → L'URL de l'image du produit

Les variables d'événement sont mises en forme à l’aide de doubles accolades. Chaque donnée de la structure JSON peut être incluse dans une variable d'événement afin de personnaliser vos messages :

{% for item in params.items %}
{{ item.name }}
{% endfor %}

🛢️ Variables de flux de données

Les variables de flux de données vous permettent de personnaliser vos communications marketing envoyées via Brevo avec les dernières informations sur les produits, les clients, les événements, ou toute autre donnée pertinente provenant de votre source de données externe ou de votre API. Utilisez-les pour automatiser et personnaliser vos messages avec des données en temps réel. 

Pour identifier les variables de flux de données de votre message, cliquez sur la liste déroulante du compte et sélectionnez Paramètres > Gestion des données > Flux de données pour vérifier la structure de votre fichier source sur Brevo :

Les variables de flux de données sont mises en forme à l’aide de doubles accolades. En fonction de la complexité de la structure de votre flux de données, le format de vos variables de flux de données varie : 

{% for item in feed.yoga_classes.following_classes %}
{{ item.class_name }}
{% endfor %}

🛒 Variables de flux produit

Les variables de flux produit vous permettent d’afficher une liste dynamique des produits de votre boutique en ligne, facilitant ainsi la création de recommandations personnalisées. Elle contient des détails sur le produit tels que son nom, sa description, ses prix, ses images et sa disponibilité. Utilisez-la pour présenter des articles populaires, personnaliser les recommandations ou maintenir des affichages de produits cohérents dans vos campagnes marketing.

Les variables de flux produit sont mises en forme à l’aide de doubles accolades :

{{ feed.feedalias.products.variable }}

Vous devez alors remplacer :

• feedalias est le nom exact de votre flux produit, correspondant à l’orthographe et à la casse tels qu’ils apparaissent sur la page flux produit.
• variable est le nom du champ dans l’API qui contient les données que vous souhaitez récupérer.

Entrée	Description	Sortie
{{feed.mats_bestseller.products.imageUrl}}	Image du produit
{{feed.mats_bestseller.products.name}}	Nom du produit	Tapis de yoga antidérapant, 6 mm
{{feed.mats_bestseller.products.url}}	Lien vers le produit	https://thegreenyoga.com/non-slip/black-mat.html

Afficher tous les éléments à l'aide d'une boucle for

Utilisez une boucle for pour afficher dynamiquement tous les éléments d'un tableau. Au lieu de faire manuellement référence à chaque index, la boucle parcourt le tableau et affiche chaque élément automatiquement. Cela est particulièrement utile lorsque le nombre d’éléments du tableau est inconnu, comme une liste d’articles de blog hebdomadaires ou un reçu pour les produits achetés.

Par exemple, si nous voulons afficher le nom de chaque élément dans le flux produit mats_bestseller, la boucle for correspondante serait :

{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}

➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.

📢 Expressions conditionnelles

👀 Affichage conditionnel (instructions if)

Utilisez une instruction if pour afficher ou masquer des parties de votre email en fonction des données de chaque destinataire. Cela vous permet d’envoyer un seul email qui s’adapte dynamiquement à différents contacts, en fonction de conditions spécifiques.

➡️ Pour en savoir plus sur l’instruction if, consultez notre article dédié [Mode d'emploi] Afficher ou masquer le contenu de vos emails avec des instructions if.

🔁 Sections répétables (boucles for)

Utilisez une boucle for pour afficher dynamiquement tous les éléments d'un tableau. Au lieu de faire manuellement référence à chaque index, la boucle parcourt le tableau et affiche chaque élément automatiquement. Cela est particulièrement utile lorsque le nombre d’éléments du tableau est inconnu, comme une liste d’articles de blog hebdomadaires ou un reçu pour les produits achetés.

➡️ Pour en savoir plus sur les boucles for, consultez notre article dédié [Mode d’emploi] Répéter un bloc d’éléments dans vos emails à l’aide des boucles for.

🪄 Filtres

Les filtres modifient la sortie d’une variable en transformant sa valeur. Ils sont placés entre les doubles accolades de la variable et séparés par une barre verticale |, par exemple {{ contact.FIRSTNAME|upper }}. Vous pouvez également enchaîner plusieurs filtres, chaque filtre appliquant sa transformation au résultat du précédent.

Voici quelques exemples de variables utilisées avec des filtres pour modifier leur sortie :

➡️ Pour en savoir plus, consultez notre article dédié Modifiez le formatage de vos placeholders avec des filtres.

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.