Come progettare un dataLayer pulito e usare dataLayer.push() per eventi GTM scalabili
Usa questa guida quando devi progettare un dataLayer pulito e usare dataLayer.push() per eventi GTM scalabili. L obiettivo e arrivare a un risultato verificabile, non fermarsi alla schermata di configurazione.
Tieni separati ambiente di test e traffico ordinario. Ti serve una prova riconoscibile, ripetibile e facile da ritrovare nel report.
Prerequisiti. Servono mappa eventi, sviluppatore o accesso al codice/plugin, GTM e convenzione parametri.
- event name stabile
- parametri documentati
- push dopo azione reale
- custom event trigger
- debug GTM
Prima di modificare tag o impostazioni, verifica di essere nell account corretto. Il test deve usare lo stesso dominio, stream o container che userai quando la configurazione sara pubblicata.
Configurazione passo passo. Segui i passaggi nell ordine indicato e verifica ogni salvataggio prima di passare al successivo.
Passo 1: definisci evento e scopo
Apri Google Tag Manager > Area di lavoro e confronta selettore Account e Container in alto a sinistra 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: stabilisci parametri minimi
Entra in menu laterale Tags, pulsante New, riquadro Tag Configuration e riquadro Triggering e crea o modifica tag, trigger o evento, 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 tag, trigger o evento.
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: implementa dataLayer.push nel punto corretto
Compila nome tag, tipo tag, ID di misurazione o ID conversione, nome evento, parametri evento e trigger copiando i valori da pannello Admin dello strumento sorgente o schermata di configurazione della conversione. 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 nome tag, tipo tag, ID di misurazione o ID conversione, nome evento, parametri evento e trigger nel posto corretto.
Se un valore non torna, non riscriverlo a memoria: riapri il pannello Tag Configuration, correggi campo e valore, salva e rilancia Preview.
Passo 4: crea variabili dataLayer in GTM
Apri pulsante Preview in alto a destra, campo URL del sito e pulsante Connect di Tag Assistant, 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 tag fired, evento nella timeline, parametri valorizzati e trigger 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: collega trigger e tag
Apri report dello strumento collegato e usa filtro per nome evento, URL pagina, ora del test o ID transazione 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 filtro per nome evento, URL pagina, ora del test o ID transazione, 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.
Il nome evento deve descrivere l azione reale, non il tool che la misura.
Debug e validazione. In GTM Preview controlla ordine degli eventi, valori parametri e trigger attivati.
- push nel momento corretto: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- parametri presenti: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- variabili valorizzate: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- trigger non troppo largo: verifica il punto nella preview e poi nel report finale. Se non compare, torna al passaggio collegato e ripeti il test.
- documentazione aggiornata: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
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 Tag Assistant / Anteprima GTM, 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.
Se trovi un errore, correggi una sola impostazione alla volta e ripeti il test. In questo modo puoi capire quale modifica ha risolto il problema.
Checklist finale prima di considerare chiuso il lavoro.
- schema evento scritto
- push implementato
- variabili create
- tag testati
- versione GTM documentata
Conserva una nota con data del test, pagina usata, evento generato, schermata di debug e report in cui hai verificato il risultato.
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
