Gestione dei messaggi delle transazioni

Informazioni sulla messaggistica transazionale

Dopo aver creato e pubblicato un evento transazionale, è necessario integrare l'attivazione di questo evento nel sito Web.

Ad esempio, si desidera che venga attivato un evento "abbandono carrello" ogni volta che un cliente abbandona il sito Web prima di acquistare i prodotti nel carrello. A tal fine, lo sviluppatore Web deve utilizzare REST Transactional Messages API.

1. Lo sviluppatore invia una richiesta in base al metodo POST, che attiva l' invio dell' evento transazionale.
2. La risposta alla richiesta di POST contiene una chiave primaria, che consente allo sviluppatore di inviare una o più richieste tramite una richiesta di GET. In questo modo è in grado di ottenere lo stato dell'evento.

Invio di un evento transazionale

L’evento transazionale viene inviato tramite una richiesta POST con la seguente struttura URL:

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

• <organization>: l’ID organizzazione personale. Fai riferimento a questa sezione.

• <transactionalapi>: endPoints dell'API dei messaggi transazionali.

  Il nome dell'endpoint API dei messaggi transazionali dipende dalla configurazione dell'istanza. Corrisponde al valore "mc" seguito dall’ID organizzazione personale. Prendiamo l'esempio della società Geometrixx, con "geometrixx" come ID organizzazione. In tal caso, la richiesta POST sarebbe la seguente:

  POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>

  (L'endpoint API dei messaggi transazionali è visibile anche durante l'anteprima API)

• <eventid>: il tipo di evento che si desidera inviare. Questo ID viene generato durante la creazione della configurazione dell'evento (fare riferimento a questa sezione).

Intestazione richiesta POST

La richiesta deve contenere un "Content-Type: application/json" header.

È necessario aggiungere un charset, ad esempio utf-8. Questo valore dipende dall’applicazione REST in uso.

-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' \

corpo della richiesta POST

I dati dell'evento sono contenuti nel corpo del POST JSON. La struttura dell'evento dipende dalla sua definizione. Il pulsante Anteprima API nella schermata di definizione delle risorse fornisce un esempio di richiesta. Fai riferimento a questa sezione.

Al contenuto dell'evento possono essere aggiunti i seguenti parametri facoltativi per gestire l'invio di messaggi transazionali collegati all'evento:

• scadenza (facoltativo): dopo tale data, l'invio dell'evento transazionale verrà annullato.
• Scheduled (optional): a partire da tale data, l'evento transazionale verrà elaborato e il messaggio transazionale verrà inviato.

Risposta alla richiesta POST

La risposta POST restituisce lo stato dell'evento transazionale al momento della creazione. Per recuperare il suo stato corrente (dati evento, stato evento…), utilizzate la chiave primaria restituita dalla risposta POST in una richiesta di GET:

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

Richiesta di esempio

POST richiesta di invio dell’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"
  }
}

Risposta alla richiesta 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":""
}

Stato dell'evento transazionale

Nella risposta, il campo "status" consente di sapere se l’evento è stato elaborato o meno:

• in sospeso: l'evento è in sospeso. L'evento assume questo stato quando è appena stato attivato.
• elaborazione: l'evento è in attesa di consegna; viene trasformato in un messaggio e il messaggio viene inviato.
• messi in pausa: il processo evento è in pausa. Non viene più elaborata, ma tenuta in coda nel database Adobe Campaign . Per ulteriori informazioni al riguardo, consulta questa sezione.
• elaborati: l'evento è stato elaborato e il messaggio è stato inviato correttamente.
• ignorato: l'evento è stato ignorato dalla consegna, in genere quando un indirizzo è in quarantena.
• deliveryFailed: si è verificato un errore di consegna durante l'elaborazione dell'evento.
• routingFailed: la fase di routing non è riuscita. Ciò potrebbe verificarsi, ad esempio, quando il tipo di evento specificato non è possibile trovare.
• tooOld: l'evento è scaduto prima che fosse possibile elaborarlo. Ciò può accadere per vari motivi, ad esempio, quando un'invio ha esito negativo diverse volte (questo determina l'assenza di un evento) o quando il server non è più in grado di elaborare gli eventi dopo essere stato sovraccaricato.
• targetingFailed: Campaign Standard non è riuscito ad arricchire un collegamento utilizzato per il targeting dei messaggi.