Depois de criar e publicar um evento transacional, é necessário integrar o acionamento desse evento ao seu site.
A configuração de um evento é apresentada em esta seção.
Por exemplo, você deseja que um evento de "abandono do carrinho" seja acionado sempre que um de seus clientes sair do site antes de comprar os produtos no carrinho. Para isso, seu desenvolvedor da Web deve usar a REST Mensagen transacional API.
O evento transacional é enviado por meio de uma solicitação de POST com a seguinte estrutura de URL:
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<organization>: sua ID pessoal da ORGANIZAÇÃO. Consulte esta seção.
<transactionalapi>: os pontos finais da API de Mensagens transacionais.
O nome do terminal da API de Mensagens transacionais depende da configuração da sua instância. Corresponde ao valor "mc" seguido pela ID pessoal da organização. Vejamos o exemplo da empresa de Geometrixx, com "geometrixx" como sua ID de empresa. Nesse caso, o pedido de POST seria o seguinte:
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
(Observe que o ponto de extremidade da API de mensagens transacionais também está visível durante a pré-visualização da API)
<eventid>: o tipo de evento que você deseja enviar. Essa ID é gerada ao criar a configuração do evento (consulte esta seção).
A solicitação deve conter um "Tipo de conteúdo: application/json".
Você deve adicionar um charset, por exemplo utf-8. Observe que esse valor depende do aplicativo REST que você está usando.
-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' \
Os dados do evento estão contidos no corpo do POST JSON. A estrutura do evento depende de sua definição. O botão pré-visualização da API na tela de definição de recurso fornece uma amostra de solicitação. Consulte esta seção.
Os seguintes parâmetros opcionais podem ser adicionados ao conteúdo do evento para gerenciar o envio de mensagens transacionais vinculados ao evento:
Os valores dos parâmetros "expiração" e "agendada" seguem o formato ISO 8601. A norma ISO 8601 especifica a utilização da letra maiúscula "T" para separar a data e a hora. No entanto, ele pode ser removido da entrada ou saída para melhorar a leitura.
A resposta POST retorna o status do evento transacional no momento em que foi criado. Para recuperar seu status atual (dados do evento, status do evento…), use a Chave Primária retornada pela resposta do POST em uma solicitação de GET:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/
Solicitação de amostra
POST para enviar o 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"
}
}
Resposta à solicitação de 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":""
}
Na resposta, o campo "status" permite que você saiba se o evento foi processado ou não: