Google Tag Assistant: come vedere quali tag si attivano e scoprire cosa li ha rotti

Che cos'è Google Tag Assistant e cosa mostra?

Google Tag Assistant è uno strumento web, su tagassistant.google.com, che verifica e aiuta a risolvere i problemi delle installazioni del tag Google (gtag.js) e di Google Tag Manager, compresi i tag di Google Analytics e Google Ads. Ha sostituito la vecchia modalità di anteprima di Tag Manager, che si basava sui cookie di terze parti, sempre più bloccati dai browser.

In una sola sessione di debug segui l'intero dominio, pagina per pagina, e vedi:

• ogni evento, numerato nell'ordine in cui si è attivato e raggruppato per pagina;
• la chiamata API dietro ogni evento, gtag() oppure dataLayer.push();
• gli hit inviati, con destinazione, tipo e parametri di ciascuno;
• i valori del livello dati, gli eventi di misurazione avanzata di Google Analytics e gli errori.

Per i contenitori di Tag Manager, la vista di debug mostra anche quali tag si sono attivati e quali no a ogni evento, i valori delle variabili e lo stato del consenso quando la modalità di consenso è attiva. Queste informazioni compaiono solo nella tua sessione, mai ai normali visitatori.

Quello che Tag Assistant non ti dà è lo storico. Mostra come si comportano i tag adesso, nel tuo browser. Se un tag ha smesso di attivarsi martedì scorso, devi ancora scoprire cosa è cambiato martedì scorso.

Come avvio una sessione di debug in Tag Assistant?

Parti da tagassistant.google.com per qualsiasi sito con il tag Google, oppure dal pulsante Anteprima di Tag Manager quando vuoi provare modifiche dell'area di lavoro non ancora pubblicate.

Da Tag Assistant

1. Apri tagassistant.google.com e fai clic su "Add domain".
2. Inserisci l'URL del sito, che inizia con https:// o http://.
3. Fai clic su "Connect". Il sito si apre in una nuova finestra con il parametro di debug _dbg nell'URL.
4. Naviga tra le pagine e le azioni da testare. Tag Assistant si aggiorna mentre navighi.

Da Google Tag Manager

1. Apri il contenitore e, nella scheda "Area di lavoro", fai clic su "Anteprima". Tag Assistant si apre in una nuova scheda.
2. Inserisci l'URL del sito e fai clic su "Connetti". Il sito mostra "Collegato" nell'angolo in basso a destra.
3. Torna alla scheda di Tag Assistant e fai clic su "Continua" per aprire l'interfaccia di debug.

Se il parametro di debug rompe il sito, deseleziona "Includi segnale di debug nell'URL" prima di collegarti. Google consiglia l'estensione Tag Assistant per Chrome: permette di fare il debug dei tag dentro gli iframe (possibile solo con l'estensione), dei pop-up, delle nuove schede e di più finestre insieme. Per chiudere, fai clic sulla X in alto a sinistra dell'interfaccia o su "Interrompi debug". Per riprendere una sessione, scegli il dominio in "Active Domains" o "History" nella home di Tag Assistant (la guida di Tag Assistant esiste solo in inglese, per questo alcune etichette restano in inglese).

Come leggo quello che mostra Tag Assistant?

Leggi da sinistra a destra: scegli un evento nella timeline, poi controlla cosa ha inviato e quali tag ha attivato.

La sessione si apre sulla vista "Summary". Se nella pagina ci sono più tag Google o contenitori, scegline uno in alto e gli hit vengono filtrati su quell'ID. La colonna di sinistra è la timeline degli eventi; quelli con l'icona <> sono eventi integrati che il tag Google invia al caricamento.

Un tag in "Tags Fired" non chiude il controllo. Apri l'hit e leggi i parametri: un tag di acquisto che si attiva con valore 0 o senza valuta danneggia le offerte quanto un tag che non si attiva affatto. Tag Assistant avvisa anche quando un evento viene inviato a un prodotto Google senza che prima si sia attivato il tag Google corrispondente.

Perché il mio tag Google non si attiva?

Quasi sempre un tag smette di funzionare per una modifica: al sito, al contenitore, al consenso o al percorso delle pagine. La tabella elenca le cause più comuni e come si presentano.

Alcuni limiti dipendono dallo strumento: le pagine AMP non sono supportate e i tag dentro gli iframe si possono analizzare solo con l'estensione di Chrome. Se il tag Google si carica dopo il tentativo di collegamento di Tag Assistant, fai clic su "Retry". Gli strumenti di consenso possono bloccare i tag Google se non sono configurati per funzionare con l'API di consenso di Google; questo caso ha un articolo dedicato su come provare che il banner del consenso ha fatto calare le conversioni.

Come isolo quale modifica ha rotto il tag?

Tag Assistant ti dice che il tag oggi non funziona. Per capire quale modifica lo ha rotto, trova l'ultimo giorno in cui funzionava e metti in fila tutto ciò che è cambiato quel giorno e subito prima.

