Invio di eventi all'API Eventi di Driftrock

Scoprite come inviare eventi a Driftrock tramite l'API Driftrock Events.

Creazione della richiesta POST

È possibile effettuare richieste POST a questi URL:

Se si invia a una cattura Driftrock Webhook, utilizzare https://external-apis.driftrock.com/v2/event.

Se state inviando a un affiliato Driftrock, utilizzate https://external-apis.driftrock.com/v2/affiliate_event.

Se non siete sicuri di quale utilizzare, contattate il vostro CSM o il nostro Team di assistenza.

Intestazioni:

Content-Type: application/json
Accept: application/json
Authorization: Bearer xxxx-xxxx-xxxx-xxxx

dove xxxx-xxxx-xxxx-xxxx è una chiave api che si può ottenere andando in Impostazioni -> Sicurezza. È possibile utilizzare una chiave creata in precedenza o crearne una nuova.

Body:
Il body deve essere formattato in JSON e contenere i campi obbligatori o consigliati:

  • event_type [string] ( obbligatorio): deve essere impostato su lead, conversion o action.
  • nome_evento [string] ( obbligatorio) : indicare l'etichetta che si desidera assegnare a questo evento (ad esempio: Utente iscritto, Pagina vista, Acquisto).
  • source_id [string] (obbligatorio): è necessario per collegare l'evento all'acquisizione creata. Si trova nel passo "Connetti" (passo 2) della cattura.
  • fields [json]  (required) : this is a json field, where you send us the attributes of this event (eg: "fields": {"email": "test@driftrock.com", "question_1": "test answer"} )
  • event_id [string] (opzionale): può essere qualsiasi ID utilizzato nel sistema per identificare in modo univoco l'evento. Si noti che se si inviano due eventi con lo stesso event_id, essi saranno collegati alla stessa persona nel nostro sistema.
  • person_id [string] (facoltativo): può essere qualsiasi ID utilizzato nel sistema per identificare in modo univoco una persona. Si noti che se si inviano due eventi con lo stesso person_id, essi saranno collegati alla stessa persona nel nostro sistema.
  • ga_client_id [string] (opzionale) : è l'ID di Google Analytics che potete fornire per consentirci di estrarre le informazioni di marketing.
  • created_at [string] (opzionale): se si desidera fornire un timestamp più preciso per il momento in cui si è verificato l'evento. Se non viene fornito, verrà impostato il momento in cui Driftrock riceve l'evento; si tratta di una distinzione sottile, ma può essere importante per il vostro caso aziendale. Questo dato deve essere trasmesso in formato ISO8601 (ad esempio: 2019-12-02T10:00:00.000Z).


Ecco un esempio di come potrebbe apparire un corpo semplice

{
 "event_type": "lead",
 "event_name": "User signed up",
 "source_id": "034feb07-0cd7-4d44-bbdb-ae18a8a4132f",
 "fields": {
   "email": "test@driftrock.com",
   "first_name": "First name",
   "last_name": "Last name",
   ...
 }
}


Inviate il vostro primo cavo di prova.

Se il test ha avuto successo, si dovrebbe vedere la seguente risposta:

  • stato: 200
  • payload: {"data": "ok"}

Se il test non è riuscito, viene visualizzata la seguente risposta:

  • stato: 400
  • payload: {"error": "..."}