Gestion des messages transactionnels
Une fois que vous avez créé et publié un événement transactionnel, vous devez intégrer le déclenchement de cet événement dans votre site Web.
NOTEPar exemple, vous souhaitez qu’un événement de type « Abandon de panier » soit déclenché lorsque l’un de vos clients quitte votre site Web avant d’avoir acheté les produits de son panier. Pour ce faire, le développeur Web de votre site doit se servir de l’API REST des messages transactionnels.
- Il exécute une requête selon la méthode POST, qui déclenche l’envoi de l’événement transactionnel.
- La réponse à la requête POST contient une clé primaire, qui permet au développeur d’exécuter une ou plusieurs requêtes par le biais d’une requête GET. Vous pouvez ensuite obtenir le statut de l’événement.
Envoi d’un événement transactionnel
L’événement transactionnel est envoyé via une requête POST avec la structure d’URL suivante :
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
-
<ORGANIZATION> : votre ORGANIZATION ID personnel. Consultez cette section.
-
<transactionalAPI> : les points d’entrée (endPoints) de l’API des messages transactionnels.
Le nom du point d’entrée de l’API des messages transactionnels dépend de la configuration de votre instance. Il correspond à la valeur "mc" suivie de votre identifiant d’organisation personnel. Prenons l’exemple de la société Geometrixx, dont l’identifiant d’organisation est "geometrixx". Dans ce cas, la requête POST serait la suivante :
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>Notez que le point d’entrée de l’API des messages transactionnels est également visible pendant l’aperçu de l’API.
-
<eventID> : type d’événement à envoyer. Cet identifiant est généré lors de la création de la configuration de l’événement (voir cette section).
En-tête de requête POST
La requête doit contenir un en-tête "Content-Type: application/json".
Vous devez ajouter un jeu de caractères, par exemple utf-8. Cette valeur dépend de l’application REST utilisée.
-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' \
Corps de requête POST
Les données d’événement sont contenues dans le corps JSON POST. La structure de l’événement dépend de sa définition. Le bouton d’aperçu de l’API dans l’écran de définition des ressources donne un exemple de requête. Consultez cette section.
Il est possible d’ajouter les paramètres facultatifs suivants au contenu de l’événement pour gérer l’envoi de messages transactionnels liés à cet événement :
- expiration (facultatif) : après cette date, l’envoi de l’événement transactionnel sera annulé.
- scheduled (facultatif) : à partir de cette date, l’événement transactionnel sera traité et le message transactionnel sera envoyé.
NOTERéponse à la requête POST
La réponse POST renvoie l’état de l’événement transactionnel au moment de sa création. Pour récupérer son état actuel (données de l’événement, statut de l’événement…), utilisez la clé primaire renvoyée par la réponse POST dans une requête GET :
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
Exemple de requête
Requête POST pour envoyer l’événement.
-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"
}
}
Réponse à la requête POST.
{
"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":""
}