Una vez creado y publicado un evento transaccional, debe integrar el activador de este evento en su sitio web.
La configuración de un evento se presenta en esta sección.
Por ejemplo: desea que se active un evento de "abandono del carro de compras" cada vez que uno de sus clientes abandone el sitio web antes de comprar los productos en el carro de compras. Para ello, el desarrollador web debe utilizar la API de Mensajes transaccionales REST.
El evento transaccional se envía a través de una solicitud de POST con la siguiente estructura URL:
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<organization>:: su ID de organización personal. Consulte esta sección.
<transactionalapi>:: endPoints de la API de Mensajes transaccionales.
El nombre del extremo de la API de Mensajes transaccionales depende de la configuración de la instancia. Corresponde al valor "mc" seguido de su ID de organización personal. Veamos el ejemplo de la compañía de Geometrixx, con "geometrixx" como ID de organización. En ese caso, la solicitud del POST sería la siguiente:
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
(Tenga en cuenta que el extremo de la API de mensajes transaccionales también está visible durante la previsualización de la API)
<eventid>:: el tipo de evento que desea enviar. Este ID se genera al crear la configuración de evento (consulte esta sección).
La solicitud debe contener un "Content-Type: application/json".
Debe agregar un charset, por ejemplo utf-8. Tenga en cuenta que este valor depende de la aplicación REST que utilice.
-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' \
Los datos de evento están contenidos dentro del cuerpo del POST JSON. La estructura del evento depende de su definición. El botón previsualización de API de la pantalla de definición de recursos proporciona un ejemplo de solicitud. Consulte esta sección.
Se pueden añadir los siguientes parámetros opcionales al contenido de evento para gestionar el envío de mensajes transaccionales vinculados al evento:
Los valores de los parámetros "expiration" y "schedule" siguen el formato ISO 8601. ISO 8601 especifica el uso de la letra mayúscula "T" para separar la fecha y la hora. Sin embargo, se puede eliminar de la entrada o salida para mejorar la legibilidad.
La respuesta del POST devuelve el estado del evento de transacción en el momento en que se creó. Para recuperar su estado actual (datos de evento, estado de evento…), utilice la clave principal devuelta por la respuesta del POST en una solicitud de GET:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
Solicitud de muestra
Solicitud del POST para enviar el evento.
-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"
}
}
Respuesta a la solicitud del 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":""
}
En la respuesta, el campo "estado" permite saber si el evento se ha procesado o no: