Guida al tracciamento Meta 2026

L’API Conversions di Meta, spiegata.
Cosa invia, perché affianca il pixel, come configurarla.

Cos’è l’API Conversions (CAPI), come funzionano la deduplicazione con event_id e la qualità dell’associazione degli eventi, e i quattro modi che Meta offre per configurarla. Verificato sulla documentazione di Meta.

Cos’è l’API Conversions di Meta, e ti serve?

L’API Conversions di Meta (CAPI) invia eventi di conversione a Meta dal tuo server, dalla piattaforma del sito, dall’app o dal CRM, senza affidarsi solo al browser del visitatore come il pixel di Meta.

Leggi la risposta completa

Meta consiglia di usarli entrambi, una configurazione che chiama ridondante: pixel e API Conversions condividono gli stessi eventi, e l’API Conversions può catturare eventi del sito che il pixel potrebbe perdere per problemi di rete o di caricamento della pagina. Per non contare un acquisto due volte, dai alla copia del browser e a quella del server lo stesso nome e lo stesso ID evento; Meta ne tiene una se arrivano entrambe entro 48 ore. La qualità dell’associazione degli eventi, un punteggio da 1 a 10, mostra quanto le informazioni sui clienti che invii permettono di associare gli eventi agli account Meta. Puoi configurarla con un partner come Shopify in pochi clic, con il Gateway dell’API Conversions senza codice o con un’integrazione diretta creata da uno sviluppatore.

Come fa Meta a trasformare due copie di un acquisto in una?

Lo stesso acquisto arriva a Meta due volte: una dal browser, una dal tuo server. Meta lo conta una volta quando nome e ID corrispondono.

Esempio

Browser · pixel di Meta

event
"Purchase"
eventID
"order-1042"

Server · API Conversions

event_name
"Purchase"
event_id
"order-1042"

1 acquisto contato

Stesso nome evento e stesso ID evento, ricevuti entro 48 ore: Meta tiene il primo.

Cos’è l’API Conversions di Meta?

L’API Conversions di Meta è una connessione diretta tra i tuoi dati di marketing e i sistemi pubblicitari di Meta. Invece di affidarsi solo al codice nel browser del visitatore, invia eventi come acquisti, lead o aggiunte al carrello dal tuo server, dalla piattaforma del sito, dall’app o dal CRM, così Meta può misurare e ottimizzare le tue inserzioni.

Continua a leggere

Meta la presenta come un modo per ottimizzare il targeting delle inserzioni, ridurre il costo per risultato e misurare i risultati su tutte le sue tecnologie. Una sola API trasporta eventi del sito, eventi dell’app, conversioni offline ed eventi di messaggistica. La troverai abbreviata in CAPI, e spesso chiamata con il nome inglese Conversions API di Facebook.

Meta segnala anche che l’API Offline Conversions è stata dismessa a maggio 2025: gli eventi offline ora passano dall’API Conversions, nei dataset.

Perché usare l’API Conversions oltre al pixel?

Perché il pixel da solo perde eventi. Secondo le best practice di Meta, l’API Conversions può catturare eventi del sito che il pixel potrebbe perdere per problemi di rete o errori di caricamento della pagina. Meta consiglia una configurazione ridondante: invia gli stessi eventi, come acquisto, inizio del checkout o contatto, tramite il pixel e l’API Conversions.

Continua a leggere

Meta indica perfino un obiettivo per questa parità: punta a un tasso di copertura del 75% tra eventi dell’API Conversions ed eventi del pixel di Meta. Puoi seguire questo rapporto in Gestione eventi.

Meta chiede anche di condividere gli eventi in tempo reale, o il più vicino possibile al tempo reale, così il sistema di pubblicazione può valutare chi è più propenso ad agire dopo aver visto un’inserzione.

Come funziona la deduplicazione con event_id?

Quando il pixel e l’API Conversions segnalano lo stesso acquisto, Meta deve sapere che è un solo acquisto, non due. Confronta due campi: l’eventID del pixel deve corrispondere all’event_id dell’API Conversions, e l’event del pixel all’event_name. Quando entrambi corrispondono, Meta tiene un evento e scarta il duplicato.

Continua a leggere

Meta deduplica solo gli eventi ricevuti entro 48 ore dal primo, e in genere tiene quello ricevuto per primo.

Meta documenta un secondo metodo, che invia gli stessi valori fbp o external_id da entrambe le fonti, ma funziona solo quando l’evento del browser arriva prima di quello del server. Meta consiglia il metodo con ID evento e nome evento.

I duplicati che sfuggono gonfiano le conversioni registrate, e il tuo ROAS con loro. Se i tuoi numeri sembrano troppo belli, o crollano all’improvviso, leggi il tuo report Meta riga per riga.

Cos’è la qualità dell’associazione degli eventi?

