Kamran Arshad
Note sul campo  /  Server-side

Ha installato CAPI e il fatturato è raddoppiato. Non è così.

Acquisti duplicati dopo l'installazione della Conversions API significano quasi sempre una cosa: browser e server inviano valori di event_id diversi per lo stesso acquisto. Meta deduplica quando coincidono event_name ed event_id. Se gli ID differiscono, non ha modo di sapere che i due eventi sono lo stesso ordine, quindi li conta entrambi.

La versione pericolosa è il guasto opposto: ID che collidono e vendite reali che perde in silenzio.

Installare la Conversions API è la scelta giusta. Il tracciamento nel browser perde eventi per ad blocker, protezione dal tracciamento, sessioni interrotte e pagine abbandonate, e un flusso lato server ne recupera buona parte. Quasi tutti dovrebbero usarli entrambi.

Ma «usarli entrambi» significa che Meta riceve due segnalazioni di ogni acquisto, e l'unica cosa che le impedisce di contarlo due volte è un identificatore condiviso. Se l'identificatore sbaglia in un senso, il fatturato raddoppia sulla carta. Se sbaglia nell'altro, il fatturato si dimezza in silenzio.

Come funziona davvero la deduplicazione

Meta confronta due campi insieme: event_name ed event_id. Entrambi devono coincidere.

✗ Contato due volte
Browser:
  event_name: "Purchase"
  event_id:   "a91f-2026-08-12"

Server:
  event_name: "Purchase"
  event_id:   "1047"
✓ Deduplicato in uno
Browser:
  event_name: "Purchase"
  event_id:   "order_1047"

Server:
  event_name: "Purchase"
  event_id:   "order_1047"

La regola è semplice da enunciare e facile da violare nella pratica, perché i due lati di solito sono costruiti da sistemi diversi in momenti diversi. L'evento del browser lo genera un tema o un tag manager; quello del server un'app, un servizio intermedio o il Suo codice. Niente li obbliga a coincidere e niente La avvisa quando non coincidono.

Scegliere un identificatore che non possa divergere

L'identificatore deve essere unico per ordine e identico su entrambi i percorsi. Questi due requisiti escludono quasi tutto ciò che viene in mente per primo.

CandidatoUnico per ordine?Uguale su entrambi i lati?Verdetto
ID / numero d'ordineSìSì, se entrambi leggono l'ordineDa usare
UUID generato casualmenteSìSolo se generato una volta e trasmessoRischioso
ID del checkoutNon sempreSpesso diverso dall'ID d'ordineDa evitare
ID di sessioneNoNoMai
TimestampNoQuasi maiMai

I timestamp sono il candidato peggiore e il più allettante, perché sembrano unici. Non lo sono: due ordini nello stesso secondo collidono, e l'orologio del browser non è quello del server. Un UUID va bene solo se viene generato una volta e poi passato all'altro lato; se ogni lato genera il proprio, ha costruito una macchina per i duplicati.

Il guasto più subdolo: la perdita silenziosa

Tutti si preoccupano del doppio conteggio perché si vede. Il bug peggiore è un identificatore non unico: un ID di checkout riutilizzato tra ordini, o un valore che si ripete. Allora Meta deduplica correttamente due acquisti davvero diversi in uno solo, e Lei perde fatturato reale nei report senza alcun errore da nessuna parte.

Il doppio conteggio sembra una buona notizia e viene indagato. La perdita silenziosa sembra un lento calo e viene attribuita agli annunci.

Dimostrare che funziona, non darlo per scontato

Configurato non vuol dire funzionante. Ecco il test che lo chiarisce, e richiede circa quindici minuti.

  1. Fare un ordine realeUn acquisto reale tramite il checkout reale, non un link di test. Annoti il numero d'ordine.
  2. Rilevare l'ID evento nel browserApra i DevTools prima del checkout, filtri la scheda Network per facebook, completi l'ordine e legga l'eventID della richiesta Purchase.
  3. Rilevare l'ID evento sul serverNei log della Sua integrazione CAPI, oppure in Gestione eventi, trovi l'evento lato server dello stesso ordine e ne legga l'event_id.
  4. Confrontarli carattere per carattereNon simili. Identici. Un prefisso su un lato (order_1047 contro 1047) è un errore, non un dettaglio.
  5. Controllare i report di deduplicazioneIn Gestione eventi apra l'evento Purchase e guardi come viene ricevuto. Una configurazione deduplicata correttamente mostra browser e server come fonti dello stesso evento, non due totali separati.
  6. Riconciliare una settimana interaConfronti il numero di ordini del negozio con gli acquisti in Gestione eventi per una settimana chiusa. Molto sopra i Suoi ordini significa duplicazione. Molto sotto significa perdita.

Il numero che Le dice che funziona

Una volta corretta la deduplicazione, la metrica da tenere d'occhio è la qualità della corrispondenza degli eventi (Event Match Quality). Riflette quante informazioni identificative invia con ogni evento (email con hash, telefono, nome, posizione, identificatori di clic) e determina quanto bene Meta può attribuire una conversione alla persona che ha visto l'annuncio.

È qui che la Conversions API si guadagna il posto. Il Suo server conosce email e telefono del cliente perché ha appena acquistato. Il browser spesso no. Inviare questi dati dal server, con hash corretto, di solito vale più del recupero degli eventi bloccati.

Usi l'hash e verifichi di averlo fatto

Gli identificatori dei clienti devono essere sottoposti a hash SHA-256 prima dell'invio. Non è un dettaglio di prestazioni: è la differenza tra inviare a Meta un hash e inviarle i dati personali in chiaro dei Suoi clienti. Se costruisce l'integrazione da solo, verifichi l'hash su un payload reale prima di andare online, perché un errore qui è un incidente di protezione dei dati e non un bug di tracciamento.

Cosa non affermo

Non Le ho dato un punteggio obiettivo di Event Match Quality né un miglioramento atteso dall'installazione di CAPI. Entrambi dipendono interamente dai dati dei clienti che può raccogliere legittimamente, dal Suo checkout e dal Suo traffico, e ogni benchmark pubblicato che ho visto viene da un fornitore il cui prodotto migliora proprio il numero misurato.

Misuri il Suo punto di partenza prima della modifica, misuri di nuovo dopo un'intera finestra di attribuzione e si confronti con se stesso. Questo confronto vale più di qualsiasi media pubblicata.

Non sa se la Sua deduplicazione funziona?

È un controllo di quindici minuti e la maggior parte delle configurazioni non lo supera. Mi invii l'URL del Suo negozio e Le dirò cosa trovo.

Ottieni un audit gratuito del tracciamento →