Come inviare le conversioni a Facebook/Meta tramite Conversion API (CAPI)

Questo articolo spiega come inviare un trigger di conversione a Facebook tramite la sua Conversion API, comunemente chiamata “CAPI”, ogni volta che un utente invia un modulo Growform.

Con i browser che bloccano sempre più spesso i cookie e le restrizioni sulla privacy sempre più stringenti, il fidato pixel di Facebook non è più affidabile come un tempo. Entra in gioco CAPI: la soluzione server-to-server di Facebook che ti permette di tracciare le conversioni anche quando i metodi di tracciamento tradizionali non funzionano.

Inviando in modo sicuro a Facebook informazioni da server a server, come indirizzi e-mail e indirizzi IP con hashtag, la piattaforma può associare i moduli inviati ai singoli utenti senza ricorrere ai cookie.

Questa guida non richiede alcuna esperienza di codifica, grazie al nostro partner per le integrazioni, Zapier, che ha un generoso piano gratuito e piani convenienti per qualche migliaio di attività al mese.

1. Cattura l’indirizzo IP e l’agente utente in Growform

Per prima cosa, dovrai abilitare la raccolta di indirizzi IP e user-agent in Growform. Lo “user-agent” è una descrizione standardizzata del browser dell’utente (ad esempio: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36), mentre l’indirizzo IP è l’equivalente Internet del numero di telefono dell’utente.

Sebbene sia possibile attivare il tracking CAPI anche senza questo, esso fornirà una corrispondenza migliore ed è uno dei migliori segnali disponibili. Ecco come:

• Vai al tuo modulo in Growform
• Premi “Modifica le impostazioni del modulo”.
• Scegli “Cattura i dettagli del sistema”.
• Premi “Salva le impostazioni del modulo”.

Tieni presente che in alcune giurisdizioni potresti dover chiedere l’autorizzazione ai tuoi utenti prima di acquisire informazioni univocamente identificabili come l’indirizzo IP.

Con questa impostazione attivata, Growform acquisirà l’indirizzo IP e l’user-agent, che saranno disponibili insieme agli altri campi nei passaggi successivi.

2. Esegui un invio di prova

Una volta abilitata la raccolta degli indirizzi IP e degli user-agent, è importante eseguire un invio di prova, che permetterà a Zapier di “vedere” i nuovi dati che cattureremo nel passaggio successivo.

Prova il tuo modulo cliccando su “Visualizza modulo” (o visitando la sua posizione embed) e compilalo.

Una volta inviato un lead, dovresti vedere l’user-agent e l’indirizzo IP insieme alle altre informazioni del modulo nella pagina “visualizza lead”:

D’ora in poi, questi campi saranno selezionabili anche in Zapier, insieme a tutti gli altri campi.

3. Crea uno zap

Ora accedi a Zapier (creando un account se necessario) e premi “Crea” per creare un nuovo Zap. Se non conosci Zapier, qui trovi una guida generica sull’utilizzo della piattaforma.

Imposta il trigger di Growform in questo modo:

• Imposta il tuo trigger come Growform
• Imposta l’evento di attivazione come Nuovo invio del modulo
• Seleziona il tuo account Growform e connetti Growform a Zapier, se necessario.
• Imposta l’ ID del modulo in questione e premi “Test trigger” per vedere l’ultimo invio in Zapier.

Impostazione della conversione Facebook/CAPI

Ora che abbiamo i nostri dati da Growform, è il momento di inviare un evento di conversione a Facebook/Meta. Ecco come:

• Premi “Azione” e cerca “Conversioni Facebook”. Scegli“Conversioni Facebook per amministratori aziendali“, se hai un account di amministratore aziendale. In caso contrario, scegli “Conversioni Facebook”.
  
