Qualcosa non va. I numeri del traffico sembrano strani. Un evento non parte. Un parametro è vuoto. Mancano dei dati. Le tue analisi sono rotte. Ma dov'è il problema? Nel codice di tracciamento? Nella piattaforma di analisi? Nel tuo sito? Fare il debug delle analisi significa trovare il problema in modo sistematico. Controlli ogni componente. Isoli il problema. Lo risolvi. Un buon debug fa risparmiare ore di frustrazione.
Questo articolo spiega come fare il debug dei problemi più comuni delle analisi.
Parti dai report in tempo reale
I report in tempo reale mostrano cosa succede adesso. Se un evento non parte, i report in tempo reale te lo mostrano subito. Se manca del traffico, i report in tempo reale lo rivelano.
Apri i report in tempo reale. Fai l'azione che dovrebbe generare dati. La vedi in tempo reale? Se sì, il tracciamento funziona. Se no, è rotto.
I report in tempo reale isolano il momento in cui è iniziato il problema. Funzionava ieri ma non oggi? Qualcosa è cambiato. Funzionava nell'ambiente di prova ma non in produzione? I tuoi ambienti sono diversi.
Controlla il codice di tracciamento
Usa gli strumenti per sviluppatori del browser. Apri la scheda Rete. Cerca le richieste verso la tua piattaforma di analisi. Compaiono? Se sì, il codice di tracciamento parte. Se no, il codice non viene eseguito.
Controlla la scheda Console per gli errori. Gli errori JavaScript possono impedire l'esecuzione del tracciamento. Cerca i messaggi di errore in rosso. Ti dicono cosa si è rotto.
Controlla che lo script delle analisi si sia caricato. La maggior parte delle piattaforme mostra uno stato nella console. «Script caricato con successo» oppure «In attesa del consenso» o simili. Cerca i messaggi.
Verifica il tuo data layer
Apri la Console. Scrivi il nome della variabile del tuo data layer. Controlla che esista. Controlla che contenga dati. Se il data layer è vuoto, gli eventi non possono accedere ai dati.
Controlla i tempi. Il data layer viene riempito prima che partano gli eventi? Apri la Console. Fai l'azione. Controlla il data layer. Ha i dati giusti al momento giusto?
Confronta con le aspettative. Ti aspetti product_id nel data layer. Lo vedi? Ti aspetti user_type. Lo vedi? I campi mancanti sono indizi per il debug.
Isola il componente che causa il problema
Le analisi coinvolgono più componenti. Il tuo sito. Il tuo data layer. Il tuo codice di tracciamento. Il tuo tag manager. La tua piattaforma di analisi. Quale componente è rotto?
Testa ogni componente separatamente. Il tuo sito ha i dati? Controlla il data layer. Il codice di tracciamento vi accede? Controlla la scheda Rete. Invia i dati alla tua piattaforma di analisi? Controlla i log della piattaforma. Sta ricevendo i dati?
Quando trovi quale componente è rotto, puoi correggerlo in modo mirato. Se è il data layer, parla con gli sviluppatori. Se è il codice di tracciamento, controlla la configurazione. Se è la piattaforma, controlla le sue impostazioni.
Cerca gli errori più comuni
Alcuni errori sono comuni. Controllali per primi. Consenso non dato. Se richiedi il consenso, il visitatore ha acconsentito? Se no, il tracciamento è disattivato.
Blocchi degli annunci. Alcuni visitatori usano blocchi degli annunci. Bloccano le analisi. Ecco perché vedi meno traffico del previsto.
Filtri. Un filtro esclude i dati che cerchi? Hai creato un filtro che esclude il traffico interno. Ma stai testando dal tuo ufficio. Non vedi i dati perché il filtro ti esclude.
Proprietà o vista sbagliata. Stai guardando la proprietà di analisi giusta? La vista giusta? Hai creato una vista che mostra solo il traffico da mobile. Il traffico da desktop non comparirà lì.
Usa la modalità di anteprima del tag manager
Se usi un tag manager, attiva la modalità di anteprima. Mostra cosa partirebbe senza inviare davvero i dati. Puoi vedere ogni tag. Ogni evento. Ogni attivatore di azioni.
La modalità di anteprima è potente per il debug. Fai un'azione. Guarda il pannello di anteprima. Vedi ogni tag che parte. Vedi l'ordine. Vedi quali dati vengono inviati. Se qualcosa non parte, lo vedi subito.
Contatta il fornitore delle analisi
Se non riesci a trovare il problema, contatta il fornitore delle analisi. Dai dettagli. Cosa non funziona. Quali verifiche hai fatto. Cosa hai trovato. Buone informazioni sulle verifiche lo aiutano ad aiutarti più in fretta.
Molti fornitori hanno team di assistenza. Assistenza via email. Via chat. Via telefono, a seconda del tuo piano. Usali. Sono lì per questo.
Domande frequenti
Le analisi non mostrano dati. Da dove parto?
Parti dai report in tempo reale. Se il tempo reale non mostra nulla, il tracciamento non funziona. Controlla il codice di tracciamento nella scheda Rete. Invia richieste? Controlla la Console. Ci sono errori? Controlla il data layer. Ha dei dati? Procedi in modo sistematico. Con il creatore di siti di WEMASY puoi impostarlo direttamente sul tuo sito.
Un evento parte ma non ha dati nei parametri.
L'evento parte. Ma i dati non vengono catturati. Controlla il data layer. I dati rilevanti ci sono? Controlla la configurazione dell'evento. Cerca nel posto giusto? Controlla i tempi. I dati sono disponibili quando parte l'evento? Di solito il data layer manca o è vuoto.
I numeri del traffico sono più bassi del previsto.
Le cause più comuni sono filtri, blocchi degli annunci e consenso. Controlla i filtri. Stai escludendo traffico che non dovrebbe essere escluso? Controlla i blocchi degli annunci. I tuoi visitatori potrebbero usarli. Controlla il consenso. Se i visitatori non hanno acconsentito, non li traccia.
Nell'ambiente di prova va tutto bene ma in produzione si rompe.
Ambiente di prova e produzione sono diversi. Controlla le differenze. Il dominio è diverso? Il sottodominio è diverso? Il codice è diverso? Controlla la configurazione del tracciamento. Dipende dall'ambiente? Se puoi, testa direttamente in produzione.
Come faccio a sapere se i blocchi degli annunci bloccano le analisi?
Il tuo traffico reale è più alto di quello che mostrano le analisi. Non tutti i visitatori reali compaiono nelle analisi. I blocchi degli annunci impediscono l'esecuzione delle analisi. Puoi ridurre il problema con il tracciamento lato server, ma non puoi eliminarlo del tutto. Metti in conto una perdita di dati dovuta ai blocchi degli annunci.
Quanto tempo richiede di solito il debug?
I problemi semplici richiedono minuti. Un filtro sbagliato. Una configurazione mancante. I problemi complessi richiedono più tempo. Problemi del data layer. Problemi di integrazione. Se non lo trovi in 30 minuti, chiedi aiuto. Un secondo punto di vista spesso rivela ciò che ti era sfuggito.