Référence
Balises de fusion
Personnalisez l’objet et le contenu de vos campagnes avec des balises de fusion pour les noms, l’adresse e-mail, les champs personnalisés, le lien de désinscription et le lien de gestion des abonnements, avec les valeurs de repli et les conditions de Temple.
Les balises de fusion insèrent les données propres à chaque destinataire dans une campagne : son nom dans l’objet, un champ personnalisé dans le corps, et ses liens personnels de désinscription et de gestion des abonnements. Les campagnes en effectuent le rendu avec Temple, le langage de templates d’Emailit : vous pouvez donc aussi ajouter des valeurs de repli et des blocs conditionnels. Cette page liste toutes les balises, les règles de syntaxe et la façon de prévisualiser le résultat.
Balises disponibles
| Balise | Remplacée par |
|---|---|
{{first_name}} |
Le prénom du contact. |
{{last_name}} |
Le nom de famille du contact. |
{{email}} |
L’adresse e-mail du contact. |
{{unsubscribe_url}} |
Le lien de désinscription personnel du destinataire. Voir Désinscriptions. |
{{manage_subscriptions_url}} |
Le lien du destinataire vers la page de gestion des abonnements, où il choisit ses listes. Vide dans les envois de test. |
{{cf.<key>}} |
La valeur d’un champ personnalisé, d’après sa clé. Par exemple, {{cf.company}} pour un champ de clé company. |
{{global.<key>}} |
Une valeur globale de l’espace de travail, comme {{global.offer_url}}. Identique pour tous les destinataires. |
{{tags}} |
Les tags du contact, comme vip, customer. {{#if tags}}…{{/if}} vérifie que le contact en a au moins un. |
{{score}} |
Le score de lead du contact. |
{{webview_url}} |
Un lien vers la version web de l’e-mail, rendue pour ce destinataire. |
Avec Commerce, une alpha réservée à l’équipe Emailit, les campagnes disposent aussi de balises pour les produits, les codes de réduction, le panier et les données d’achat. Consultez Produits, coupons et panier.
Les champs personnalisés fonctionnent aussi sous la forme {{custom_fields.<key>}}, celle qu’utilisent les automatisations, et chaque balise est également disponible sous contact, par exemple {{contact.first_name}}.
Les balises de fusion fonctionnent dans le Subject de la campagne, le contenu HTML et la version en texte brut. Elles ne sont pas remplacées dans From name, From email ni Reply to.
<p>Hi {{first_name}},</p>
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
<p><a href="{{unsubscribe_url}}">Unsubscribe</a> from Acme emails sent to {{email}}.</p>Insérer des balises dans les éditeurs
- Rich-text editor : tapez
@et choisissez une variable, ou un champ personnalisé par son nom. - Dragit editor : utilisez le menu des champs de fusion, qui liste First name, Last name, Email et vos champs personnalisés. Les liens de désinscription et de gestion des abonnements se trouvent parmi les liens spéciaux.
- HTML editor et champ Subject : tapez la balise.
Règles de syntaxe
- Les espaces autour d’un nom de balise sont ignorés :
{{ first_name }}fonctionne donc comme{{first_name}}. Les blocs conditionnels sont plus stricts : écrivez{{else}}et{{/if}}exactement comme indiqué, et commencez une condition par{{#if, sans espace après les accolades. - Les noms de balises ne sont pas sensibles à la casse :
{{First_Name}}fonctionne donc aussi. Cela concerne les six balises du tableau et le préfixecf.. Les clés des champs personnalisés doivent correspondre exactement à la clé enregistrée, et les clés sont toujours en minuscules : écrivez donc{{cf.company}}, et non{{cf.Company}}. Les chemins souscontactetcustom_fieldssont sensibles à la casse. - Les champs personnalisés nécessitent un préfixe. Écrivez
{{cf.company}}:{{company}}n’est pas une balise de fusion, son rendu est donc vide. - Tout autre texte entre doubles accolades est supprimé. Temple considère chaque
{{…}}comme une variable, et une variable sans valeur donne un rendu vide. Il n’existe pas de syntaxe d’échappement : pour afficher des doubles accolades littérales en HTML, écrivez-les sous la forme{{.
Valeurs manquantes
Quand un contact n’a pas de valeur pour une balise, celle-ci est remplacée par une chaîne vide. Ajoutez une valeur de repli après une barre verticale pour l’utiliser à la place. Un champ vide est considéré comme manquant : il reçoit donc aussi la valeur de repli.
| Contenu | Contact avec un prénom | Contact sans prénom |
|---|---|---|
Hi {{first_name}}, |
Hi Ada, | Hi , |
Hi {{first_name|"there"}}, |
Hi Ada, | Hi there, |
Les guillemets doubles, les guillemets simples ou l’absence de guillemets fonctionnent tous autour de la valeur de repli. Dans la liste des contacts, filtrez par First name avec is empty pour trouver les contacts sans prénom.
Contenu conditionnel
Affichez un bloc uniquement aux contacts qui ont une valeur, avec un {{else}} facultatif pour tous les autres :
{{#if cf.plan}}
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
{{else}}
<p>Upgrade to get scheduled sending.</p>
{{/if}}Une condition est fausse quand le champ est manquant ou vide, false ou 0, et vraie dans tous les autres cas. Il n’existe pas de comparaison comme cf.plan == "Pro" : pour cibler une valeur précise, enregistrez-la dans son propre champ, par exemple un booléen is_pro. Les blocs peuvent être imbriqués. Consultez Conditions pour l’ensemble des règles.
Rendu des valeurs
| Type de champ | Rendu |
|---|---|
| Texte, nombre | La valeur enregistrée, par exemple Acme ou 42. |
| Date | YYYY-MM-DD, par exemple 1990-04-12. |
| Booléen | true ou false. |
| Liste déroulante | L’option sélectionnée. |
| Choix multiple | Les options séparées par des virgules, sans espaces, par exemple news,offers. |
Les valeurs sont insérées exactement telles qu’enregistrées, sans échappement HTML. Si des personnes peuvent saisir leur propre nom, par exemple via un formulaire d’inscription public, vérifiez ces valeurs avant de les utiliser dans du HTML.
Prévisualiser les balises de fusion
- Preview as contact, à l’étape Preview and test, effectue le rendu de l’objet et du contenu avec les données d’un contact réel. Utilisez-le pour vérifier les noms, les champs personnalisés et les valeurs vides.
- Les envois de test à une adresse qui appartient à un contact de cet espace de travail utilisent les données de ce contact. Pour les autres adresses,
{{email}}est rempli avec l’adresse de test et les noms et les champs personnalisés restent vides : les valeurs de repli et les blocs{{else}}s’affichent donc. Le lien de désinscription d’un test ne désinscrit personne.
Consultez Tester et programmer.
Balises de fusion et Temple
Les balises de fusion des campagnes sont des variables Temple remplies à partir du contact destinataire. Les modèles envoyés via l’API e-mail et les e-mails envoyés par les automatisations utilisent aussi Temple, avec des données différentes :
| Campagnes | Envois par l’API | E-mails d’automatisation | |
|---|---|---|---|
| Données | Le contact destinataire | Les variables que vous transmettez |
Le contact, les données de l’événement et les métadonnées de l’exécution |
| Champs personnalisés | {{cf.<key>}} ou {{custom_fields.<key>}} |
Ce que vous transmettez, par exemple un objet cf |
{{cf.<key>}} ou {{custom_fields.<key>}} |
| Liens de désinscription et de gestion des abonnements | {{unsubscribe_url}}, {{manage_subscriptions_url}} |
Non fourni | {{unsubscribe_url}}, {{manage_subscriptions_url}} dans les automatisations Contact |
| Casse des noms de balises | Indifférente, pour les six balises ci-dessus | Exacte | Exacte |
Ainsi, un modèle qui utilise {{cf.<key>}}, des valeurs de repli et des conditions donne le même rendu dans une campagne et dans une automatisation de contact. Si vous enregistrez une campagne comme modèle et l’envoyez avec l’API, Temple remplit ses balises à partir des variables que vous transmettez. Transmettez first_name pour {{first_name}}, un objet cf pour {{cf.company}} et votre propre unsubscribe_url si le contenu pointe vers un tel lien.