La qualità dell’associazione degli eventi (Event Match Quality) è un punteggio da 1 a 10 che mostra quanto bene le informazioni sui clienti inviate con i tuoi eventi server permettono di associarli agli account Meta. Meta lo calcola dalla qualità di queste informazioni e dalla quota di eventi abbinati, sui dati delle ultime 48 ore, quindi gli eventi devono arrivare con regolarità.

Continua a leggere

Si applica agli eventi del sito inviati tramite l’API Conversions con l’origine dell’azione impostata su Sito web. Meta dice che un abbinamento migliore aiuta a mostrare le inserzioni alle persone più propense a convertire e ad attribuire le conversioni alle tue inserzioni, e può aumentare le conversioni aggiuntive registrate.

Per alzarlo, invia più parametri con informazioni sui clienti, sottoposti a hash come spiega la documentazione per sviluppatori di Meta, e solo con i permessi e i consensi richiesti dalla legge. Meta ne classifica la priorità:

  • Alta: e-mail e ID clic.
  • Media: ID Facebook Login, data di nascita, paese, numero di telefono, ID esterno e ID browser.
  • Bassa: ID lead, nome, cognome, città e CAP.

Come si configura l’API Conversions?

Meta elenca diverse strade, e dice che molte non richiedono uno sviluppatore. Quella giusta dipende da dove gira il tuo sito e da chi lo gestisce: un partner di piattaforma e-commerce, l’API Conversions abilitata da Meta con un clic, il Gateway dell’API Conversions senza codice o un’integrazione diretta programmata sull’API.

Continua a leggere
  • Integrazioni partner. Su Shopify, WooCommerce, Wix o BigCommerce, Meta dice che la configurazione richiede pochi clic, senza costi aggiuntivi. Anche Adobe, Google Tag Manager, Tealium e altri partner possono collegarla.
  • API Conversions abilitata da Meta. Un’opzione solo web che crea la connessione lato server con un clic, gratis, e invia gli stessi eventi e parametri del tuo pixel, deduplicati automaticamente.
  • Gateway dell’API Conversions. Una configurazione senza codice che scegli in Gestione eventi, ospitata nel tuo account AWS o Google Cloud. Meta dice che riduce la configurazione da settimane a meno di 30 minuti e deduplica automaticamente; i costi cloud, il suo unico costo, partono da 30 $ al mese.
  • Integrazione diretta. Uno sviluppatore invia i tuoi eventi all’API. Meta stima da 2 a 4 settimane per una nuova integrazione, ed è l’unica opzione per gli eventi dell’app e dei negozi fisici.

Meta suggerisce il Gateway se usi già il pixel, non invii ancora eventi web tramite l’API Conversions, spendi più di 300 $ al mese in campagne ottimizzate per eventi web e non lavori con un partner e-commerce. Se un partner come Shopify gestisce già il tuo pixel, Meta consiglia l’integrazione di quel partner.

Le opzioni di configurazione dell’API Conversions, confrontate da Meta
OpzioneChi la configuraCostoEventiDeduplicazione
Partner e-commerce (Shopify, WooCommerce…)Tu, in pochi clicNessun costo aggiuntivoDipende dal partnerDipende dal partner
API Conversions abilitata da MetaTu, con un clicGratisSolo webAutomatica
Gateway dell’API ConversionsTu, senza codiceCosti cloud, da 30 $ al meseWebAutomatica
Integrazione direttaUno sviluppatore, da 2 a 4 settimaneIl tuo sviluppo e la manutenzioneWeb, app, offline, CRM, messaggisticaInvii tu event_id

Costi e tempi sono le cifre di Meta. I costi cloud del Gateway variano in base alla tua regione e al tuo traffico.

Come verifichi in Gestione eventi che l’API Conversions funziona?

Apri Gestione eventi, vai su Data Sources, scegli il pixel a cui il tuo server invia gli eventi e clicca su Overview. Meta dice che dovresti poter verificare gli eventi server entro 20 minuti dall’invio. Overview conta gli eventi ricevuti da Meta e, sotto Connection Method, mostra il canale da cui è stato inviato ciascun evento. Clicca su un evento per i dettagli.

Continua a leggere

Prima di fidarti dei dati reali, usa lo strumento Test Events: Gestione eventi > Data Sources > il tuo pixel > Test Events. Genera un ID di test che invii con i tuoi eventi server nel parametro test_event_code; quegli eventi compaiono poi nella finestra Test Events. Meta indica tre usi: confermare che gli eventi server sono configurati e ricevuti, controllare la deduplicazione vedendo quali eventi sono stati elaborati e quali deduplicati, e analizzare attività insolite.

Meta aggiunge due precauzioni. Togli test_event_code quando hai finito i test: gli eventi inviati con questo parametro non vengono scartati, arrivano in Gestione eventi e servono al targeting e alla misurazione delle inserzioni. E fai i test con le tue informazioni cliente, come nome, email o telefono, perché gli eventi di test possono essere rifiutati se non corrispondono a un account Facebook o Meta.

