Ajout de contenu dynamique à l'aide de Handlebars dans Marketing Campaigns

Marketing Campaigns vous permet d'insérer des balises de substitution dans le contenu de votre e-mail ou dans les lignes d'objet. Les balises que vous insérez renseignent dynamiquement les données de champ personnalisé pour ce champ par destinataire.

Vous pouvez aller au-delà du simple remplacement de champ personnalisé, en utilisant le contenu dynamique et Handlebars pour atteindre vos objectifs.

Pour savoir comment ajouter des balises à vos conceptions Marketing Campaigns, consultez notre Documentation de l'éditeur. La documentation de l'éditeur explique également comment prévisualiser votre message avec des données d'échantillon.

Cette page fournit plusieurs exemples d'utilisation pour vous montrer comment modifier le contenu dynamique de vos conceptions à l'aide de Handlebars. Pour obtenir la liste complète de toutes les applications d'assistance disponibles, consultez Utilisation de Handlebars. Tout d'abord, nous allons expliquer comment gérer les valeurs par défaut lors de l'utilisation de Handlebars dans Marketing Campaigns.

Comprendre les valeurs par défaut et Handlebars

Lorsque vous copiez une balise de l'onglet Tags (Balises) dans les éditeurs Marketing Campaigns, le collage de la balise dans votre conception ajoute automatiquement une valeur par défaut. La balise ressemblera à l'exemple suivant : le nom de la balise suivi d'une barre verticale et le mot "default.". Vous pouvez considérer la barre verticale comme le mot "or.". Cela signifie que la balise sera le first_name du destinataire ou le mot "default.".

{{ first_name | default }}

La valeur par défaut est destinée à fournir une valeur de secours pour la balise si elle ne peut pas être remplie avec des données réelles. Par exemple, si vous remplacez le mot « par défaut » par « Cher client », votre message sera envoyé au first_name du destinataire ou à la phrase « Cher client » lorsque les données pour first_name ne sont pas disponibles. Cela est généralement préférable à une balise défectueuse, qui n'affichera aucun texte.

{{first_name | Valued Customer}}

Modifications de syntaxe pour les balises enregistrées

Les valeurs par défaut sont compatibles uniquement avec le mot-clé insert. Lorsque vous enregistrez votre conception, la syntaxe de la balise change pour devenir automatiquement compatible avec le mot-clé insert. Si vous voyez le changement de syntaxe, ne vous inquiétez pas.

balise collée

{{first_name | Valued Customer}}

balise enregistrée

{{insert first_name 'default=Valued Customer'}}

Valeurs par défaut sans le mot clé INSERT

Le mot-clé insert et les valeurs par défaut ne peuvent pas être ajoutés à une balise lors de l'utilisation d'un autre Handlebars pour obtenir une fonctionnalité plus complexe. Par exemple, vous ne pouvez pas formater une date avec FormatDate et fournir une valeur de secours ou une valeur par défaut pour cette date formatée dans une seule balise. L'exemple suivant se cassera.

Exemple cassé

{{insert formatDate due_date "MM/DD/YYYY" 'default=30 days after signup'}}

Comme les balises copiées de l'onglet Tags (Balises) sont automatiquement collées avec un espace réservé par défaut, vous devez supprimer la partie | default de la balise lorsque vous utilisez d'autres Handlebars. Si votre application d'assistance ne fonctionne pas comme prévu, assurez-vous que la balise n'a pas été enregistrée avec insert et 'default=default' à l'intérieur.

Pour obtenir un comportement de secours lors de l'utilisation d'autres applications d'assistance, vous pouvez utiliser des déclarations conditionnelles. Par exemple, pour créer un retour arrière pour FormatDate, vous pouvez encapsuler la balise dans les balises {{#if}} {{else}} comme indiqué dans l'exemple suivant.

exemple concret

