Meta CAPI — Conversions API

Il Meta CAPI (Conversions API) è l’interfaccia server-to-server di Meta per inviare eventi di conversione. Invece di uno script nel browser che riporta una conversione, è il tuo server a inviarla direttamente.

Perché esiste

Dopo ATT e le restrizioni dei browser, i segnali lato browser sono diventati incompleti: il pixel non sempre riusciva a sparare, e non sempre a identificare l’utente. CAPI dà alla piattaforma un segnale lato server, non toccato dagli ad blocker né da una pagina che non si carica.

In pratica: i tre passi

Mandare un evento a CAPI non richiede un’integrazione: richiede tre pezzi.

1. Dataset e token. Ti servono l’ID del dataset (il pixel) e un token di accesso con il permesso di gestire gli eventi. Il token sta sul server, mai nel browser.
2. Il payload dell’evento. Almeno event_name, event_time in UTC, event_id per la deduplicazione, action_source (di solito website) e user_data con i dati di matching: email o telefono hashati in SHA-256, fbclid, IP e user agent. Senza user_data l’evento arriva ma non viene attribuito a nessuna persona.
3. La chiamata. Un POST a https://graph.facebook.com/<VERSION>/<DATASET_ID>/events con data=[…] e il token. La risposta dice quanti eventi sono stati ricevuti e quanti hanno trovato un match.

Quello che si controlla dopo: eventi ricevuti = eventi inviati, e nessun evento perso per event_time più vecchio di 7 giorni.

Deduplicazione

Se sia il pixel sia CAPI riportano la stessa conversione, Meta deve sapere che sono lo stesso evento, altrimenti ne conta due. Il meccanismo è un event_id condiviso dalle due segnalazioni:

pixel:  fbq('track', 'Lead', { ... }, { eventID: 'lead_9f21' })
CAPI:   { event_name: 'Lead', event_id: 'lead_9f21', ... }

Senza un event_id coerente, le conversioni vengono gonfiate — e conversioni gonfiate abbassano il CPL riportato, il che fa sembrare il numero della piattaforma migliore della realtà. È la prima cosa da controllare quando i due CPL non concordano.

Cosa migliora

• Qualità del matching: inviare fbclid, email o telefono hashati alza la quota di eventi che la piattaforma riesce ad attribuire.
• Ottimizzazione: l’optimizer della piattaforma impara dagli eventi che riceve. Se ne vede una frazione, ottimizza su una frazione.

Cosa non fa

Non rende i numeri riportati dalla piattaforma uguali ai tuoi first-party. Il modello applica comunque la sua finestra e la sua modellazione — vedi CPL reale vs CPL della piattaforma.

Termini correlati

• fbclid — l’identificatore che migliora il matching
• Tracking lato server — il pattern generale
• CPL reale — il numero su cui decidi
• Calcolatore CPL — dai un costo per lead a ogni evento
• DropCPL vs Cometly — confronto sul costo per lead, non sul numero di eventi