1. Trova l'ultimo giorno in cui andava
2. Metti in fila le modifiche prima
3. Testa il sospetto in Tag Assistant
4. Correggi e registra la correzione

Usa i report per trovare la data della rottura: il giorno in cui gli eventi GA4 o le conversioni Google Ads scendono a zero o cambiano livello. Poi raccogli le modifiche di quel periodo: versioni del contenitore pubblicate in Tag Manager (l'elenco delle Versioni mostra quando è stata pubblicata ciascuna e da chi), rilasci del sito, aggiornamenti del CMS o del tema, modifiche al banner del consenso, al checkout o ai moduli. Apri la versione pubblicata più vicina alla rottura e guarda quali tag, attivatori e variabili ha toccato; l'articolo sulla cronologia delle versioni di Google Tag Manager spiega come.

Poi verifica un sospetto alla volta. Metti in anteprima la versione precedente alla rottura e quella attuale, ripeti lo stesso percorso (per esempio l'invio di un modulo di prova) e confronta "Tags Fired" e gli hit. Se la vecchia versione si attiva e la nuova no, la causa è nel contenitore. Se falliscono entrambe, guarda il sito.

Con tutte le modifiche su un'unica timeline, bastano pochi minuti invece di un pomeriggio: vedresti che una versione del contenitore e un rilascio del checkout sono andati online il giorno prima del calo, e testeresti quei due per primi. In Changeline il team registra le modifiche al sito, ai tag e al consenso con data, responsabile e motivo, e le modifiche di Google Ads vengono importate in automatico tramite una connessione in sola lettura, così un problema di tracciamento e una modifica alle offerte della stessa settimana compaiono uno accanto all'altro.

Esempio: un cliente chiede perché i lead di Google Ads sono scesi a zero giovedì. Tag Assistant mostra il tag del modulo in "Tags Not Fired". Sulla timeline di mercoledì ci sono due voci: una versione del contenitore che ha aggiunto un widget di chat e un rilascio del sito che ha rinominato l'evento del modulo da form_submit a lead_submit. Mettendo in anteprima il vecchio contenitore sul sito attuale, il tag continua a fallire, quindi il contenitore non è la causa: l'attivatore aspetta un evento che il sito non invia più. Correggere l'attivatore risolve, e la risposta al cliente sta in una frase con una data. Nomi e numeri sono illustrativi.

Come condivido una sessione di debug o provo una vecchia versione del contenitore?

Puoi passare la sessione di debug a un collega o a uno sviluppatore invece di descrivere il problema via email.

• Condividere l'anteprima dell'area di lavoro: in Tag Assistant fai clic su "Altre azioni" e poi su "Condividi". Nella finestra "Condividi sessione di debug" inserisci il dominio del sito, copia l'URL di anteprima e invialo.
• Mettere in anteprima una vecchia versione: in Tag Manager vai su "Versioni", apri "Altre azioni" sulla versione e scegli "Anteprima", oppure l'opzione per condividere l'anteprima con un'altra persona.
• Esportare la sessione: Tag Assistant permette di esportare e importare le sessioni di debug, così lo sviluppatore apre esattamente quello che hai visto tu.

La modalità di anteprima funziona solo nel browser in cui l'hai attivata o per le persone con cui l'hai condivisa. Provare la versione precedente alla rottura sul sito attuale è il modo più rapido per distinguere un problema del contenitore da un problema del sito.

Come evito che i tag si rompano senza che nessuno se ne accorga al prossimo rilascio?

Tratta il tracciamento come codice: ogni modifica ha un nome, una data e un test.

1. Dai un nome a ogni versione del contenitore. Tag Manager chiede nome e descrizione della versione quando pubblichi, e l'esempio di Google è "GA page view tag - initial launch". Un nome chiaro è il primo indizio quando cercherai una rottura mesi dopo.
2. Usa Tag Assistant dopo ogni rilascio del sito, non solo dopo le modifiche in Tag Manager. Molte rotture arrivano dal sito: una classe rinominata, un template nuovo, un passaggio del checkout spostato.
3. Testa dall'inizio alla fine gli eventi che portano soldi, come acquisto, lead e registrazione, e apri gli hit per controllare valore, valuta e ID transazione.
4. Registra la modifica dove la vede tutto il team, con il motivo e chi l'ha fatta, accanto alle modifiche alle campagne e al sito. Un modello di registro delle modifiche di marketing basta per iniziare, e la guida al registro delle modifiche di marketing spiega cosa annotare.
5. Segna le correzioni del tracciamento nei report. Quando le conversioni tornano dopo una correzione, aggiungi una nota perché nessuno la scambi per un miglioramento delle prestazioni; vedi le annotazioni di GA4.

Se un tag rotto ti è già costato una settimana di conversioni, la guida per spiegare un calo delle conversioni al cliente ti aiuta a presentare data, causa e correzione.