Il punto da controllare prima del ROAS

Attivare Conversions API aggiunge un percorso attraverso cui comunicare gli eventi a Meta. Se lo stesso ordine parte dal browser e dal server, devi permettere alla piattaforma di riconoscere che si tratta della stessa azione. Prima di discutere quale campagna funzioni meglio, conviene verificare questa corrispondenza. Un aumento delle conversioni dopo un intervento sul tracciamento richiede una spiegazione tecnica prima di diventare una buona notizia commerciale.

Il metodo che proponiamo parte da un ordine e lo segue fino alle due richieste. Il report aggregato arriva dopo. Questo riduce il campo di indagine: quando qualcosa non torna, puoi indicare il passaggio preciso in cui l'informazione è stata modificata, persa o duplicata. Per lavorare servono accesso al contenitore, visibilità sull'integrazione server e un ordine di prova riconoscibile.

La coppia che identifica la stessa azione

La guida di Stape sulla deduplicazione parte da event_name ed event_id. Le copie browser e server della stessa azione devono condividerne i valori. Nell'invio del Pixel il parametro si chiama eventID; nel payload CAPI si chiama event_id. Controlla il valore effettivamente trasmesso, oltre al nome della variabile nel contenitore.

Progettiamo l'identificatore vicino al fatto aziendale. Per un acquisto, una chiave opaca associata all'ordine è più controllabile di due numeri casuali generati separatamente. Il principio operativo è semplice: una nuova azione riceve una nuova chiave; un nuovo tentativo di comunicare la medesima azione conserva quella chiave. L'identificatore non deve contenere email, telefono o altri dati del cliente.

Esempio operativoDati illustrativi, non dati cliente
SegnaleControlloDecisione
Pixel Purchase · eventID 8421CAPI Purchase · event_id 8421Deduplica attesa
Pixel 8421 · CAPI 8421-serverIdentificatori diversiRischio di doppio acquisto
CAPI inviato 36 ore dopoTimestamp fuori dal flusso normaleCorreggere coda e retry
La decisione arriva dopo il controllo del dato e del contesto, non dal numero isolato.

1. Trova tutti i punti che inviano Purchase

Stape documenta un errore pratico: un Pixel aggiuntivo, installato da plugin o direttamente nel codice, invia eventi senza la chiave presente nel percorso server. L'inventario viene prima della correzione. Cerca CMS, contenitore web, integrazione nativa e processo dei pagamenti; segna chi genera Purchase, la condizione di attivazione, la destinazione e l'origine della chiave.

Per ciascuna sorgente annota anche la definizione di acquisto. Ordine creato, pagamento autorizzato e pagamento acquisito possono essere momenti differenti nel tuo processo. Se browser e server rappresentano due momenti diversi, condividere una chiave senza chiarire la definizione nasconde il problema. Decidi con l'azienda quale fatto alimenta l'ottimizzazione, poi allinea i sistemi a quella scelta.

2. Controlla la chiave lungo il percorso

Simo Ahava evidenzia un'insidia delle variabili GTM: un valore casuale può essere rivalutato quando viene richiamato. Due tag che leggono una variabile Random Number non costituiscono quindi un contratto di identità. La sua soluzione pratica è fissare l'ID nell'evento dataLayer e farlo leggere ai due percorsi. Nel server confronta poi Event Data e richiesta CAPI: la presenza nel browser non dimostra l'arrivo a destinazione.

Nel nostro registro di verifica metteremmo cinque colonne: chiave aziendale, ID generato, ID browser, ID server, esito. Se una colonna è vuota, risolviamo quel passaggio prima di intervenire sui report. Verifica inoltre che un trasformatore, un plugin o un tag personalizzato non aggiunga un prefisso soltanto a una delle copie. Anche due valori apparentemente simili rimangono due stringhe diverse.

Esempio operativo: il webhook arriva due volte

Immagina l'ordine di test C-842, da 120 euro. Il backend gli assegna la chiave opaca evt_842_purchase. La pagina di conferma riceve quella chiave e la usa per il Pixel; il processo server usa la stessa chiave per Purchase. Il provider di pagamento ripete poi il webhook perché non ha ricevuto tempestivamente una conferma. Il tuo sistema ritrova l'ordine, riconosce che sta trattando lo stesso fatto e mantiene l'identificatore.

Ora immagina l'errore: a ogni webhook il processo genera un UUID nuovo. La seconda richiesta appare tecnicamente ben formata, ma l'identità dell'azione è cambiata. La correzione si trova nel registro degli eventi e nella gestione dei tentativi, non nella creatività. Questo esempio non rappresenta un cliente o un risultato Connectd: serve a mostrare dove collocare il controllo.

3. Collauda i casi che rompono la misurazione

Nella guida CAPI, Stape distingue il test browser da quello server: Pixel Helper non basta per osservare le richieste CAPI. Usa il test event code nel percorso server e confronta i parametri ricevuti nello strumento di test Meta. Quando il tag fallisce, la richiesta in uscita del Preview server aiuta a individuare l'errore concreto.

Esegui i test con una checklist ripetibile. Conserva solo le informazioni necessarie a ricostruire l'esito, evitando di riversare dati personali nei log.

  • Ordine completato: confronta nome, identificatore, valore e valuta nelle due copie.
  • Ricarica della conferma: verifica che non venga creata una nuova identità per lo stesso acquisto.
  • Webhook ripetuto: controlla il registro dei tentativi e l'idempotenza del processo.
  • Secondo ordine: accertati che riceva una chiave diversa dal primo.
  • Invio assente su uno dei percorsi: documenta la causa e verifica il comportamento previsto rispetto alle preferenze dell'utente.

4. Separa ricezione, deduplicazione e attribuzione

Sono tre verifiche distinte. Prima dimostri che le richieste partono e vengono ricevute. Poi controlli che le copie della stessa azione siano riconosciute correttamente. Infine analizzi quali risultati vengono attribuiti alle campagne. Confrontare direttamente il numero degli ordini del gestionale con una colonna pubblicitaria, senza definire periodo e perimetro, mescola problemi diversi.

Prima del rilascio, separa configurazione di prova e produzione. Rimuovi gli strumenti temporanei che alterano il flusso, annota la versione pubblicata e ripeti un ordine controllato. Consegnare soltanto uno screenshot di eventi ricevuti lascia aperta la domanda principale: quelle richieste descrivono una sola vendita oppure due vendite reali? Il registro dell'identità serve a rispondere senza interpretazioni.

Fonti e approfondimenti

Riferimenti citati nella guida. Gli esempi numerici sono illustrativi.