Per vedere la deduplicazione sui dati reali, apri Event Details per un tipo di evento da Overview e vai alla scheda Event Deduplication. Mostra il tasso di eventi deduplicati per ogni fonte, dove secondo Meta più è alto meglio è e compare un avviso se è troppo basso, e il tasso di utilizzo delle chiavi di deduplicazione. Un Overlap basso, spiega Meta, significa che una o entrambe le fonti inviano chiavi non univoche, oppure che solo una fonte invia una chiave.

La stessa pagina Event Details ha una scheda Event Freshness, con il ritardo medio tra un evento e il suo invio, su una scala da Real Time a Weekly. Meta consiglia di condividere gli eventi il più vicino possibile al tempo reale.

Quali dati invia l’API Conversions e cosa va sottoposto a hashing?

Ogni evento server contiene l’evento stesso, come nome, ora, URL di origine e fonte dell’azione, più i parametri delle informazioni cliente che aiutano Meta ad abbinarlo a un account. I dati di contatto vanno normalizzati e poi sottoposti a hashing SHA-256: Meta dice che i suoi sistemi sono progettati per non accettare dati di contatto senza hashing, che usa solo per l’abbinamento. Con l’SDK Meta Business l’hashing avviene in automatico.

Continua a leggere

Prima viene la normalizzazione, come spiega la pagina Customer Information Parameters di Meta. Email: togliere gli spazi all’inizio e alla fine e scrivere tutto in minuscolo. Telefono: togliere simboli, lettere e zeri iniziali, e includere sempre il prefisso internazionale. Paese: il codice ISO 3166-1 di due lettere in minuscolo, come it.

Meta divide i parametri in tre gruppi:

  • Hashing SHA-256: email, telefono, nome, cognome, data di nascita, genere, città, stato o provincia, CAP e paese.
  • Hashing consigliato: ID esterno, il tuo identificativo cliente, come un numero fedeltà o un ID utente.
  • Mai hashing: indirizzo IP del cliente, user agent del cliente, ID clic (fbc), ID browser (fbp), ID abbonamento, ID Facebook Login e ID lead.

IP e user agent vengono aggiunti automaticamente agli eventi del browser, ma secondo Meta devi impostarli tu negli eventi server, e lo user agent è obbligatorio per gli eventi del sito. I valori fbc e fbp vengono da cookie proprietari che il pixel imposta sul tuo dominio, e Meta chiede di aggiornarli regolarmente se li invii.

L’hashing non sostituisce il consenso. Se gestisci ciò che il pixel condivide in base al consenso, Meta chiede di applicare la stessa logica all’API Conversions. Per gli utenti negli Stati Uniti, Meta documenta opzioni di trattamento dei dati, da aggiungere in ogni evento, per attivare l’uso limitato dei dati (Limited Data Use).

Cosa leggere dopo?

Eventi puliti sono solo il punto di partenza. Quello che conta dopo è leggere i risultati che producono.

Adwize legge i risultati che producono i tuoi eventi

Adwize non configura l’API Conversions. Quando i tuoi eventi arrivano a Meta, Adwize legge i risultati delle tue campagne, scrive report in parole semplici e segnala ciò che va fuori rotta. Niente cambia finché non approvi.

Domande sull’API Conversions di Meta

Ancora dubbi? Scrivici. Ti risponde una persona vera.

Meta consiglia di tenerli entrambi. Le sue best practice descrivono una configurazione ridondante in cui il pixel e l’API Conversions condividono gli stessi eventi, perché l’API Conversions può catturare eventi che il pixel perde per problemi di rete o errori di caricamento della pagina. La deduplicazione tiene poi una sola copia di ogni evento.

Fonti

Ogni dato di questa pagina viene dal centro assistenza di Meta e da Meta for Developers. La pagina è stata verificata l’ultima volta l’11 ottobre 2026; ogni fonte indica la data in cui l’abbiamo letta per intero. Quando Meta cambia una regola o una cifra, la pagina cambia con essa.

  1. Centro assistenza Meta Business: About Conversions API
  2. Centro assistenza Meta Business: Compare Conversions API setup options
  3. Centro assistenza Meta Business: Best practices for Conversions API
  4. Centro assistenza Meta Business: About event match quality
  5. Centro assistenza Meta Business: About Conversions API Gateway
  6. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
  7. Meta for Developers: Conversions API Gateway
  8. Meta for Developers: Verifying Your Setup
  9. Meta for Developers: Using the API
  10. Meta for Developers: Best Practices for the Conversions API
  11. Meta for Developers: Customer Information Parameters
  12. Meta for Developers: End-to-End Implementation of the Conversions API

Annunci Meta, resi facili

Lancia la tua prossima campagna in 2 minuti.

Meta Ads