Nachdem Sie ein Transaktionsereignis erstellt und veröffentlicht haben, müssen Sie die Aktivierung dieses Ereignisses in Ihre Website integrieren.
Näheres zur Konfiguration von Ereignissen finden Sie in diesem Abschnitt.
Sie möchten zum Beispiel, dass ein "Warenkorbabbruch" ausgelöst wird, wenn ein Kunde Ihre Website verlässt, bevor er die Produkte in seinem Warenkorb gekauft hat. Dazu muss Ihr Web-Entwickler die REST Transactional Messages-API verwenden.
Das Transaktionsereignis wird über eine POST-Anfrage mit der folgenden URL-Struktur gesendet:
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<ORGANISATION>: Ihre persönliche Organisationskennung. Siehe diesen Abschnitt.
<transactionalAPI>: die Endpunkte der Transaktionsnachrichten-API.
Der Name des API-Endpunkts für Transaktionsnachrichten hängt von der Konfiguration Ihrer Instanz ab. Er entspricht dem Wert "mc", gefolgt von Ihrer persönlichen Organisationskennung. Nehmen wir als Beispiel das Unternehmen Geometrixx mit der Organisationskennung "geometrixx". In diesem Fall sieht die POST-Anfrage wie folgt aus:
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
Beachten Sie, dass der API-Endpunkt für Transaktionsnachrichten auch während der API-Vorschau sichtbar ist.
<eventID>: der Ereignistyp, den Sie senden möchten. Diese ID wird beim Erstellen der Ereigniskonfiguration generiert (siehe diesen Abschnitt).
Die Anfrage muss eine "Inhaltstyp: application/json"-Kopfzeile beinhalten.
Sie müssen einen Zeichensatz hinzufügen, z. B. utf-8. Beachten Sie, dass dieser Wert von der verwendeten REST-Anwendung abhängt.
-X POST \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79' \
Die Ereignisdaten sind im JSON-POST-Hauptteil enthalten. Die Ereignisstruktur hängt von der entsprechenden Definition ab. Die Schaltfläche "API-Vorschau" im Bildschirm "Ressourcendefinition" bietet ein Anfragebeispiel. Siehe diesen Abschnitt.
Die folgenden optionalen Parameter können zum Ereignisinhalt hinzugefügt werden, um das Senden von mit dem Ereignis verknüpften Transaktionsnachrichten zu verwalten:
Die Werte der Parameter "Ablauf" und "Geplant" entsprechen dem ISO 8601-Format. ISO 8601 gibt die Verwendung des Großbuchstabens "T" zur Trennung von Datum und Uhrzeit an. Dies kann jedoch aus der Ein- oder Ausgabe entfernt werden, um die Lesbarkeit zu verbessern.
Die POST-Antwort gibt den Status des Transaktionsereignisses zum Zeitpunkt der Erstellung zurück. Verwenden Sie zum Abrufen des aktuellen Status (Ereignisdaten, Ereignisstatus…) den in einer GET-Anfrage von der POST-Antwort zurückgegebenen Primärschlüssel:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
Beispielanfrage
POST-Anfrage zum Senden des Ereignisses.
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/mcAdobe/EVTcartAbandonment \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79'
{
"email":"test@example.com",
"scheduled":"2017-12-01 08:00:00.768Z",
"expiration":"2017-12-31 08:00:00.768Z",
"ctx":
{
"cartAmount": "$ 125",
"lastProduct": "Leather motorbike jacket",
"firstName": "Jack"
}
}
Antwort auf die POST-Anfrage.
{
"PKey":"<PKEY>",
"ctx":
{
"cartAmount": "",
"lastProduct": "",
"firstName": ""
}
"email":"",
"scheduled":"2017-12-01 08:00:00.768Z",
"expiration":"2017-12-31 08:00:00.768Z",
"href": "mcAdobe/EVTcartAbandonment/<PKEY>",
"serverUrl":" https://myserver.com ",
"status":"pending",
"type":""
}
In der Antwort können Sie im Feld "Status" ermitteln, ob das Ereignis verarbeitet wurde oder nicht: