Avete installato Google Tag Manager, creato i primi tag e collegato GA4, ma appena provate a tracciare qualcosa di più di un clic su un pulsante vi scontrate con la stessa domanda: da dove prendo il valore dell’ordine, la categoria della pagina o il tipo di utente? La risposta è il data layer Google Tag Manager: l’oggetto JavaScript che fa da ponte tra il vostro sito e i tag, e che trasforma un tracciamento fragile, basato sul codice HTML della pagina, in un sistema ordinato e prevedibile.
In questa guida pratica al data layer di Google Tag Manager vediamo cos’è, come è fatto, come implementarlo con dataLayer.push(), come leggerne i valori con le variabili data layer e come testarlo prima di pubblicare. È il tassello che completa la nostra guida a Google Tag Manager: lì trovate account, contenitore e primi tag, qui ci concentriamo solo su come strutturare i dati che i tag useranno. L’articolo fa parte della categoria Data Tracking.
Cos’è il data layer in Google Tag Manager e perché vi serve
Secondo la documentazione ufficiale di Google, il Data Layer è un oggetto usato da Google Tag Manager e da gtag.js per passare informazioni ai tag. Attraverso il data layer potete inviare eventi o variabili e impostare attivatori basati sui valori di quelle variabili. In pratica è un array JavaScript, chiamato per convenzione dataLayer, in cui il sito “deposita” messaggi strutturati che GTM legge e usa.
Perché non basta leggere le informazioni direttamente dalla pagina? Perché il codice HTML cambia. Se un tag recupera il prezzo di un prodotto da un elemento della pagina con un selettore CSS, basta un restyling, un cambio di tema o un nuovo plugin per rompere il tracciamento senza che nessuno se ne accorga. Google lo dice in modo esplicito: i tag sono pensati per leggere informazioni aggiunte al data layer in modo organizzato e prevedibile, invece di analizzare variabili, dati di transazione e categorie sparsi nella pagina.
Il data layer separa quindi due responsabilità:
- il sito (o lo sviluppatore) si impegna a pubblicare certi dati, con nomi e formati concordati;
- Google Tag Manager (o il marketer) decide quali tag attivare e dove inviare quei dati, senza toccare il codice del sito.
Questa separazione è il vero vantaggio. Una volta che il data layer espone, per esempio, il tipo di pagina, lo stato di login e il valore del carrello, potete usare quelle informazioni per GA4, Google Ads, Meta o qualsiasi altro strumento, oggi e in futuro, senza chiedere ogni volta una modifica al team di sviluppo.
Quando vi serve davvero un data layer strutturato? Quasi sempre, appena andate oltre le pagine viste. I casi tipici sono:
- tracciare eventi e conversioni in GA4 che non corrispondono a un semplice clic, come l’invio riuscito di un modulo validato lato server;
- inviare dati di business che non sono visibili nella pagina, come il margine, l’ID cliente interno o il tipo di abbonamento;
- gestire siti costruiti con framework JavaScript, dove il contenuto cambia senza ricaricare la pagina;
- alimentare in modo coerente più piattaforme pubblicitarie con gli stessi dati.
Come funziona il data layer: struttura, chiavi ed eventi

Il data layer è strutturato come un oggetto in formato JSON: coppie di chiave e valore, che possono contenere testi, numeri, array e oggetti annidati. Ogni volta che il sito esegue un dataLayer.push(), aggiunge un “messaggio” all’array. Un messaggio può contenere solo variabili, solo un evento o entrambi.
dataLayer.push({
'event': 'newsletter_signup',
'formLocation': 'footer',
'userType': 'guest'
});
La chiave speciale event
Tra tutte le chiavi, una ha un ruolo particolare: event. Google Tag Manager usa questa variabile speciale per far partire gli attivatori. Un push senza event aggiorna i dati disponibili, ma non attiva nulla da solo; un push con event invece segnala a GTM che “è successo qualcosa” e che deve valutare gli attivatori collegati a quel nome. Il nome dell’evento è una stringa libera che descrive l’azione, per esempio login, purchase o search.
L’ordine di elaborazione dei messaggi
Quando il contenitore viene caricato, GTM elabora tutti i messaggi in coda secondo la logica first-in, first-out: uno alla volta, nell’ordine in cui sono arrivati. Se il messaggio è un evento, tutti i tag con le condizioni di attivazione soddisfatte vengono attivati prima che GTM passi al messaggio successivo.
C’è un dettaglio importante che la documentazione sottolinea: un push eseguito dal codice della pagina, da un modello personalizzato o da un tag HTML personalizzato viene messo in coda ed elaborato dopo i messaggi già in attesa. I valori aggiornati, quindi, non sono garantiti per l’evento immediatamente successivo. La soluzione consigliata da Google è aggiungere sempre un nome di evento al push e ascoltare quell’evento con un attivatore di tipo evento personalizzato.
Sovrascrittura e durata dei valori
Due regole da tenere a mente fin da subito:
- se inviate una variabile con lo stesso nome di una già presente, il nuovo valore sovrascrive quello esistente;
- ogni variabile resta disponibile solo finché l’utente rimane sulla pagina corrente. Al caricamento successivo il data layer riparte da zero: i dati che servono su più pagine, come il tipo di visitatore, vanno inviati di nuovo a ogni caricamento.
Da qui nasce la necessità di una convenzione di nomi coerente. Se nella pagina di registrazione chiamate la categoria pageCategory, dovete usare pageCategory anche nelle pagine prodotto e nel checkout. Non serve inviare le stesse variabili ovunque, ma quelle che inviate devono avere sempre lo stesso nome.
Come implementare il data layer: inizializzazione e dataLayer.push

L’implementazione del data layer GTM si fa in due momenti distinti: l’inizializzazione, una sola volta per pagina, e i push successivi, ogni volta che volete comunicare un dato o un evento.
1. Inizializzare il data layer prima del contenitore
Per le installazioni web di GTM il data layer va creato prima che il contenitore venga caricato, il più in alto possibile nel codice della pagina. La riga da usare è sempre la stessa:
<script>
window.dataLayer = window.dataLayer || [];
</script>
<!-- Google Tag Manager -->
... snippet del contenitore GTM-XXXXXX ...
<!-- End Google Tag Manager -->
La forma window.dataLayer || [] non è un vezzo stilistico: se il data layer esiste già, perché creato da un plugin, da un CMP o dal tag Google, viene riutilizzato; se non esiste, viene creato vuoto. Scrivere invece dataLayer = [ ... ] cancella tutto ciò che era stato inserito prima, ed è uno degli errori più frequenti che troviamo negli audit.
2. Inviare i dati di pagina sopra lo snippet
I dati che descrivono la pagina e l’utente, e che volete disponibili già al caricamento del contenitore, vanno inviati con un push posizionato sopra lo snippet di GTM:
<script>
window.dataLayer = window.dataLayer || [];
dataLayer.push({
'pageType': 'product',
'pageCategory': 'scarpe-running',
'userLoggedIn': true,
'userType': 'returning_customer'
});
</script>
<!-- Google Tag Manager -->
In questo modo, quando GTM attiva il tag di configurazione di GA4 sulla visualizzazione di pagina, i valori di pageType e userType sono già leggibili e potete inviarli come parametri o proprietà utente.
3. Inviare eventi quando l’utente fa qualcosa
Per le interazioni il push avviene nel momento in cui l’azione si verifica, di solito nel codice JavaScript che gestisce il modulo o il pulsante. Google mostra anche la variante più semplice, direttamente nell’attributo onclick, utile per capire il meccanismo:
<button onclick="dataLayer.push({'event': 'login'});">Accedi</button>
Nella pratica conviene che il push parta solo quando l’azione è andata a buon fine, per esempio dopo la risposta positiva del server alla registrazione, non al semplice clic sul pulsante. È la differenza tra contare i tentativi e contare i risultati.
// dopo la conferma del server
dataLayer.push({
'event': 'sign_up',
'method': 'email',
'plan': 'free'
});
Le regole di sintassi da non dimenticare
- Maiuscole e minuscole contano:
datalayer.push()non funziona, il nome corretto èdataLayer, con la L maiuscola. - Nomi delle chiavi tra virgolette: un nome come
new-variablesenza virgolette non è JavaScript valido e il push fallisce. - Un solo data layer per pagina: GTM e gtag.js si appoggiano a un unico array globale. Più istanze, o una reinizializzazione dopo il caricamento di GTM, portano a tag che non partono e dati incompleti.
Se il nome dataLayer entra in conflitto con altro codice del sito, potete rinominarlo modificando il parametro nello snippet del contenitore (Google usa l’esempio myNewName). In quel caso, però, ogni riferimento, dall’inizializzazione a tutti i push, deve usare il nuovo nome. È un’operazione che consigliamo solo quando strettamente necessaria.
Variabili data layer e attivatori in GTM: leggere e usare i dati