• Per l’evento azione, scegli Invia altro evento per la maggior parte dei casi d’uso (es. “CompleteRegistration”, “AddToCart” o un evento personalizzato. Se hai bisogno di lanciare un evento “Acquisto” o “Lead”, scegli l’opzione corrispondente, ma tieni presente che questa guida continuerà con Invia altro evento.

Premi “Continua” e vedrai un elenco di campi che puoi inviare a Facebook. Ecco i campi più importanti:

• Fonte dell’azione: Deve essere impostato su “Sito web”.
  
• Nome dell’evento: deve essere impostato sull’evento che desideri inviare (ad esempio AddToCart o CompleteRegistration). NON scegliere “Acquisto” o “Lead” se hai scelto “Invia un altro evento” nel passaggio precedente, perché non funzionerà.
  
• Ora dell’evento: Se il tuo zap viene eseguito ogni 2 minuti, puoi semplicemente lasciare questo valore vuoto, poiché Zapier utilizzerà l’ora dello zap, che sarà molto vicina all’ora dell’evento. Se il polling è di 15 minuti o non ne sei sicuro, devi inviare l’ora di invio del modulo in formato UNIX (vedi sotto).

• URL di origine dell’evento: Se possibile, questo dovrebbe essere impostato sul sito web in cui hai inserito il modulo. Questo campo è obbligatorio se hai scelto “Sito web” come fonte dell’azione.
  
• Informazioni sul cliente: Queste sono le informazioni sul cliente che verranno utilizzate per l’abbinamento. Dovrai semplicemente mappare tutte le informazioni sul cliente che hai a disposizione (es. indirizzo e-mail, numero di telefono, nome). Non c’è bisogno di fare l’hashish: Zapier se ne occuperà automaticamente.

Ti consigliamo di inviare almeno un messaggio:

• Email
• Indirizzo IP del cliente
• Agente utente

Se hai seguito correttamente i passaggi 1 e 2, sarai in grado di selezionare l’indirizzo IP e l’user-agent insieme a tutti gli altri dati del modulo:

Ecco fatto! Vai avanti e premi “Continua”, poi “Passo di prova”. Dovresti vedere una risposta come la seguente, senza alcun messaggio di errore:

Ecco fatto! Il nostro evento è stato inviato con successo a Meta. Successivamente, verificheremo che sia arrivato sano e salvo nell’interfaccia di Facebook Business Manager. Se in questa fase hai riscontrato un errore, non preoccuparti: consulta la sezione “Risoluzione dei problemi” qui sotto.

4. Controlla il tuo evento su Facebook

Se nel “Gestore eventi” di Facebook vedi un avviso che ti chiede di consentire o bloccare gli eventi di Growform o di un dominio a te noto, devi premere su Consenti affinché gli eventi vengano ricevuti correttamente.

Facebook ha un ritardo di 30 minuti sul tracciamento degli eventi, quindi se hai inviato il tuo evento con successo nel passaggio precedente ma non lo vedi ancora, torna tra mezz’ora. Secondo la nostra esperienza, gli eventi impiegano 15-20 minuti per apparire!

• Vai su business.facebook.com e vai su “Gestione eventi”. Al momento in cui scriviamo, è possibile accedervi premendo “Tutti gli strumenti” e poi “Gestore eventi”.

• Assicurati di essere sull’account corretto a cui hai inviato i dati: a volte è necessario spostare gli account nell’angolo in alto a destra e anche premere “Vedi altri account pubblicitari”.
  
• Alla voce “Fonti di dati”, scegli il tuo pixel e cerca il nome dell’evento che hai inviato in precedenza. Se il nome dell’evento è corretto, dovresti vedere “Multiple” o “Conversions API” nella colonna “Integration”: ciò significa che l’evento è stato ricevuto con successo tramite API.

Ecco l’evento backend, mostrato nel nostro account:

Opzionale: Invio dell’ora di invio del modulo in formato UNIX

Se vuoi inviare a Zapier l’ora di invio del modulo, dovrai anche convertirla in “X” o “Unix”, che è il formato che Facebook prevede per i dati.

Il formato UNIX è un numero lungo, che in realtà è il numero di secondi dal 1970!

Ecco come:

• Aggiungi un passaggio sopra la fase di conversione di Facebook
• Scegli “Formattatore
• Come evento dell’azione, scegli Data/Ora
• In “Trasformazione”, scegli Formato
• Come input, scegli Data di invio da Growform
• Come “Per formattare”, scegli X (l’ultima opzione al momento in cui scriviamo), quindi premi “Continua”.
• Premi continua e vedrai il risultato di questo passaggio in pochi secondi
• Al momento dell’evento, nella fase delle conversioni di Facebook, puoi inserire il valore che hai appena reso disponibile!

Risoluzione dei problemi

Avviso“Parametro non valido” visualizzato in Zapier

Questo è un errore molto comune nelle prime configurazioni e significa che uno dei campi che Facebook si aspetta non è corretto. Sfortunatamente, Facebook non ci dice quale campo non è corretto, per cui controlla bene quanto segue:

• La tua “Fonte dell’azione” è impostata su Sito web
• Il nome dell’evento NON è impostato su “Acquisto” o “Lead” se stai utilizzando lo zap “Invia un altro evento” come descritto in questo tutorial. Se desideri utilizzare questi eventi, devi selezionare il relativo “evento azione” all’inizio della configurazione della conversione su Facebook.
• L’URL di origine dell’evento è impostato su un URL valido (ad esempio https://www.example.com) e non è lasciato vuoto.
• Alla voce “informazioni sul cliente” è impostata l’email, che è un campo obbligatorio per Facebook.
• Alla voce “informazioni sul cliente” è impostato l’user-agent del cliente, richiesto da Facebook.

Evento non visibile su Facebook

• Attendi 30 minuti per l’evento – Facebook avverte che possono essere necessari 30 minuti per l’elaborazione degli eventi del backend.
• Assicurati che Facebook non stia bloccando gli eventi: controlla la tua dashboard di Facebook nel gestore eventi per vedere se c’è un banner che offre la possibilità di “consentire” o “bloccare” gli eventi, e scegli “consentire” se c’è l’opzione.