Transactieberichten beheren managing-transactional-messages

Nadat u een transactiegebeurtenis hebt gemaakt en gepubliceerd, moet u het activeren van deze gebeurtenis integreren in uw website.

U wilt bijvoorbeeld dat de gebeurtenis ‘Afkappen met winkelwagentje’ wordt geactiveerd wanneer een van uw klanten uw website verlaat voordat ze de producten in hun winkelwagentje kopen. Om dit te doen, als Webontwikkelaar, moet u de REST Transactionele Berichten API gebruiken.

Een transactiegebeurtenis verzenden sending-a-transactional-event

De transactiegebeurtenis wordt verzonden via een POST-aanvraag met de volgende URL-structuur:

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

Koptekst POST-verzoek

Het verzoek moet een “Content-Type: application/json”.

U moet een charset, bijvoorbeeld utf-8 toevoegen. Deze waarde is afhankelijk van de REST-toepassing die u gebruikt.

-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-aanvraaginstantie

De gebeurtenisgegevens bevinden zich in de JSON POST-hoofdtekst. De gebeurtenisstructuur is afhankelijk van de definitie ervan.

De volgende optionele parameters kunnen aan de inhoud van de gebeurtenis worden toegevoegd om het verzenden van aan de gebeurtenis gekoppelde transactieberichten te beheren:

Parameters communicatiekanaal

Afhankelijk van het te gebruiken kanaal, zou de lading de hieronder parameters moeten bevatten:

Als de payload alleen “mobilePhone” bevat, wordt het SMS-communicatiekanaal geactiveerd. Als de payload alleen “email” bevat, wordt het communicatiekanaal voor de e-mail geactiveerd.

In het onderstaande voorbeeld ziet u een payload waarbij een SMS-communicatie wordt geactiveerd:

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

Als de payload zowel “email” als “mobilePhone” bevat, is de standaardcommunicatiemethode e-mail. Als u een SMS wilt verzenden wanneer beide velden aanwezig zijn, moet u dit expliciet opgeven in de payload met de parameter “wishedChannel”.

Antwoord op de POST-aanvraag

De POST-reactie retourneert de status van de transactionele gebeurtenis op het moment dat deze werd gemaakt. Om zijn huidige status (gebeurtenisgegevens, gebeurtenisstatus…) terug te winnen, gebruik de Primaire Sleutel door het POST antwoord in een GET verzoek wordt teruggegeven:

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

verzoek van de Steekproef

POST-verzoek om de gebeurtenis te verzenden.

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

Antwoord op het POST-verzoek.

{
  "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 van een transactiegebeurtenis transactional-event-status

In het antwoord kunt u met het veld status weten of de gebeurtenis is verwerkt: