Personnalisation

Le contenu et l’objet acceptent des variables entre doubles accolades, et un petit langage de conditions et de boucles. Aucun code n’est exécuté : le moteur ne comprend que ce qui est décrit ici. Le bouton Variables de chaque éditeur liste celles qui sont disponibles ; un clic copie la variable.

Variables

Dans les campagnes et les automatisations

Variable	Valeur
`{{ subscriber.first_name }}`	Prénom
`{{ subscriber.last_name }}`	Nom
`{{ subscriber.email }}`	Adresse e-mail
`{{ subscriber.attributes.ville }}`	Un attribut personnalisé (remplacez `ville`)
`{{ list.name }}`	Nom de la liste
`{{ unsubscribe_url }}`	Lien de désabonnement
`{{ preferences_url }}`	Lien vers la page de préférences
`{{ organisation.address }}`	Adresse postale de l’organisation (Paramètres → Général)
`{{ webview_url }}`	Lien vers la version web
`{{ campaign.name }}`, `{{ campaign.subject }}`	Campagnes : nom et objet
`{{ mail.name }}`, `{{ mail.subject }}`	E-mails d’automatisation : nom et objet

Dans les e-mails de confirmation et de bienvenue

Les mêmes variables d’abonné et de liste, plus {{ confirm_url }}, le lien de confirmation.

Dans les e-mails transactionnels

Les variables sont celles que votre application envoie. Avec :

{ "customer": { "name": "Ada" }, "order": { "number": "A-1024", "paid": true } }

vous écrivez {{ customer.name }} et {{ order.number }}. Voir E-mails transactionnels par l’API.

Une variable inconnue ou vide est remplacée par une chaîne vide. Les valeurs sont échappées dans le HTML : un prénom qui contient <script> s’affiche tel quel, sans s’exécuter.

Conditions

Le langage est Liquid, celui de Shopify et de beaucoup d’autres : ce que vous en connaissez fonctionne ici.

{% if subscriber.first_name %}
  Bonjour {{ subscriber.first_name }},
{% else %}
  Bonjour,
{% endif %}

Forme	Vrai quand
`{% if name %}`	la valeur est renseignée (non vide)
`{% if name == "valeur" %}`, `!=`	égal, différent — les majuscules comptent
`{% if orders > 3 %}`, `<`, `>=`, `<=`	les nombres se comparent comme des nombres
`{% if name contains "valeur" %}`	le texte, ou la liste, le contient
`{% if a and b %}`, `{% if a or b %}`	les deux, l’un ou l’autre
`{% elsif … %}`	un autre cas, avant `{% else %}`
`{% unless name %}`	le contraire de `if`
`{% case plan %}{% when "pro" %}…{% endcase %}`	un cas parmi plusieurs

{% if subscriber.attributes.plan == "pro" %}
  Merci d'être client Pro : la livraison est offerte.
{% elsif subscriber.attributes.orders > 0 %}
  Content de vous revoir.
{% else %}
  Votre première commande est livrée gratuitement.
{% endif %}

Un champ de contact se lit par sa clé, sous attributes : {{ subscriber.attributes.plan }}. Un champ de type nombre se compare comme un nombre, une date s’écrit avec date.

Filtres

Un filtre transforme une valeur au moment de l’écrire. Ils s’enchaînent, de gauche à droite.

Bonjour {{ subscriber.first_name | default: "à vous" | capitalize }},
votre commande de {{ event.value | money: event.currency }} est partie le {{ event.shipped_at | date: "%d/%m/%Y" }}.

Filtre	Donne
`default: "à vous"`	la valeur, ou les mots donnés quand elle est vide
`capitalize`, `upcase`, `downcase`	les majuscules
`truncate: 60`	soixante caractères au plus
`date: "%d/%m/%Y"`	une date, dans la forme demandée
`plus`, `minus`, `times`, `round`	de l’arithmétique
`size`, `first`, `last`, `join: ", "`	à propos d’une liste
`money: "XAF"`	un montant gardé dans la plus petite unité, écrit comme la langue du lecteur écrit l’argent : `1250` donne `12,50 €` en français, `€12.50` en anglais

Un filtre qui n’existe pas empêche le rendu de l’e-mail, et l’aperçu dit lequel : mieux vaut un e-mail non envoyé qu’un e-mail envoyé cassé. Une variable qui n’existe pas est simplement vide.

Boucles

<ul>
{% for item in event.items %}
  <li>{{ item.name }} × {{ item.quantity }}{% if item.price %} — {{ item.price }}{% endif %}</li>
{% endfor %}
</ul>

Une boucle parcourt une liste de valeurs simples (["Pain au levain", "Brioche"]) ou une liste d’objets ([{"name": "Pain", "quantity": 2}]), dont les champs se lisent avec un point. forloop.first, forloop.last et forloop.index disent où en est la boucle ; {% for item in items limit: 3 %} s’arrête avant la fin.

Ce qu’apporte un événement

Dans une automatisation démarrée par quelque chose que la personne a fait, les e-mails lisent cet événement : {{ event.name }}, {{ event.value }}, {{ event.currency }}, et chaque propriété envoyée avec lui, directement sous event — {{ event.url }}, {{ event.total }}, {% for item in event.items %}. Voir Événements.

Deux variables obligatoires

Une campagne ne part pas sans :

{{ unsubscribe_url }} : un lien de désabonnement visible ;
{{ organisation.address }} (ou l’adresse écrite en toutes lettres) : l’adresse postale de l’expéditeur.

Ce sont des obligations légales pour tout e-mail commercial. Le plus simple est de les placer dans votre modèle.

Bien démarrer

Contacts

Contenu

Campagnes

Automatisations

E-mails transactionnels

Délivrabilité

Compte et équipe

Aide

Personnalisation

Variables

Dans les campagnes et les automatisations

Dans les e-mails de confirmation et de bienvenue

Dans les e-mails transactionnels

Conditions

Filtres

Boucles

Ce qu’apporte un événement

Deux variables obligatoires

​Variables

​Dans les campagnes et les automatisations

​Dans les e-mails de confirmation et de bienvenue

​Dans les e-mails transactionnels

​Conditions

​Filtres

​Boucles

​Ce qu’apporte un événement

​Deux variables obligatoires

Variables

Dans les campagnes et les automatisations

Dans les e-mails de confirmation et de bienvenue

Dans les e-mails transactionnels

Conditions

Filtres

Boucles

Ce qu’apporte un événement

Deux variables obligatoires