Il tracciamento delle conversioni smette di partire. Il traffico sparisce. Un evento non scatta più. Qualcosa si è rotto ma non sai che cosa. Il debug è il processo per trovare e correggere il problema.
La maggior parte dei problemi di tracciamento ha cause evidenti, una volta che sai dove guardare. Imparare a fare il debug ti fa risparmiare ore di tentativi.
Il processo di debug
Passo 1: conferma che il problema esiste
Il tracciamento è davvero rotto o hai letto male i dati? Controlla più viste. Controlla intervalli di date diversi. Conferma che il problema sia reale e costante.
Passo 2: individua quando è iniziato
Quando si è fermato il tracciamento? Ieri? La settimana scorsa? Riesci a indicare il giorno? Guarda i dati storici. Quando c'è stato il calo? Questo restringe le possibili cause.
Passo 3: controlla se è cambiato qualcosa
Hai rilasciato codice di recente? Cambiato la configurazione? Lanciato una nuova funzione? Le modifiche spesso causano problemi. Che cosa è cambiato nel periodo in cui il tracciamento si è rotto?
Passo 4: usa gli strumenti di debug
Usa la modalità di debug del tuo strumento di statistiche. Usa gli strumenti per sviluppatori del browser. Usa il monitoraggio della rete. Guarda le richieste in tempo reale per vedere dove falliscono.
Passo 5: prova a mano
Crea traffico di prova. Prova la conversione. Prova l'evento. Se la tua prova fa partire il tracciamento ma il traffico reale no, il problema è in produzione. Se nemmeno la prova funziona, il problema è nell'implementazione.
Passo 6: correggi e verifica
Applica la correzione. Prova di nuovo. Verifica che la correzione funzioni prima di dichiarare il lavoro finito.
Problemi di tracciamento comuni e come fare il debug
Il codice di tracciamento non parte
Apri gli strumenti per sviluppatori del browser. Vai alla scheda Network. Cerca le richieste verso il dominio delle tue statistiche. Le vedi? Se no, il codice non parte.
Controlla la console del browser per errori JavaScript. Gli errori impediscono l'esecuzione del codice di tracciamento. Correggi l'errore e il tracciamento partirà.
Il codice di tracciamento si carica ma i dati non compaiono nei report
La richiesta viene inviata (la vedi nella scheda Network) ma non compare nei report. Cause possibili: un firewall che blocca la richiesta, un blocco annunci che la blocca, un ID proprietà sbagliato, un obiettivo di conversione configurato male.
Controlla di tracciare la proprietà giusta. Controlla che nessun filtro escluda i dati di prova. Controlla che il filtro dei bot non catturi la tua prova.
Il tracciamento parte a volte ma non sempre
I problemi intermittenti sono più difficili da risolvere. Possono essere condizioni di concorrenza (il tracciamento parte prima che i dati siano pronti). Possono essere timeout di rete. Possono essere codice condizionale che non viene eseguito sempre.
Guarda il codice. Ci sono condizioni che a volte impediscono la partenza del tracciamento? Ci sono timeout? Il tracciamento avviene nel momento giusto?
Il tracciamento delle conversioni parte ma le conversioni non compaiono
Il codice di tracciamento parte. La richiesta arriva al server. Ma le conversioni non compaiono nei report. Cause possibili: l'obiettivo di conversione non è configurato, l'URL dell'obiettivo non corrisponde alla vera pagina di conversione, l'obiettivo scatta più volte per sessione (contato come uno).
Controlla la configurazione dell'obiettivo di conversione. L'URL corrisponde? L'obiettivo scatta sull'evento giusto? È configurato per contare una volta o più volte?
Il tracciamento degli eventi parte ma i dati sono incompleti
Gli eventi partono ma mancano alcuni parametri. I ricavi risultano 0 $. L'ID prodotto è vuoto. L'evento è tracciato, ma in modo incompleto.
Controlla il tuo codice di tracciamento. I parametri vengono catturati correttamente? Vengono passati alla chiamata di tracciamento? I dati sono disponibili nel momento del tracciamento?
Strumenti per il debug
Strumenti per sviluppatori del browser
Scheda Network: vedi le richieste inviate. Scheda Console: vedi gli errori JavaScript. Entrambe sono essenziali per il debug del tracciamento lato client.
Modalità di debug delle statistiche
La maggior parte degli strumenti ha una modalità di debug. Google Analytics ha DebugView. Le piattaforme di analisi del prodotto hanno una vista degli eventi in diretta. Mostrano gli eventi in tempo reale mentre partono.
Estensioni del browser
Estensioni come Tag Assistant e GA Debugger o altre estensioni di analisi aiutano a ispezionare il codice di tracciamento e a fare il debug dei problemi.
Log del server
I log del server mostrano tutte le richieste, comprese quelle di tracciamento. Controllali per vedere se le richieste di tracciamento arrivano almeno al tuo server.
Prevenire i problemi di tracciamento
Prova prima del rilascio
Non rilasciare in produzione modifiche al codice di tracciamento senza provarle. Prova prima in staging. Verifica che il tracciamento funzioni in staging prima di andare online.
Monitora dopo il rilascio
Dopo un rilascio, monitora per 24 ore. Guarda se ci sono cali di traffico o di conversioni. Trova i problemi in fretta.
Tieni un registro delle modifiche
Documenta ogni modifica che fai al codice di tracciamento. Quando è stata fatta, che cosa è cambiato, perché. Ti aiuta a risalire dai problemi alla loro causa.
Usa il controllo di versione
Tieni il codice di tracciamento in un sistema di controllo di versione. Così puoi confrontare le versioni se qualcosa si rompe. Puoi tornare alla versione precedente se serve.
Domande frequenti
Come faccio a sapere se il mio tracciamento è rotto o se il traffico è solo basso?
Confronta con gli andamenti normali. Se il traffico di solito è in media 1000 e di colpo scende a 100, c'è un problema. Se scende a 800 e quella settimana non hai fatto campagne, probabilmente va tutto bene. Con il creatore di siti di WEMASY puoi impostarlo direttamente sul tuo sito.
Posso fare il debug del tracciamento senza strumenti per sviluppatori?
Non facilmente. Gli strumenti per sviluppatori sono essenziali. Se non ti senti a tuo agio, chiedi aiuto a uno sviluppatore o usa le funzioni di debug integrate nel tuo strumento di statistiche.
Quanto deve durare il debug?
Problemi semplici (ID proprietà sbagliato, obiettivo configurato male): 15-30 minuti. Problemi complessi (condizioni di concorrenza, problemi di rete): 1-4 ore. Se il debug richiede più di un'ora, fatti aiutare da uno sviluppatore.
Che cosa faccio se non trovo il problema?
Documenta quello che hai già controllato. Chiedi aiuto al fornitore delle tue statistiche o a un consulente. A volte un paio d'occhi nuovi vede il problema.
Devo annullare le modifiche se il tracciamento si rompe dopo un rilascio?
Se hai appena rilasciato e il tracciamento si rompe, sì. Torna subito indietro. Poi fai il debug in staging prima di rilasciare di nuovo.
I blocchi annunci possono rompere il mio tracciamento in modo permanente?
I blocchi annunci non rompono il tracciamento per gli utenti che non li hanno. Lo bloccano solo per chi li usa. Il tuo tracciamento funziona bene per la maggioranza degli utenti senza blocchi.