Dieser Artikel beschreibt, wie Sie eine E-Mail senden, indem Sie mit dem API ein externes Event triggern, und dabei einige einfache externe Daten in die E-Mail einfügen.
Dafür wird folgendes HTML verwendet:
<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>In diesem Beispiel gibt es fünf verschiedene Platzhalter:
- Einen Vornamen
- Eine Bestellnummer
- Den Namen des Produkts
- Die Anzahl der Produkteinheiten
- Den Preis des Produkts
API-Platzhalter haben immer folgende Syntax: {{event.placeholdername}}
Das Präfix event. muss enthalten sein, sonst funktioniert es nicht!
Verwenden Sie den Namen des Platzhalters (z.B. firstName) in Ihrer JSON Payload. Das JSON der Kampagne wird wie folgt aussehen:
{ "key_id": "3", "external_id": "jack.example@gmail.com", "data":{ "firstName": "Jack", "orderNumber": "12345", "Quantity": "3", "Price": "45.95" } }Die folgende Abbildung zeigt, wie der API Call mithilfe des Emarsys Dev Hub getriggert wird:
Das Ergebnis der E-Mail wird in den Daten angezeigt:
Broadcast Events
Broadcast Events sollten dann verwendet werden, wenn Sie getriggerte E-Mails an Kontakte senden, die sich nicht in Ihrer Kontaktdatenbank befinden. Da für diese virtuellen Kontakte keine Personalisierungsdaten verfügbar sind, müssen die E-Mail-Adresse und sämtliche Personalisierungsdaten in der Payload des Requests enthalten sein.
Das JSON der Kampagne wird wie folgt aussehen:
{ "email": "virtual@contact.com", "data": { "global": { "orderId": "123456789", "orderDate": "2019-08-07", "subject": "Test payload" } } }Weitere Informationen erhalten Sie im Developer Hub.