Gestione dei messaggi transazionali

Dopo aver creato e pubblicato un evento transazionale, devi integrare l’attivazione di questo evento nel sito web.

Ad esempio, desideri attivare un evento "Abbandono carrello" ogni volta che uno dei tuoi clienti lascia il tuo sito web prima di acquistare i prodotti nel carrello. Per eseguire questa operazione, in qualità di sviluppatore web, devi utilizzare l’API dei messaggi transazionali REST.

1. Invia una richiesta in base al metodo POST, che attiva il invio dell’evento sulle transazioni.
2. La risposta alla richiesta POST contiene una chiave primaria, che ti consente di inviare una o più richieste tramite una richiesta GET. Potrai quindi ottenere il stato dell'evento.

Invio di un evento sulle transazioni

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

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

• <organization>: il tuo ID ORGANIZZAZIONE personale. Fai riferimento a questa sezione.

• <transactionalapi>: endPoints dell’API per messaggi transazionali.

  Il nome dell’endpoint API per i 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 per i 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 (consulta questa sezione).

intestazione di richiesta POST

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

È necessario aggiungere un set di caratteri, 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 di JSON POST. La struttura dell’evento dipende dalla sua definizione. Il pulsante di anteprima API nella schermata di definizione delle risorse fornisce un esempio di richiesta. Fai riferimento a questa sezione.

I seguenti parametri facoltativi possono essere aggiunti al contenuto dell’evento per gestire l’invio di messaggi transazionali collegati all’evento:

• scadenza (facoltativo): dopo tale data, l’invio dell’evento sulle transazioni verrà annullato.
• programmato (facoltativo): a partire da questa data, l’evento sulle transazioni verrà elaborato e il messaggio sulle transazioni verrà inviato.

Risposta alla richiesta POST

La risposta di POST restituisce lo stato dell’evento sulle transazioni al momento della creazione. Per recuperare il proprio stato corrente (dati evento, stato evento…), utilizza la chiave primaria restituita dalla risposta di POST in una richiesta GET:

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

Richiesta di esempio

Richiesta di POST per l’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 sulle transazioni

Nella risposta, il campo "status" ti 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.
• in pausa: il processo dell’evento è in pausa. Non viene più elaborato, ma viene mantenuto in coda nel database di 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 - questo può verificarsi, ad esempio, quando il tipo di evento specificato non può essere trovato.
• tooOld: l’evento è scaduto prima che fosse in grado di essere elaborato. ciò può accadere per vari motivi, ad esempio, quando un’invio non riesce più a volte (questo fa sì che l’evento non sia più aggiornato) o quando il server non può più elaborare gli eventi dopo essere stato sovraccaricato.
• targetingFailed: Campaign Standard non è riuscito ad arricchire un collegamento utilizzato per il targeting dei messaggi.