Inviare i dati è metà del lavoro. Perché i tag possano usarli, in Google Tag Manager dovete creare una variabile di livello dati (Data Layer Variable) per ogni chiave che vi interessa. La variabile restituisce il valore inserito nel data layer con dataLayer.push().
Creare una variabile data layer
- Andate in Variabili e, nella sezione delle variabili definite dall’utente, cliccate su Nuova.
- Scegliete il tipo Variabile di livello dati.
- Nel campo del nome inserite la chiave esattamente come compare nel push, per esempio
userType. - Lasciate la versione del livello dati su Versione 2, salvo casi particolari.
- Date alla variabile un nome leggibile, per esempio
DLV - userType, e salvate.
Versione 1 e versione 2: la notazione con il punto
La scelta della versione cambia il modo in cui GTM interpreta i punti nel nome della chiave. Con la versione 1 il punto fa parte del nome: a.b.c è una singola chiave. Con la versione 2 il punto indica un livello di annidamento: a.b.c diventa {a: {b: {c: "valore"}}}. La versione 2 vi permette quindi di leggere valori dentro oggetti strutturati:
dataLayer.push({
'event': 'lead_submit',
'form': {
'id': 'contatti-b2b',
'step': 2
},
'user': {
'type': 'prospect'
}
});
Con il push qui sopra, una variabile data layer con nome form.id restituisce contatti-b2b, mentre user.type restituisce prospect. Raggruppare i dati in oggetti come page, user e form rende lo schema più leggibile e riduce il rischio di nomi duplicati.
Attivatori basati sugli eventi del data layer
Per far partire un tag quando arriva un push con event, si usa l’attivatore Evento personalizzato: in Attivatori, Nuovo, scegliete questo tipo e inserite il nome dell’evento, identico a quello del push (lead_submit nell’esempio). Se volete un solo attivatore per più eventi, potete selezionare l’opzione per usare le espressioni regolari e indicare un elenco come lead_submit|sign_up|login.
Le variabili data layer servono anche a restringere l’attivazione: potete far partire un tag solo se DLV - userType è uguale a returning_customer, oppure, come nell’esempio di Google, solo se il valore di un acquisto supera una certa soglia. Infine, le stesse variabili si usano come valori dei parametri nei tag: nel tag evento di GA4 potete associare il parametro form_id alla variabile {{DLV - form.id}}. Ricordate che per vederlo nei report di GA4 il parametro va registrato come dimensione personalizzata, come spieghiamo nella guida agli Eventi GA4.
Una nota sulle campagne: i parametri UTM non vanno ricopiati nel data layer, perché GA4 li legge già dall’URL di atterraggio. Se volete approfondire come costruirli correttamente, trovate tutto nella guida ai parametri UTM.
Datalayer ecommerce: la struttura per prodotti e acquisti

