Cet article explique comment envoyer un email en utilisant l'API pour déclencher un événement extérieur et en remplissant l'email de certaines données externes simples.
Le HTML suivant sera utilisé :
<html> <head> <title>API Exercise 3 Example</title> </head> <body> <h2> Exercise 3 - Placeholders </h2> <p> Dear {{event.firstName}} ,<br> Please find your order details below: </p> <ul> <li>Ordernumber: {{event.orderNumber}}</li> <li>Product: {{event.productName}}</li> <li>Quantity: {{event.Quantity}}</li> <li>Price: {{event.Price}}</li> </ul> </body> </html>Dans cet exemple, il y a cinq caractères de remplissage différents :
- Prénom
- Un numéro de commande
- Le nom du produit
- La quantité de produit
- Prix du produit
Les caractères de remplissage d'API ont toujours la syntaxe suivante : {{event.placeholdername}}
Il doit contenir le préfixe event., sinon cela ne marchera pas !
Utilisez le nom du caractère de remplissage (par ex. firstName) dans votre JSON payload (données utiles JSON). Le JSON de cette campagne ressemblera à cela :
{ "key_id": "3", "external_id": "jack.example@gmail.com", "data":{ "firstName": "Jack", "orderNumber": "12345", "Quantity": "3", "Price": "45.95" } }L'image suivante s'affiche quand l'appel API est déclenché via Emarsys Dev Hub :
Le résultat de l'email affichera les données :
Événements de diffusion
Les événements de diffusion sont utilisés quand vous avez besoin d'envoyer des emails déclenchés à des contacts qui ne sont pas dans votre base de données de contact. Puisqu'aucune donnée de personnalisation n'est disponible pour ces contacts virtuels, l'adresse email et toutes les données de personnalisation doivent êtres fournies dans la charge utile de la requête.
Le JSON de cette campagne ressemblera à cela :
{ "email": "virtual@contact.com", "data": { "global": { "orderId": "123456789", "orderDate": "2019-08-07", "subject": "Test payload" } } }Pour plus d'informations, voir me Hub du développeur.