Transactionele berichten 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.
- Verzend een verzoek volgens de methode van de POST, die het verzenden van de transactiegebeurtenis.
- Het antwoord op het verzoek van de POST bevat een Primaire Sleutel, die u toestaat om één of veelvoudige verzoeken door een verzoek van de GET te verzenden. U kunt dan de status van gebeurtenis.
Een transactiegebeurtenis verzenden sending-a-transactional-event
De transactionele gebeurtenis wordt verzonden door een verzoek van de POST met de volgende structuur URL:
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
-
<organization>: uw persoonlijke ORGANISATIE-ID. Zie deze sectie.
-
<transactionalapi>: de Transactional Berichten API endPoints.
De naam van het Transactionele eindpunt van Berichten API hangt van uw instantieconfiguratie af. Deze komt overeen met de waarde "mc" gevolgd door uw persoonlijke organisatie-id. Laten we het voorbeeld van het Geometrixx-bedrijf nemen, met 'geometrixx' als organisatie-id. In dat geval zou het verzoek om POST als volgt zijn:
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>Het eindpunt van de API voor transactionele berichten is ook zichtbaar tijdens de API-voorvertoning.
-
<eventid>: het type gebeurtenis dat u wilt verzenden. Deze id wordt gegenereerd wanneer de gebeurtenisconfiguratie wordt gemaakt (zie deze sectie).
POST request header
Het verzoek moet een header "Content-Type: application/json" bevatten.
U moet bijvoorbeeld een tekenset toevoegen utf-8. 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 hoofdtekst van de JSON-POST. De gebeurtenisstructuur is afhankelijk van de definitie ervan. De API voorproefknoop in het scherm van de middeldefinitie verstrekt een verzoeksteekproef. Zie deze sectie.
De volgende optionele parameters kunnen aan de inhoud van de gebeurtenis worden toegevoegd om het verzenden van aan de gebeurtenis gekoppelde transactieberichten te beheren:
- vervaldatum (optioneel): na deze datum wordt het verzenden van de transactiegebeurtenis geannuleerd.
- gepland (optioneel): vanaf deze datum wordt de transactie-gebeurtenis verwerkt en wordt het transactiebericht verzonden.
Antwoord op de POST
De reactie van de POST keert de status van de transactionele gebeurtenis op het tijdstip terug het werd gecreeerd. Om zijn huidige status (gebeurtenisgegevens, gebeurtenisstatus…) terug te winnen, gebruik de Primaire Sleutel door de reactie van de POST in een verzoek van de GET wordt teruggekeerd:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
Voorbeeldverzoek
POST vraagt 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'
{
"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"
}
}
Antwoord op de 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:
- hangend: de gebeurtenis is in behandeling - de gebeurtenis neemt deze status over wanneer deze zojuist is geactiveerd.
- verwerking: de gebeurtenis is in afwachting van levering - deze wordt omgezet in een bericht en het bericht wordt verzonden.
- onderbroken: het gebeurtenisproces wordt gepauzeerd. Het wordt niet meer verwerkt, maar in een rij in het gegevensbestand van Adobe Campaign bewaard. Raadpleeg deze sectie voor meer informatie.
- verwerkt: de gebeurtenis is verwerkt en het bericht is verzonden.
- genegeerd: de gebeurtenis werd genegeerd door de levering, typisch wanneer een adres in quarantaine is.
- deliveryFailed: er is een leveringsfout opgetreden tijdens de verwerking van de gebeurtenis.
- routingFailed: de verpletterende mislukte fase - dit kan bijvoorbeeld voorkomen wanneer het gespecificeerde type van gebeurtenis niet kan worden gevonden.
- tooOld: de gebeurtenis is verlopen voordat deze kon worden verwerkt - dit kan om verschillende redenen gebeuren, bijvoorbeeld wanneer een verzend meerdere keren mislukt (dit leidt ertoe dat de gebeurtenis niet meer up-to-date is) of wanneer de server gebeurtenissen na het overladen niet meer kan verwerken.
- targetingFailed: Campaign Standard kon geen verbinding verrijken die voor bericht het richten wordt gebruikt.