Come impostare le catture Driftrock Webhook

È possibile impostare uno o più Webhook Capture per inviare lead (o eventi di conversione) a Driftrock.

Ad esempio, si può creare un Webhook Capture per ogni fonte o applicazione che si desidera collegare a Driftrock.

‍

Creazione di una cattura Webhook

Per iniziare a inviare chiamate API a Driftrock è necessario un Capture.

Se siete un fornitore di terze parti, potreste aver già ricevuto uno o più ID di cattura Driftrock e quindi potete saltare questo passaggio.

1. Creare o accedere al proprio account Driftrock.

2. Sfogliate la libreria Lead Capture e scegliete Driftrock Webhook Capture.

3. Ricordate che potete creare tutte le catture Webhook che volete (magari per ogni fonte o applicazione a cui vi connettete).

4. È il momento di effettuare la prima chiamata alla nostra API e di inviare un lead di prova al nostro endpoint di test.

‍

Invio di eventi all'API Eventi di Driftrock

È possibile effettuare richieste POST a questo url:

https://external-apis.driftrock.com/v2/event

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:

• tipo_evento [stringa] ( obbligatorio): deve essere impostato su lead 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"} )
• metadata [json] ( opzionale): è un campo json, in cui si inviano gli attributi dei metadata di questo evento. Gli attributi supportati sono: fbclid, ga_client_id, gclid, utm_campaign, utm_content, utm_keyword, utm_medium, utm_source, utm_term
• 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] (opzionale): può essere un 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.
• 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",
   ...
 },
 "metadata": {
   "utm_source": "google",
   "ga_client_id": "xxxxx.yyyyy",
   ...
 },
}

Inviare il primo lead di prova. In caso di successo, il simbolo di caricamento nella fase Connect dell'acquisizione del webhook sarà sostituito da un messaggio di successo e si potrà passare alla fase successiva.
‍

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": "..."}

‍

5. Una volta inviato il lead di prova, passare alla fase di mappatura e mappare i campi in entrata con i campi standard o personalizzati di Driftrock (se è necessario crearne uno nuovo).

‍

Nota: se avete scelto di utilizzare lo script di tracciamento del sito web di Google Analytics di Driftrock, i campi di tracciamento del marketing dovrebbero essere riempiti automaticamente con i parametri di GA.

Ad es.

‍

6. Passate alla fase Destinazioni per mappare i dati in altri sistemi, oppure completate semplicemente l'impostazione dell'acquisizione se siete soddisfatti che i contatti risiedano solo in Driftrock.

7. Siete pronti!

‍

‍