Le variabili GTM sono contenitori di valori che il gestore di tag utilizza per popolare dinamicamente i tag, i trigger e le attivazioni. In pratica, una variabile è un’astrazione che sostituisce un dato concreto — un identificatore di misurazione, un indirizzo di pagina, un valore letto da un cookie — con un nome simbolico riutilizzabile. Quando un tag viene attivato, il gestore risolve il nome della variabile nel valore corrente al momento dell’evento, evitando di inserire il dato fisso in ogni configurazione.
Questa architettura rende la configurazione più manutenibile e meno soggetta a errori. Se l’identificatore di misurazione cambia, si aggiorna una sola variabile invece di decine di tag. Le variabili possono essere definite dall’utente oppure generate automaticamente dal sistema, e possono combinarsi tra loro per costruire valori complessi. Comprendere come funzionano è fondamentale per chiunque gestisca una configurazione di tracciamento non banale.
Che cosa sono le variabili GTM
In Google Tag Manager una variabile rappresenta un valore che viene letto nel momento in cui serve, non nel momento in cui viene configurata. Il gestore mette a disposizione un insieme di variabili incorporate, già pronte all’uso, che espongono informazioni sul contesto della pagina: l’indirizzo completo, il percorso, il titolo del documento, il referrer, il tipo di evento e così via. A queste si affiancano le variabili definite dall’utente, create manualmente per estrarre dati da cookie, elementi della pagina, parametri di query o livelli dati.
Ogni variabile ha un tipo, che determina come il valore viene ottenuto. Il tipo non è un dettaglio tecnico trascurabile: scegliere il tipo sbagliato produce valori vuoti o errati, e di conseguenza tag che non funzionano. La variabile non conserva un valore permanente, ma lo calcola ogni volta che viene richiesta, così da riflettere sempre lo stato corrente della pagina o dell’evento.
Tipi di variabile più utilizzati
La classificazione delle variabili segue la loro origine. Le variabili incorporate dipendono dal contesto di navigazione; quelle definite dall’utente dipendono da ciò che il gestore riesce a leggere o da ciò che gli viene fornito. La tabella seguente riassume le tipologie ricorrenti e il loro impiego tipico.
| Tipo di variabile | Origine del valore | Uso tipico |
|---|---|---|
| Incorporata di pagina | Contesto di navigazione | Indirizzo, percorso, titolo, referrer |
| Livello dati | Oggetto dati fornito dalla pagina | Valori applicativi, identificatori utente |
| Cookie di prima parte | Cookie leggibile sul dominio | Stato di consenso, preferenze |
| Elemento del documento | Contenuto di un nodo della pagina | Testi, attributi, valori di form |
| Costante | Valore inserito manualmente | Identificatori fissi riutilizzabili |
Variabili incorporate
Le variabili incorporate sono fornite direttamente dalla piattaforma e non richiedono configurazione. Espongono dati già noti al gestore, come l’indirizzo della pagina, il percorso, il titolo del documento, il referrer e il tipo di evento in corso. Sono utili per costruire trigger basati sull’indirizzo o per passare informazioni di contesto ai tag.
Variabili definite dall’utente
Le variabili definite dall’utente vengono create manualmente e rappresentano la maggior parte del lavoro di configurazione. Possono leggere un valore da un cookie, da un elemento della pagina, da un parametro di query oppure da una chiave del livello dati. Una variabile di questo tipo può anche combinare più valori in una stringa, oppure eseguire una trasformazione su un valore già disponibile.
Come si creano e si richiamano
La creazione di una variabile avviene nell’area dedicata del contenitore. Si assegna un nome descrittivo, si sceglie il tipo e si compilano i parametri richiesti. Il nome è ciò che rende la variabile richiamabile altrove: nei campi dei tag e dei trigger compare un selettore che permette di inserire il riferimento alla variabile al posto di un valore fisso. Il gestore sostituisce automaticamente il riferimento con il valore risolto al momento dell’esecuzione.
È buona pratica adottare una convenzione di denominazione coerente, per esempio un prefisso che distingua le variabili di livello dati da quelle di pagina. Una nomenclatura chiara riduce il rischio di confondere variabili simili e semplifica la manutenzione quando il contenitore cresce. Vale anche la pena documentare, nella descrizione della variabile, da dove proviene il valore e a cosa serve.
Ambito di visibilità
Le variabili definite in un contenitore sono visibili a tutti i tag e i trigger di quel contenitore. Non esiste un ambito più ristretto per singolo tag, ma la risoluzione avviene sempre al momento dell’evento. Questo significa che una variabile che legge un elemento della pagina può restituire un valore vuoto se l’elemento non è ancora presente quando il tag viene attivato.
Errori comuni e buone pratiche
Molti problemi di tracciamento derivano da variabili configurate in modo impreciso. Un errore frequente è leggere un valore dal livello dati prima che la pagina lo abbia popolato, ottenendo un risultato vuoto. Un altro è usare un tipo di variabile non adatto alla fonte del dato, per esempio tentare di leggere un cookie con una variabile pensata per gli elementi della pagina. Anche i nomi ambigui o duplicati generano confusione e rendono difficile capire quale variabile stia alimentando un tag.
Per limitare questi rischi conviene seguire alcune regole operative. La lista seguente riassume le pratiche più diffuse.
- Assegna nomi descrittivi e coerenti, con un prefisso che indichi la fonte del valore.
- Verifica sempre il valore risolto usando la modalità di anteprima prima di pubblicare.
- Controlla che il livello dati sia popolato prima dell’attivazione del tag che lo legge.
- Preferisci una variabile riutilizzabile a un valore fisso ripetuto in più tag.
- Documenta nella descrizione la fonte del dato e lo scopo della variabile.
- Evita di creare variabili duplicate che leggono lo stesso valore con nomi diversi.
- Rivedi periodicamente le variabili inutilizzate e rimuovile per mantenere ordine.
- Testa il comportamento delle variabili dopo ogni modifica rilevante alla pagina.
Domande frequenti
Che differenza c’è tra una variabile e un trigger?
Una variabile fornisce un valore da usare, mentre un trigger stabilisce quando un tag deve essere attivato. Sono strumenti complementari: spesso un trigger si basa sul valore restituito da una variabile per decidere se l’attivazione deve avvenire.
Posso usare la stessa variabile in più tag?
Sì, una variabile definita in un contenitore è disponibile a tutti i tag e i trigger dello stesso contenitore. Il riutilizzo è anzi una delle ragioni principali per cui conviene creare variabili invece di inserire valori fissi.
Perché una variabile restituisce un valore vuoto?
Le cause più comuni sono la fonte del dato non ancora disponibile al momento dell’attivazione, un tipo di variabile non adatto oppure un nome errato nel riferimento. La modalità di anteprima aiuta a individuare rapidamente il problema.
Le variabili consumano prestazioni della pagina?
Il calcolo avviene solo quando una variabile viene richiesta, non in modo continuo. L’impatto è in genere trascurabile, ma un numero molto elevato di variabili complesse può incidere marginalmente sul tempo di esecuzione.
Posso modificare una variabile dopo la pubblicazione?
Sì, le variabili possono essere modificate in qualsiasi momento, ma le modifiche hanno effetto solo dopo la pubblicazione della nuova versione del contenitore. Fino a quel momento resta attiva la versione precedente.
Le variabili sono condivise tra contenitori diversi?
No, ogni contenitore ha il proprio insieme di variabili. Per riutilizzare una configurazione tra contenitori occorre replicarla manualmente oppure ricorrere agli strumenti di esportazione e importazione messi a disposizione dalla piattaforma.
Hai questo problema?Le variabili GTM non si popolano correttamente e perdi il valore delle conversioni?Senza variabili GTM ben configurate, i dati di conversione non arrivano a Google Ads e le campagne restano cieche. Configuriamo GA4, GTM e conversioni avanzate per tracciare ogni azione e ottimizzare il ROI.Scopri il tracciamento conversioni