Come eseguire il debug del tracciamento di Google Analytics e Tag Manager
Se le prenotazioni effettuate tramite il widget di checkout non vengono visualizzate in Google Analytics, la registrazione integrata dei log di debug del widget consente di individuare il punto in cui si interrompono.
1. Innanzitutto, capire come il widget invia gli eventi
Nelle impostazioni del widget, alla voce Analytics, l’opzione Invia eventi tramite determina il funzionamento del tracciamento. Le due opzioni si comportano in modo molto diverso e questo cambia ciò che è opportuno aspettarsi durante il debug.
Google Analytics 4 — il widget invia ogni evento di prenotazione direttamente alla proprietà Analytics. Con Usa il tag esistente (l’impostazione predefinita), utilizza il tag Google Analytics già presente nella pagina; con Usa un tag personalizzato, ne carica uno utilizzando l’ID misurazione inserito. In entrambi i casi è il widget a comunicare con Google, quindi i dati della prenotazione possono essere visualizzati nella scheda Rete del browser mentre vengono inviati.
Google Tag Manager — il widget non invia nulla a Google Analytics. Passa ogni evento al container di Tag Manager, che decide cosa farne. Con Usa il container esistente (l’impostazione predefinita), utilizza il container già presente nella pagina; con Usa un container personalizzato, carica l’ID container inserito. In entrambi i casi, nulla raggiunge Google Analytics se non è stato configurato un tag all’interno di Tag Manager per inviarlo. Questo è il motivo più comune per cui mancano le prenotazioni: il widget funziona perfettamente, ma nessun tag intercetta gli eventi. Vedere la sezione 5.
Nella parte superiore della stessa sezione è inoltre presente l’interruttore principale Abilita Google Analytics. Attiva o disattiva il tracciamento per entrambe le opzioni: se è disattivato, non viene tracciato nulla anche quando Tag Manager è abilitato.
2. Attivare la registrazione dei log di debug
- Nella dashboard di TicketingHub, aprire le impostazioni del widget di checkout che si desidera testare.
- Nella sezione Analytics, attivare Abilita la registrazione dei log di debug di Analytics e salvare.
Quando l’opzione è attiva, il widget scrive una riga nella console del browser del sito per ogni evento. Se è selezionato Google Analytics 4, viene attivata anche la modalità di debug di Google per il tag. Con Google Tag Manager, utilizzare l’Anteprima oppure attivare la modalità di debug nel tag GA4 per visualizzare gli eventi in DebugView. La registrazione nella console mostra solo ciò che accade dal lato del widget: il widget non può vedere cosa fa Google in seguito, quindi non sostituisce GA4 DebugView né l’Anteprima di GTM.
3. Aprire la console del browser sul sito
- Aprire la pagina del proprio sito web in cui è incorporato il widget, non la dashboard di TicketingHub.
- Aprire gli strumenti per sviluppatori del browser (F12 oppure fare clic con il pulsante destro del mouse e selezionare → Ispeziona), quindi passare alla scheda Console.
- Se il browser mostra un selettore di frame nella console, assicurarsi che sia selezionato il frame principale: il widget segnala gli eventi alla pagina, non all’interno del proprio frame.
- Attivare Conserva log nelle impostazioni della console: se dopo una prenotazione il widget reindirizza a un’altra pagina, i messaggi relativi all’evento di acquisto finale vengono scritti subito prima del reindirizzamento e altrimenti verrebbero cancellati prima di poterli leggere.
- Effettuare una prenotazione di prova. Assicurarsi che la console sia aperta prima del caricamento della pagina (oppure ricaricare la pagina con la console aperta), così da visualizzare anche i messaggi generati durante l’avvio della pagina.
4. Significato dei messaggi della console
| Messaggio | Significato |
|---|---|
Triggering GA event … / Triggering GTM event … | Il widget ha inviato l’evento a Google Analytics oppure lo ha passato al container di Tag Manager. |
… event … processed | L’evento è stato ricevuto e gestito; il messaggio solitamente indica il tag o il container che lo ha gestito. Con Tag Manager, questo significa che il container ha ricevuto l’evento, non che sia stato inviato qualcosa a Google. Vedere la sezione 5. |
… event … was not confirmed within …ms | Nulla ha comunicato al widget di aver gestito l’evento entro pochi secondi. Questo non significa necessariamente che l’evento sia andato perso: controllare GA4 DebugView per verificare se è arrivato. Le cause comuni sono descritte nella sezione 6. |
… event … was still waiting for confirmation when the page navigated away | Il widget ha reindirizzato a un’altra pagina prima del completamento del controllo; è normale se si utilizza un reindirizzamento dopo l’acquisto. Non significa che l’evento non sia riuscito: verificarlo in GA4 DebugView. |
… failed to load … | Non è stato possibile caricare lo script di Google, solitamente perché è stato bloccato da un ad blocker o da un filtro di rete. |
… event … dropped … | Non è stato possibile inviare l’evento. Il messaggio indica il motivo: sulla pagina non è ancora disponibile Google Analytics o Tag Manager oppure Tag Manager è disattivato nelle impostazioni del widget. |
Il widget segnala volutamente solo ciò di cui può avere la certezza. Sa se lo script di Google è stato caricato e se il tag ha confermato la gestione di un evento, ma non può sapere se Google ha accettato i dati; per questo indirizza a DebugView invece di fare supposizioni.
5. Se si utilizza Google Tag Manager, configurare i tag
Tag Manager è un container, non uno strumento di tracciamento. Quando il widget gli passa un evento di prenotazione, il container verifica i propri trigger ed esegue i tag corrispondenti. Se nessun tag corrisponde, l’evento si interrompe semplicemente in quel punto: la console indicherà comunque processed, perché il container ha ricevuto l’evento.
Un container appena creato non intercetta automaticamente questi eventi. La maggior parte dei tag Analytics è configurata per attivarsi su “Initialization” o “All Pages”, che non corrispondono agli eventi di prenotazione del widget.
Per inviare a Google Analytics le prenotazioni effettuate tramite il widget, nel container di Tag Manager sono necessari:
- Un tag Google (o un tag di configurazione GA4) contenente l’ID misurazione (
G-…). - Un tag evento GA4 per ogni evento di prenotazione di interesse, che utilizzi un trigger Evento personalizzato il cui nome corrisponda a uno degli eventi del widget.
Il widget invia i seguenti nomi di evento:
| Evento | Quando si verifica |
|---|---|
page_view | Il visitatore passa a un’altra fase del widget |
select_item | Viene selezionato un prodotto o un pacchetto dall’elenco dei prodotti o degli eventi |
add_to_cart | Gli articoli vengono aggiunti al carrello |
view_cart | Viene visualizzato il riepilogo dell’ordine |
begin_checkout | Viene visualizzata la fase relativa ai dati del cliente |
add_payment_info | Viene visualizzata la fase di pagamento, prima dell’invio dei dati |
purchase | Il pagamento va a buon fine oppure viene confermato un ordine per il quale non resta nulla da pagare |
Per gli eventi di acquisto, configurare il tag in modo che invii i dati ecommerce dal Data Layer. Il widget invia i campi ecommerce standard di Google Analytics, come valuta, valore, articoli e ID transazione, nel formato previsto da Google, quindi non è necessaria alcuna mappatura personalizzata.
Utilizzare l’Anteprima di GTM (Tag Assistant) per verificare la configurazione: mostra ogni evento ricevuto dal widget e indica esattamente quali tag sono stati attivati o non sono stati attivati. Se un evento arriva ma non viene attivato alcun tag, il trigger non corrisponde; se un tag viene attivato ma nulla raggiunge Analytics, controllare l’ID misurazione del tag.
Un aspetto da tenere presente: con Tag Manager non si vedranno i dati delle prenotazioni diretti a Google Analytics nella scheda Rete dal widget stesso. Il widget può caricare lo script del container di Tag Manager, ma le richieste contenenti i dati delle prenotazioni provengono dai propri tag, una volta attivati.
6. Cause comuni e soluzioni
- Ad blocker ed estensioni per la privacy — bloccano gli script di tracciamento di Google in quasi tutte le blocklist. Eseguire il test in una finestra privata/in incognito con le estensioni disattivate oppure in un profilo del browser pulito. Tenere presente che anche i visitatori che utilizzano ad blocker non verranno tracciati, quindi è normale che alcune prenotazioni non risultino.
- Gli eventi vengono elaborati, ma in Analytics non compare nulla — con Tag Manager, quasi sempre significa che nessun tag è configurato per attivarsi sugli eventi del widget. Vedere la sezione 5.
- Nella console non compare assolutamente nulla — il tracciamento potrebbe essere completamente disattivato. Verificare che Abilita Google Analytics sia attivo e ricordare che controlla anche Tag Manager. Assicurarsi inoltre che la pagina sia stata caricata con la console già aperta.
- Ogni evento indica che è stato scartato perché Tag Manager è disattivato — attivare Abilita Google Tag Manager nelle impostazioni del widget. Sia questa opzione sia Abilita Google Analytics devono essere attive affinché l’opzione Tag Manager funzioni.
- Nessun messaggio di Tag Manager, solo messaggi di Google Analytics — il widget è configurato per inviare gli eventi tramite Google Analytics 4, quindi le impostazioni di Tag Manager vengono ignorate. Impostare Invia eventi tramite su Google Tag Manager. Il widget utilizza un metodo o l’altro, mai entrambi.
- ID misurazione o ID container errato — verificare che l’ID nelle impostazioni del widget corrisponda alla proprietà Analytics (
G-…) o al container di Tag Manager (GTM-…). - Banner per il consenso — se il visitatore non ha accettato i cookie Analytics, Google Consent Mode potrebbe trattenere intenzionalmente gli eventi. Accettare il consenso per Analytics nella pagina di test prima di trarre conclusioni.
- Plugin di caching o ottimizzazione — alcuni plugin WordPress di caching o ottimizzazione interferiscono con gli script Analytics. Provare a disattivarli temporaneamente oppure aggiungere gli script all’elenco delle esclusioni.
7. Confermare i dati negli strumenti di Google
La console indica che il widget ha svolto la propria parte. Per confermare che i dati siano arrivati:
- GA4 DebugView (Analytics → Amministrazione → DebugView) mostra in tempo reale gli eventi che raggiungono la proprietà.
- Anteprima di GTM (Tag Assistant) mostra quali tag si attivano per ogni evento inviato dal widget.