In diesem Artikel erfahren Sie, wie Sie eine E-Mail senden, dabei das API für das Triggern eines externen Events verwenden und einige einfache externe Daten in die E-Mail einfügen.
Es 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 Menge des Produkts
- den Preis des Produkts
API-Platzhalter haben stets die 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 dieser Kampagne sieht wie folgt aus:
{
"key_id": "3",
"external_id": "jack.example@gmail.com",
"data":{
"firstName": "Jack",
"orderNumber": "12345",
"Quantity": "3",
"Price": "45.95"
}
}
Die folgende Abbildung zeigt, wann der API Call mittels Emarsys Dev Hub getriggert wird:
Das Ergebnis der E-Mail zeigt die Daten:

Broadcast Events
Für das Senden von Triggered E-Mails an Kontakte außerhalb Ihrer Kontaktdatenbank werden Broadcast Events verwendet. Da für diese virtuellen Kontakte keine Personalisierungsdaten verfügbar sind, müssen die E-Mail-Adresse und alle Personalisierungsdaten in der Payload des API Request angegeben werden.
Sie müssen {{ event.body|raw }}
als Personalisierung in Ihre E-Mail-Kampagne einfügen, um personalisierte Daten zu erhalten. In der gesendeten E-Mail wird der Rohteil durch den Inhalt aus dem body
ersetzt, den Sie im API Call angeben.
Für Broadcast E-Mails, die an virtuelle Kontakte gesendet werden (zum Beispiel an E-Mail-Adressen, die nicht in der Kontaktdatenbank enthalten sind), erfassen wir keine Öffnungen oder Klicks, daher sind keine E-Mail-Statistiken auf der Emarsys Plattform oder Open Data verfügbar.
Ein Beispiel für den Call und die JSON Payload, die body
enthält:
POST https://suite99.emarsys.net/api/v2/email/12345678/broadcast
{
"email": "virtual_stan@gets.it",
"data": {
"global": {
"body": "test message"
}
}
}
Die folgenden zwei Abbildungen zeigen die im Editor erstellte E-Mail und die gesendete Nachricht. Weitere Informationen erhalten Sie im Developer Hub.

