API Conversions

Specifiche del payload

L'integrazione del CRM con l'API Conversions di Meta e l'utilizzo dell'obiettivo di ottimizzazione Contatti di conversione per le inserzioni per acquisizione contatti possono assicurare risultati di qualità migliore. Al momento, questa ottimizzazione supporta solo inserzioni per acquisizione contatti native (moduli interattivi) generati su Facebook o Instagram.

Questa guida fornisce le specifiche del payload per gli eventi del CRM caricati solo per l'ottimizzazione Contatti di conversione. Non utilizzare queste specifiche per gli eventi non correlati a questa ottimizzazione.

Consulta la documentazione sull'API Conversions per maggiori informazioni su come muovere i primi passi con l'API e altre risorse utili.

Payload degli eventi

Parametri

NomeDescrizione

lead_id

intero

Obbligatorio.
L'ID generato da Facebook per ogni contatto. È un numero di 15 o 16 cifre ottenuto dal campo leadgen_id nel webhook di generazione di contatti e incluso nel parametro user_data. Consulta Trovare l'ID del contatto per maggiori informazioni.
Per l'associazione, è necessario usare gli ID contatti anziché le informazioni dei clienti. Usa una variabile per passare i valori dell'ID dal tuo CRM.
Nota: non applicare l'algoritmo di hashing.

event_name

stringa

Obbligatorio.
Campo di testo libero per l'acquisizione delle fasi utilizzate all'interno del CRM.
Assicurati di inviare tutte le fasi quando vengono aggiornate, compresa quella iniziale dei contatti.
Ad esempio, le fasi possono includere i seguenti tipi. Se un contatto raggiunge la fase finale "Convertito", si presume che tutte le fasi precedenti siano state inviate precedentemente.

  1. Contatto iniziale da Facebook
  2. Contatto idoneo al marketing
  3. Opportunità di vendita
  4. Convertito

Usa una variabile da passare nelle fasi del tuo CRM. In alternativa, puoi creare una chiamata all'API distinta per ogni fase.

event_time

intero

Obbligatorio
Una marca temporale Unix in secondi indicante quando l'evento di aggiornamento della fase del contatto viene aggiornato dal CRM.
Usa una variabile da passare nei valori della marca temporale Unix dal database.
Nota: il valore del parametro event_time può corrispondere a un massimo di 7 giorni prima dell'invio di un evento a Meta. Inoltre, la marca temporale deve essere successiva all'orario di generazione del contatto, altrimenti l'evento potrebbe essere eliminato.

action_source

stringa

Obbligatorio.
Imposta questo parametro sul valore system_generated per tutti gli eventi Contatti di conversione.
Per le integrazioni dei Contatti di conversione, specifica dove vengono generate le conversioni di sistema.

lead_event_source

stringa

Obbligatorio.
Imposta questo parametro sul nome dello strumento da cui provengono i contatti (ad es. Hubspot, SAP, Oracle, Dynamics, CRM interno ecc.), incluso nel parametro custom_data.

event_source

stringa

Obbligatorio.
Imposta questo parametro sul valore crm per tutti gli eventi Contatti di conversione.
Per l'integrazione dei Contatti di conversione, specifica la fonte dell'evento come CRM nel parametro custom_data.

Esempio

Questo esempio illustra il formato del payload degli eventi inviato nella chiamata API.

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

Scopri di più