{{#if due_date}}
{{formatDate due_date "MM/DD/YYYY"}}
{{else}}
30 jours après l'inscription
{{/if}}

Pour plus d'informations sur les déclarations conditionnelles, consultez notre page Utilisation de Handlebars.

Utiliser l'assistant FormatDate

Twilio SendGrid stocke les dates au format de date ISO 8601. Ce format de date standard nous permet de gérer correctement les dates et les heures. Cependant, le format de date ISO 8601 n'est pas ce que les destinataires attendent généralement dans le texte d'un e-mail. Pour cette raison, nous fournissons Handlebars FormatDate pour convertir les dates de la norme ISO 8601 à un format de date plus convivial tel que JJ/MM/AAAA.

Dans Marketing Campaigns, vous pouvez utiliser cette application d'assistance pour modifier la façon dont une balise de date s'affiche dans votre ligne d'objet ou dans votre contenu d'e-mail. Pour le contexte, les options de balise que vous voyez dans l'éditeur Marketing Campaigns sont automatiquement créées en fonction de vos champs personnalisés.

L'exemple suivant suppose que vous avez une balise de date personnalisée appelée offer_expiration. Vous souhaitez utiliser cette balise de date pour afficher la fin d'une promotion, invitant les clients à prendre des mesures avant qu'ils ne passent à côté.

Dans l'éditeur Marketing Campaigns, votre copie d'e-mail ressemble à ceci (après avoir supprimé la valeur par défaut de votre champ de date) :

Joyeux anniversaire Cake or Pie {{ first_name | to you }} !

C'est difficile à croire, mais vous avez rejoint le délicieux service de livraison Cake or Pie il y a un an. Nous apprécions les clients fidèles comme vous, c'est pourquoi nous vous envoyons une offre d'anniversaire.

Vous recevrez 15 % de remise sur toutes les commandes passées pendant votre mois anniversaire. C'est 15 % de réduction sur toutes les commandes passées avant l'{{ offer_expiration }} !

Merci d'être client,

L'équipe Cake or Pie

Telle quelle, cette copie de l'e-mail affiche l'offer_expiration au format ISO 8601 (par exemple, 2020-05-08T17:06:24Z). Pour modifier l'affichage de ce paramètre, vous allez utiliser FormatDate.

Dans Handlebars, {{ }}, ajoutez le nom de FormatDate, avant le nom de votre balise. Cela indique à Twilio SendGrid que vous souhaitez formater la date de la balise offer_expiration. Conservez un espace avant et après FormatDate.

{{ formatDate offer_expiration }}

Vous devez ensuite placer le format que vous souhaitez afficher dans votre e-mail en suivant le nom de la balise. La mise en forme doit être placée entre guillemets. Conservez un espace avant et après vos guillemets.

{{ formatDate offer_expiration "MM/DD/YYYY" }}

Pour modifier le format d'affichage d'une balise de date, vous devez toujours suivre le schéma suivant :

{{ formatDate <date tag> "<desired format>" }}.

Vérifications conditionnelles basées sur les attributs du client

Handlebars permet de modifier le contenu d'un message en fonction des attributs du client qui peuvent ne pas se prêter à un segment. Par exemple, vous pouvez vouloir livrer différents messages en fonction des codes postaux ou des langues parlées par les clients.

Vérification conditionnelle avec « equals » (égal)

Dans cet exemple, vous verrez comment modifier de façon conditionnelle un message en fonction de la proximité d'un destinataire par rapport à l'emplacement d'un magasin, ce qui vous permettra de diffuser les ventes les plus pertinentes pour ce client.

Pour ce faire, vous pouvez gérer un champ personnalisé appelé nearest_zip_code qui contient le magasin le plus proche de chaque client. Ce champ personnalisé est automatiquement disponible dans l'onglet Tab (Balise) des éditeurs Marketing Campaigns.

Pour modifier votre message à l'aide de cette balise, le code de votre Handlebars peut ressembler à l'exemple suivant.

{{#equals nearest_zip_code 1234}}
20 % de réduction sur tous les livres de poche !
{{else}}
Faites des économies incroyables !
{{/equals}}

Cet exemple utilise equals pour vérifier la valeur de nearest_zip_code pour chaque destinataire. Si le code postal le plus proche du destinataire est 1234, le message « 20 % de réduction sur tous les livres de poche » s'affiche. S'ils sont n'importe où else, ils verront le message « Faites des économies incroyables ! »

Ce type d'instruction conditionnelle peut être utile, mais vous voudrez probablement rechercher plus d'un code postal. Dans ce cas, il est également possible d'ajouter plusieurs vérifications « equals » (égal) enchaînées à des vérifications « else » (autre). À la fin de votre bloc Handlebars, assurez-vous d'ajouter la balise « equals » (égal) de fermeture, {{/equals}}, pour chaque balise « equals » d'ouverture, {{#equals}}. Pour vérifier la présence de trois codes postaux, votre Handlebars peut ressembler à l'exemple suivant.

{{#equals nearest_zip_code 12345}}
20 % de réduction sur tous les livres de poche !
{{else}}{{#equals nearest_zip_code 23456}}
10 % de réduction sur toutes les œuvres de fiction historique
{{else}}{{#equals nearest_zip_code 34567}}
Faites des économies incroyables !
{{/equals}}{{/equals}}{{/equals}}

Remarquez les trois balises {{/equals}} de fermeture, une pour chaque vérification {{#equals}}.

Vous pouvez utiliser une approche similaire pour vérifier la langue préférée de vos clients et fournir du texte dans cette langue. L'utilisation de « equals » (égal) permet de stocker un seul champ language personnalisé et de vérifier sa valeur, comme indiqué dans l'exemple suivant.

{{#equals language "english"}}
Hello, World!
{{else}}{{#equals language "español"}}
¡Hola Mundo!
{{else}}{{#equals language "français"}}
Bonjour le monde !
{{/equals}}{{/equals}}{{/equals}}

Vérification conditionnelle avec « greaterThan » (supérieur à)

Vous pouvez utiliser « greatThan » (supérieur à) pour afficher du texte en fonction des champs de vérification par rapport au nombre. Par exemple, vous pouvez stocker le nombre d'achats effectués par un client dans un champ personnalisé appelé total_purchases. Il se peut que vous ayez un autre champ où stocker l'objectif d'achat actuel de vos clients appelé purchase_goal. Si vous souhaitez transmettre un message pour récompenser ceux qui ont dépassé votre purchase_goal ou encourager l'engagement de ceux qui ne l'ont pas dépassé, votre Handlebars pourrait ressembler à l'exemple suivant.

{{#greaterThan total_purchases purchase_goal}}
Merci d'être un client fidèle. Pour vous remercier, profitez d'une remise supplémentaire de 15 % sur votre prochain achat.
{{else}}
Nous apprécions de nouveaux clients comme vous. C'est pourquoi nous offrons 10 % de remise sur votre prochain achat.
{{/greaterThan}}

Pour les destinataires dont la valeur total_purchases est supérieure à votre purchase_goal, le message « Merci d'être un client fidèle. Pour vous remercier, profitez d'une remise supplémentaire de 15 % sur votre prochain achat » s'affiche. Pour ceux dont la valeur total_purchases est égale ou inférieure à votre purchase_goal, le message « Nous apprécions de nouveaux clients comme vous. C'est pourquoi nous offrons 10 % de remise sur votre prochain achat » s'affiche.

Vous pouvez utiliser une stratégie similaire avec « lessThan » (inférieur à).

Ressources supplémentaires

• Conception et Éditeur de code
• Utilisation de Handlebars
• Conception d'e-mails multiplateforme