Il caso d’uso più diffuso del data layer è il commercio elettronico. Qui la libertà sui nomi finisce: per GA4 Google definisce una struttura precisa, con un oggetto ecommerce che contiene i parametri dell’evento (valuta, valore, ID transazione) e un array items con i prodotti. Se rispettate quella struttura, il tag evento GA4 in GTM può leggere i dati e-commerce direttamente dal data layer, senza creare una variabile per ogni campo.
Lo schema di un datalayer ecommerce per l’aggiunta al carrello, in forma ridotta, è questo:
dataLayer.push({ 'ecommerce': null }); // azzera l'oggetto ecommerce precedente
dataLayer.push({
'event': 'add_to_cart',
'ecommerce': {
'currency': 'EUR',
'value': 59.90,
'items': [{
'item_id': 'SKU_1234',
'item_name': 'Scarpa running uomo',
'price': 59.90,
'quantity': 1
}]
}
});
Due cose da notare, che valgono anche per il resto della guida. Primo: il push di azzeramento { ecommerce: null } prima di ogni evento e-commerce, che Google consiglia per evitare che i dati di un evento si mescolino con quelli del precedente, proprio per la regola di sovrascrittura e unione dei valori vista sopra. Secondo: anche qui la chiave event è ciò che permette all’attivatore di partire.
Non entriamo oltre nel dettaglio, perché l’elenco completo degli eventi (da view_item_list a refund), la configurazione del tag con l’opzione per inviare i dati e-commerce e la verifica nei report sono già trattati passo passo nella nostra guida all’e-commerce in GA4. Se gestite un negozio online, partite da lì dopo aver letto questo articolo. Trovate altri approfondimenti sul tema sotto il tag E-commerce.
Testare il data layer con l’Anteprima di GTM e Tag Assistant

Un data layer non testato è un data layer che, prima o poi, mente. Prima di pubblicare qualsiasi modifica al contenitore, e ogni volta che gli sviluppatori rilasciano una nuova versione del sito, conviene verificare che i push arrivino con i nomi e i valori attesi. Google indica Tag Assistant come lo strumento per ispezionare lo stato del data layer in qualsiasi punto della sequenza di eventi.
Il flusso di verifica che usiamo
- In GTM cliccate su Anteprima: si apre Tag Assistant collegato al vostro sito.
- Navigate e compiete le azioni da testare: visualizzare un prodotto, inviare il modulo, completare la registrazione.
- Nella colonna di sinistra selezionate l’evento che vi interessa e aprite la scheda dedicata al Data Layer: vedete il messaggio esatto inviato con il push e lo stato complessivo del data layer in quel momento.
- Controllate la scheda delle Variabili: le vostre variabili data layer devono restituire il valore atteso, non
undefined. - Verificate nella scheda dei Tag che i tag giusti siano partiti su quell’evento e non su altri.
Per un controllo rapido senza GTM potete anche aprire la console degli strumenti per sviluppatori del browser e digitare dataLayer: vedrete l’array con tutti i messaggi inviati fino a quel momento, nell’ordine in cui sono arrivati. È utile per capire se un push manca del tutto o se arriva con un nome diverso da quello previsto.
Cosa cercare durante il test
- Nomi identici:
userTypeeuser_typeper GTM sono due chiavi diverse. - Tipi di dato corretti: un valore economico inviato come testo, magari con la virgola decimale all’italiana, può creare problemi negli strumenti che si aspettano un numero.
- Tempistica: se una variabile risulta vuota sull’evento di visualizzazione della pagina ma piena su un evento successivo, probabilmente il push è stato inserito sotto lo snippet invece che sopra.
- Duplicati: lo stesso evento inviato due volte, spesso da un plugin e da codice personalizzato insieme, raddoppia le conversioni.
Quando i dati partono anche verso un contenitore server, vale la pena ripetere il controllo anche lì: nella guida a GTM server-side trovate come usare l’anteprima del contenitore server per seguire la richiesta dal browser fino alle piattaforme di destinazione.
Come strutturare il data layer: best practice ed errori da evitare

