Verwalten von Transaktionsnachrichten

Über den Versand von Transaktionsnachrichten

Nach der Erstellung des gewünschten Ereignisses muss die Auslösung dieses Ereignisses in Ihre Webseite integriert werden.

Hinweis

Informationen zum Erstellen und Publizieren von Ereignissen finden Sie in der Campaign-Dokumentation.

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.

  1. Der Entwickler sendet anhand der POST-Methode eine Anfrage, die das Senden des Transaktionsereignisses auslöst.
  2. Die Antwort auf die POST-Anfrage enthält einen Primärschlüssel, mit dem der Entwickler eine oder mehrere Anfragen über eine GET-Anfrage senden kann. So kann er den Ereignisstatus abrufen.

Senden eines Transaktionsereignisses

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 Ereignisdefinition generiert. Weiterführende Informationen finden Sie in der Campaign-Dokumentation.

POST-Anfrage-Kopfzeile

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' \

POST-Anfrage-Hauptteil

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. Weiterführende Informationen finden Sie in der Campaign-Dokumentation.

Die folgenden optionalen Parameter können zum Ereignisinhalt hinzugefügt werden, um das Senden von mit dem Ereignis verknüpften Transaktionsnachrichten zu verwalten:

  • Ablauf (optional): Nach diesem Datum wird das Senden des Transaktionsereignisses abgebrochen.
  • Geplant (optional): Ab diesem Datum wird das Transaktionsereignis verarbeitet und die Transaktionsnachricht gesendet.
Hinweis

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.

Antwort auf die POST-Anfrage

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":""
}

Status des Transaktionsereignisses

In der Antwort können Sie im Feld "Status" ermitteln, ob das Ereignis verarbeitet wurde oder nicht:

  • Ausstehend: Das Ereignis steht aus – das Ereignis erhält diesen Status, wenn es gerade ausgelöst wurde.
  • Verarbeitung: Das Ereignis muss noch versandt werden – es wird in eine Nachricht umgewandelt und die Nachricht wird gesendet.
  • Angehalten: Der Ereignisvorgang wurde angehalten. Das Ereignis wird nicht mehr verarbeitet, sondern in einer Warteschlange in der Adobe Campaign-Datenbank aufbewahrt. Weiterführende Informationen finden Sie in der Campaign-Dokumentation.
  • Verarbeitet: Das Ereignis wurde verarbeitet und die Nachricht wurde erfolgreich gesendet.
  • Ignoriert: Das Ereignis wurde vom Versand ignoriert, normalerweise dann, wenn eine Adresse unter Quarantäne steht.
  • Versand fehlgeschlagen: Bei der Verarbeitung des Ereignisses ist ein Versandfehler aufgetreten.
  • Routing fehlgeschlagen: Die Routing-Phase ist fehlgeschlagen. Dies kann beispielsweise geschehen, wenn der angegebene Ereignistyp nicht gefunden werden kann.
  • Zu alt: Das Ereignis ist abgelaufen, bevor es verarbeitet werden konnte. Das kann verschiedene Gründe haben, z. B. wenn ein Senden mehrmals fehlschlägt (was dazu führt, dass das Ereignis nicht mehr aktuell ist) oder der Server Ereignisse nach einer Überlastung nicht mehr verarbeiten kann.
  • Targeting fehlgeschlagen: Campaign Standard konnte einen Link, der für das Nachrichten-Targeting verwendet wird, nicht anreichern.

Auf dieser Seite