Meta Conversion API: guida pratica per PMI
Cos'è la Conversion API di Meta, quando serve, come implementarla senza duplicare gli eventi e quali errori rovinano la qualità del match.
Se fai advertising su Facebook e Instagram, Meta te lo sta ripetendo da anni in ogni angolo di Gestione inserzioni: "attiva la Conversion API". Il consiglio è giusto, ma il modo in cui viene presentato (un interruttore da accendere) è fuorviante. La Conversion API è un'infrastruttura, non un'opzione. Fatta bene, cambia i risultati delle campagne. Fatta a metà, duplica gli eventi e peggiora le cose.
Questa guida è per chi ha una PMI, gestisce o fa gestire le campagne, e vuole capire cosa chiedere, a chi e come verificare che funzioni.
Cos'è la Conversion API
Il Pixel di Meta è uno script che gira nel browser dell'utente e segnala a Meta cosa succede sul tuo sito: una pagina vista, un prodotto aggiunto al carrello, un acquisto. La Conversion API (CAPI) fa la stessa cosa, ma dal tuo server: è il tuo sistema che chiama direttamente i server di Meta e dice "questo utente ha comprato, ecco i dettagli".
Perché due canali per lo stesso evento? Perché il browser è diventato un posto inaffidabile per misurare. Ad blocker, limiti dei cookie su Safari, utenti iOS che negano il tracciamento: una fetta delle conversioni che il Pixel dovrebbe vedere non arriva mai. Il server, invece, vede tutto quello che succede sul tuo sito, perché il sito è tuo. Ne abbiamo parlato nel dettaglio in cos'è il tracking server-side e perché serve.
Pixel, CAPI o entrambi?
La risposta corretta è quasi sempre entrambi, con deduplicazione. Ecco perché.
| Criterio | Solo Pixel | Solo CAPI | Pixel + CAPI deduplicati |
|---|---|---|---|
| Copertura delle conversioni | Parziale | Alta | Alta |
| Dati sul comportamento in pagina (scroll, clic) | Sì | No | Sì |
| Resistenza ad ad blocker e ITP | Bassa | Alta | Alta |
| Qualità del match con gli utenti Meta | Dipende dal cookie | Dipende dai dati che invii | Massima: si sommano i segnali |
| Rischio di doppio conteggio | No | No | Solo se la deduplicazione è sbagliata |
| Raccomandato da Meta | No | Solo in casi particolari | Sì |
Il Pixel resta utile perché raccoglie segnali che il server non ha (gli identificativi del browser). La CAPI garantisce che gli eventi che contano, lead e acquisti su tutti, arrivino sempre.
Prima di iniziare: cosa ti serve
Un'implementazione pulita richiede quattro cose chiare prima di scrivere una riga di configurazione.
- Un elenco di eventi definito. Quali azioni vuoi tracciare, con che nome standard di Meta (Lead, Purchase, AddToCart, InitiateCheckout, CompleteRegistration), con quali parametri (valore, valuta, identificativo ordine, contenuti). Se oggi non esiste su un foglio condiviso, parti da lì.
- Accesso al Business Manager e al dataset. Il "Pixel" oggi si chiama dataset: da lì generi il token di accesso che il tuo server userà per autenticarsi. Il token va trattato come una password.
- Un posto dove far girare la logica server. Le opzioni realistiche per una PMI sono tre: l'integrazione nativa della piattaforma e-commerce (Shopify e WooCommerce la offrono), il Conversions API Gateway di Meta, oppure un container di tagging lato server sul tuo dominio. La terza è quella che consigliamo quando vuoi anche Google, GA4 e un data warehouse: un solo flusso di eventi per tutti.
- Una gestione del consenso già funzionante. La CAPI non è un modo per aggirare il banner dei cookie. Se l'utente rifiuta il marketing, l'evento non va inviato, né dal browser né dal server.
Implementazione passo per passo
Passo 1: assegna un identificativo a ogni evento
È il cuore della deduplicazione. Quando l'utente completa un acquisto, il tuo sito genera un identificativo univoco (ad esempio il numero d'ordine, o un valore casuale) e lo usa sia nell'evento inviato dal Pixel sia in quello inviato dal server, nel parametro event_id. Meta riceve due eventi con lo stesso nome e lo stesso identificativo entro una finestra di tempo, e ne tiene uno solo.
Se salti questo passaggio, Meta conterà ogni acquisto due volte: report gonfiati per una settimana, poi un algoritmo che ottimizza su dati falsi e costi reali che salgono.
Passo 2: invia i parametri che migliorano il match
Il valore della CAPI sta nei dati che accompagnano l'evento, quelli che permettono a Meta di capire quale utente ha convertito e collegarlo all'annuncio che ha visto. In ordine di importanza:
fbpefbc: i due cookie di Meta. Il primo identifica il browser, il secondo contiene l'identificativo del clic sull'annuncio. Se il tuo server non legge e non inoltrafbc, perdi la parte migliore dell'attribuzione.- Email e telefono, normalizzati (minuscolo, senza spazi, prefisso internazionale) e trasformati con hash SHA-256 prima dell'invio. Meta li confronta con gli hash dei propri utenti. Sono disponibili per lead e acquisti, non per le pagine viste.
- Indirizzo IP e user agent del client. Obbligatori per gli eventi web: senza, Meta scarta o degrada l'evento.
- Identificativo esterno (
external_id), come l'ID cliente del tuo CRM: aiuta a collegare conversioni dello stesso utente nel tempo.
Meta misura tutto questo con l'indicatore di qualità della corrispondenza degli eventi, visibile in Gestione eventi. Nei progetti che seguiamo puntiamo a un punteggio alto sugli eventi di acquisto e lead; se è basso, di solito manca fbc o gli hash non sono normalizzati.
Passo 3: rispetta i tempi
L'evento server deve riportare l'orario in cui l'azione è avvenuta davvero (event_time), non quello dell'invio. Eventi con orari sballati o troppo vecchi vengono rifiutati: è l'errore tipico di una CAPI alimentata da un export notturno del gestionale.
Passo 4: testa prima di andare in produzione
In Gestione eventi, la scheda Test degli eventi ti permette di inviare eventi con un codice di test e vedere in tempo reale cosa arriva, quali parametri contiene e se è stato deduplicato con il Pixel. Fai un acquisto di prova da Safari con tracking bloccato: se la CAPI funziona, l'evento arriva comunque.
Passo 5: monitora nel tempo
Siti e piattaforme cambiano. Un aggiornamento del tema, un nuovo plugin di checkout, un cambio nel banner dei cookie possono interrompere il flusso senza che nessuno se ne accorga. Un controllo automatico che confronti ogni giorno gli ordini reali con gli eventi ricevuti da Meta, e avvisi quando la differenza supera una soglia, costa poco e salva i budget. È parte di quello che chiamiamo affidabilità del tracking.
Gli errori che vediamo più spesso
- Eventi duplicati perché
event_idmanca o è diverso tra browser e server. fbcmai inoltrato perché il server non legge il cookie o perché il parametrofbclidviene perso in un redirect.- Hash su dati sporchi: email con maiuscole o spazi, telefoni senza prefisso. L'hash di "Mario@Email.it" e quello di "mario@email.it" sono diversi, e il match fallisce.
- Nomi di eventi personalizzati dove esistevano quelli standard. Meta ottimizza meglio su Purchase che su "acquisto_completato".
- Valore dell'ordine senza valuta, o con la spedizione inclusa in modo incoerente tra Pixel e server.
- Invio senza consenso, che oltre a essere un problema legale invalida il dato quando il banner viene corretto.
Cosa aspettarti
Il beneficio arriva in due fasi. Nei primi giorni vedi più conversioni attribuite: eventi che prima si perdevano ora arrivano. Nei nostri progetti il recupero medio rispetto al solo Pixel è stato intorno al 40%. Nelle settimane successive l'algoritmo, con più dati e migliori, trova pubblici più precisi e il costo per acquisizione tende a scendere. Non è una promessa: dipende da mercato, creatività e budget. Ma un algoritmo che vede metà delle conversioni lavora con una mano legata.
Dove si inserisce nel quadro generale
La Conversion API è il pezzo più visibile di un sistema più ampio. La stessa infrastruttura server che alimenta Meta può inviare conversioni avanzate a Google Ads, eventi a GA4 e TikTok, e scrivere tutto in un data warehouse su cui costruire una dashboard che collega la spesa pubblicitaria al venduto reale. Il modo in cui strutturiamo questo livello è descritto nella pagina dedicata al tracciamento delle conversioni, parte del nostro framework di tracking server-side.
Se vuoi una verifica dello stato attuale del tuo Pixel e della tua CAPI, prenota una call: in trenta minuti guardiamo Gestione eventi insieme e ti diciamo cosa manca.