[EINGESCHRÄNKTE VERFÜGBARKEIT]{class="badge informative" title="Auf Campaign Standard migrierte Benutzende beschränkt"}

Verwalten von Transaktionsnachrichten managing-transactional-messages

Nachdem Sie ein Transaktionsereignis erstellt und veröffentlicht haben, müssen Sie die Aktivierung dieses Ereignisses in Ihre Website integrieren.

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.

Senden eines Transaktionsereignisses sending-a-transactional-event

Das Transaktionsereignis wird über eine POST-Anfrage mit der folgenden URL-Struktur gesendet:

POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>

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 ihrer Definition ab.

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

Parameter des Kommunikationskanals

Je nach zu verwendendem Kanal sollte die Payload die folgenden Parameter enthalten:

Wenn die Payload nur „Mobiltelefon“ enthält, wird der SMS-Kommunikationskanal ausgelöst. Wenn die Payload nur „E-Mail“ enthält, wird der E-Mail-Kommunikationskanal ausgelöst.

Das folgende Beispiel zeigt eine Payload, bei der eine SMS-Kommunikation ausgelöst wird:

curl --location 'https://mc.adobe.io/<ORGANIZATION>/campaign/mcAdobe/EVTcartAbandonment' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Cache-Control: no-cache' \
--header 'X-Api-Key: <API_KEY>' \
--header 'Content-Type: application/json;charset=utf-8' \
--header 'Content-Length: 79' \
--data '
{
  "mobilePhone":"+9999999999",
  "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"
  }
}'

Wenn die Payload sowohl „E-Mail“ als auch „Mobiltelefon“ enthält, ist die standardmäßige Kommunikationsmethode E-Mail. Um eine SMS zu senden, wenn beide Felder vorhanden sind, müssen Sie sie explizit in der Payload mit dem Parameter „wishChannel“ angeben.

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'

{
  "


  ":"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 transactional-event-status

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