[BEGRÄNSAD TILLGÄNGLIGHET]{class="badge informative" title="Begränsat till migrerade Campaign Standard-användare"}

Hantera transaktionsmeddelanden managing-transactional-messages

När du har skapat och publicerat en transaktionshändelse måste du integrera den som utlöser den här händelsen på webbplatsen.

Du vill t.ex. att en händelse om att kunden överger en varukorg ska utlösas så fort någon av dina kunder lämnar webbplatsen innan de köper produkterna i kundvagnen. För att kunna göra detta måste du som webbutvecklare använda API:t REST Transactional Messages.

Skicka en transaktionshändelse sending-a-transactional-event

Transactional-händelsen skickas via en POST-begäran med följande URL-struktur:

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

POST-begärandehuvud

Begäran måste innehålla rubriken"Content-Type: application/json".

Du måste lägga till en teckenuppsättning, till exempel utf-8. Observera att det här värdet beror på vilket REST-program du använder.

-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-begärandeinnehåll

Händelsedata finns inuti JSON POST-brödtexten. Händelsestrukturen beror på dess definition.

Följande valfria parametrar kan läggas till i händelseinnehållet för att hantera sändning av transaktionsmeddelanden som är länkade till händelsen:

Kommunikationskanalparametrar

Beroende på vilken kanal som ska användas ska nyttolasten innehålla parametrarna nedan:

Om nyttolasten bara innehåller "mobilePhone" aktiveras SMS-kommunikationskanalen. Om nyttolasten bara innehåller e-post aktiveras e-postkommunikationskanalen.

I exemplet nedan visas en nyttolast där en SMS-kommunikation kommer att utlösas:

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

Om nyttolasten innehåller både"email" och"mobilePhone" används e-post som standardkommunikationsmetod. Om du vill skicka ett SMS när båda fälten finns tillgängliga måste du uttryckligen ange det i nyttolasten med hjälp av parametern önskad kanal.

Svar på POST-begäran

POST-svaret returnerar transaktionshändelsens status när det skapades. Om du vill hämta den aktuella statusen (händelsedata, händelsestatus…) använder du den primärnyckel som returneras av POST-svaret i en GET-begäran:

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

Exempelbegäran

POST-begäran om att skicka händelsen.

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

Svar på POST-begäran.

{
  "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 för transaktionshändelse transactional-event-status

I svaret kan du i statusfältet se om händelsen har bearbetats eller inte: