Tracking

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.

Schema astratto: una linea tratteggiata dal browser e una linea continua dal server convergono in un nodo di deduplica, da cui esce un solo evento.

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.

Due corsie parallele verso Meta: dal browser parte una linea tratteggiata etichettata Pixel, dal server una linea continua etichettata CAPI.
Lo stesso evento viaggia su due canali: il Pixel dal browser dell'utente, la Conversion API dal tuo server. Il secondo non dipende da ad blocker e limiti dei cookie.

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.

  1. 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ì.
  2. 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.
  3. 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.
  4. 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.

Un evento Pixel e un evento CAPI, entrambi con lo stesso event_id, entrano in un nodo di deduplica: ne esce un solo evento confermato.
Pixel e server inviano lo stesso evento con lo stesso event_id: Meta li riconosce come duplicati e ne conta 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:

  • fbp e fbc: 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 inoltra fbc, 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.
Quattro parametri, fbc, fbp, email e IP, confluiscono in un evento che alimenta un indicatore circolare della qualità del match.
Più parametri accompagnano l'evento (cookie fbc e fbp, email e telefono in forma hash, IP e user agent), più Meta riesce a riconoscere chi ha convertito.

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_id manca o è diverso tra browser e server.
  • fbc mai inoltrato perché il server non legge il cookie o perché il parametro fbclid viene 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.

Continua a leggere

Articoli correlati

Schema astratto: documenti ed email sparsi entrano in un nodo AI centrale che li ordina in tre colonne.

Digitalizzazione con AI nelle PMI: da dove iniziare

Non dal chatbot e non dal tool del momento: come scegliere il primo caso d'uso di AI in una PMI, quali dati servono e cosa aspettarsi in 90 giorni.

Prenota la call — è gratuita

Smetti di decidere a sensazione.
Vedi i tuoi dati, finalmente.

In 30 minuti analizziamo le tue fonti dati, individuiamo i KPI che contano davvero e ti lasciamo un piano concreto. Da tenere comunque, anche se non lavoriamo insieme.

Nessun impegno Setup completo in 14 giorni Facciamo tutto noi