Come configurare Meta Conversions API con server-side GTM e deduplicare gli eventi con event_id
Se devi configurare Meta Conversions API con server-side GTM e deduplicare gli eventi con event_id, usa questa sequenza come checklist esecutiva: ogni passaggio produce qualcosa che puoi controllare subito.
Tieni aperti gli strumenti indicati nei prerequisiti e lavora su una pagina di test. Alla fine devi poter verificare event_name identico e completare testa deduplica in Events Manager.
Prerequisiti. Servono Pixel Meta, business manager, dataset/event manager, container web, container server e una origine controllata per event_id.
- Pixel installato via GTM
- server container raggiungibile
- token accesso Meta
- event_id generato lato browser o backend
- consenso marketing gestito
Apri una finestra pulita del browser e tieni pronta la pagina dove generare l evento. In questo modo puoi distinguere il test appena creato da traffico precedente.
Procedura operativa. Lavora in sequenza: prima imposti, poi provi, poi controlli il dato ricevuto.
Passo 1: crea event_id unico per conversione
Apri Meta Events Manager > Origini dati e GTM > Tag e confronta dataset Meta corretto in Events Manager e container GTM collegato allo stesso dominio prima di fare modifiche: se parti da account, property, stream, dataset o container sbagliato, il test non vale.
Clicca sul selettore principale, apri la voce corretta e confronta dominio, nome property, ID stream o container con il sito da misurare. Se uno di questi dati non coincide, fermati e cambia risorsa.
A questo punto devi avere la risorsa giusta aperta, i permessi necessari e la schermata da cui prenderai i valori gia identificata.
Se account, property o container non sono quelli corretti, torna al selettore principale e cambiali prima di modificare qualsiasi cosa.
Passo 2: invialo al Pixel browser
Entra in Meta Events Manager > Data sources > dataset > Test events, poi GTM Tags > New per Pixel o tag server e crea o modifica evento Meta, event_name, event_id e parametri utente, usando un nome che descriva azione, strumento e pagina coinvolta.
Clicca il pulsante di creazione o modifica, scegli il tipo richiesto dalla guida, apri il riquadro di configurazione e collega il trigger, l evento o la regola che deve far partire il dato.
Il risultato da ottenere e una configurazione salvata, leggibile e agganciata alla condizione che deve far partire evento Meta, event_name, event_id e parametri utente.
Se il trigger o la regola e troppo generica, apri la condizione e restringila a URL, evento dataLayer, consenso, form riuscito, checkout o acquisto completato.
Passo 3: inoltra lo stesso evento al server container
Compila Pixel ID o dataset ID, event_name, event_id condiviso, action_source, event_source_url e parametri user_data consentiti copiando i valori da Meta Events Manager, pannello Settings/Data sources e variabili GTM del dataLayer. Non accorciare ID, label o nomi evento e non cambiare mai formato mentre li incolli.
Clicca dentro ogni campo obbligatorio, incolla il valore esatto, rileggilo nel riepilogo e usa Salva solo quando ogni campo ha una provenienza chiara.
Quando rileggi il riepilogo, nessun campo obbligatorio deve essere vuoto: il controllo minimo e vedere Pixel ID o dataset ID, event_name, event_id condiviso, action_source, event_source_url e parametri user_data consentiti nel posto corretto.
Se un valore non torna, non riscriverlo a memoria: se event_id non coincide, torna nelle variabili GTM e nel tag server, riallinea il valore e ripeti lo stesso evento.
Passo 4: configura il tag Meta CAPI server-side
Apri Test events in Meta, Preview in GTM e se presente Preview del server container, completa l azione richiesta sulla pagina di test e segui la sequenza finche vedi cosa parte, quando parte e con quali parametri.
Clicca il pulsante di anteprima o test, inserisci l URL della pagina se richiesto, conferma con Connect o Avvia test e poi esegui una sola volta l azione utente prevista.
Nel debug devi vedere evento browser e server ricevuti con stesso event_id e stato di deduplica corretto; se vedi solo un tag attivo ma mancano parametri o momento corretto, il test non e chiuso.
Se non compare nulla nel debug, controlla prima collegamento Preview/Connect, poi trigger, consenso e pagina usata per generare il test.
Passo 5: testa deduplica in Events Manager
Apri Meta Events Manager > Panoramica eventi e usa event_name, event_id, browser/server, stato deduplicated e ora del test per isolare il test appena fatto, invece di cercarlo dentro tutto il traffico della giornata.
Clicca sul report o pannello finale, applica il filtro piu stretto disponibile e verifica che il dato compaia una sola volta con ora, pagina o nome evento coerenti.
Nel report finale devi ritrovare il test con event_name, event_id, browser/server, stato deduplicated e ora del test, oppure riconoscere chiaramente che lo strumento richiede qualche minuto di elaborazione.
Se il dato non arriva nel report, ripeti il test annotando ora, pagina e azione; poi controlla ritardi di elaborazione, filtro sbagliato o property non corretta.
Non generare un event_id diverso nel server container: deve viaggiare insieme alla conversione.
Debug e validazione. In Events Manager controlla ricezione, deduplica, match quality e warning; in GTM Preview confronta payload browser e server.
- event_name identico: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- event_id identico: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
- value e currency coerenti: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
- user data consentiti e hashati: verifica il punto nella preview e poi nel report finale. Se non compare, torna al passaggio collegato e ripeti il test.
- deduplica visibile in Meta: verifica il punto nella preview e poi nel report finale. Se non compare, torna al passaggio collegato e ripeti il test.
Errori frequenti e come risolverli
Se il tag o l evento non compare nel debug, di solito la preview non e collegata alla pagina giusta, il trigger e troppo stretto oppure il consenso non si aggiorna. Riapri Meta Test Events, GTM Preview e server container se presente, ricollega la pagina e ripeti il test.
Se il dato compare due volte, controlla se hai un doppio tag, un doppio percorso browser/server o un reload della pagina finale. Disattiva il duplicato, ripeti l azione e verifica che nel report resti un solo invio.
Se il report finale resta vuoto, ricontrolla ID, label, stream, dataset o property. Copia di nuovo i valori dalla piattaforma sorgente, salva e ripeti il test annotando ora, URL e azione eseguita.
Quando il debug non torna, non moltiplicare le modifiche. Cambia un punto, salva, rigenera l evento e ricontrolla.
Checklist finale prima di considerare chiuso il lavoro.
- test evento browser
- test evento server
- deduplica confermata
- warning risolti
- confronto con CRM
Prima di usare la configurazione su traffico reale, salva uno screenshot del debug e uno del report in cui il test risulta visibile.
Lunedì – Sabato : 9:30 am – 21:00 pm
Lunedì – Sabato : 9:30 am – 21:00 pm
Studierò la strategia più adeguata per le tue esigenze e insieme al mio staff individueremo la Buyer Personas migliore per trasformare il tuo processo commerciale offline nella più efficace macchina di vendita online, e la strategia di comunicazione più convincente per convincere il pubblico che il tuo prodotto è quello che stanno cercando, anche se costa di più della concorrenza.
Lunedì – Sabato : 9:30 am – 21:00 pm