La parte tecnica del data layer è semplice. La parte difficile è organizzativa: decidere cosa inviare, con quali nomi, e mantenere quella decisione nel tempo mentre il sito cambia. Ecco le regole che applichiamo nei nostri progetti.
Partite da un piano di tracciamento scritto
Prima di scrivere una riga di codice, preparate un documento condiviso tra marketing e sviluppo con, per ogni evento: nome, momento esatto in cui parte, chiavi inviate, tipo di dato ed esempio di valore. Lo stesso documento diventa la specifica per gli sviluppatori e la checklist per i test. Senza un piano scritto, il data layer cresce per aggiunte successive e dopo un anno nessuno sa più quali chiavi siano affidabili.
Scegliete una convenzione di nomi e rispettatela
Che usiate camelCase o snake_case conta poco; conta usare sempre la stessa. Un buon compromesso, molto diffuso, è usare per gli eventi i nomi consigliati da GA4 in snake_case (sign_up, generate_lead, purchase) e mantenere quella stessa forma anche per le chiavi personalizzate. Evitate nomi generici come value o type al primo livello, che rischiano di essere sovrascritti da altri push: meglio raggrupparli in oggetti come page, user o form.
Non inviate dati personali
Il data layer è leggibile da chiunque apra la console del browser e da tutti i tag del contenitore. Non inserite email, numeri di telefono, nomi o indirizzi in chiaro: oltre ai rischi in termini di cookie e GDPR, le norme di Google Analytics vietano di inviare informazioni che identificano personalmente l’utente. Se vi serve un identificativo, usate un ID interno non riconducibile direttamente alla persona.
Coordinate data layer e consenso
Il data layer trasporta i dati, ma non decide se possono essere usati. Lo stato del consenso va gestito con le API di consenso di Tag Manager e con la Consent Mode V2: Google sconsiglia espressamente di configurare il consenso tramite tag HTML personalizzati, perché le impostazioni devono essere applicate prima che partano gli altri tag. Archivio completo sul tema nel tag Consent Mode V2.
Attenzione alle pagine che non si ricaricano
Nelle applicazioni a pagina singola il data layer non si azzera tra una “pagina” e l’altra, perché il browser non ricarica il documento. Inviate un evento dedicato a ogni cambio di vista con i nuovi dati di pagina, e valutate la funzione reset che Google mette a disposizione tramite i metodi personalizzati del data layer, pensata proprio per le pagine che restano aperte a lungo e il cui data layer continua a crescere:
window.dataLayer.push(function() {
this.reset();
});
Gli errori che vediamo più spesso
- Data layer inizializzato con
dataLayer = []sotto lo snippet, che cancella i messaggi già inviati. - Push dei dati di pagina posizionati dopo il contenitore, con variabili vuote sulla visualizzazione di pagina.
- Nomi diversi per lo stesso concetto su pagine diverse.
- Eventi inviati al clic invece che alla conferma dell’azione.
- Più data layer sulla stessa pagina, spesso introdotti da plugin diversi.
- Nessun test dopo i rilasci del sito, con tracciamenti rotti scoperti settimane dopo nei report.
Un data layer ben progettato è l’investimento più redditizio che potete fare sul tracciamento: rende i tag più semplici, i dati più affidabili e il passaggio a nuovi strumenti, compreso il tracciamento server-side, molto meno doloroso. Trovate le altre guide sullo strumento nell’archivio del tag Google Tag Manager e gli approfondimenti sulla configurazione lato server sotto il tag GTM Server-Side.



