Come configurare il tracciamento dei moduli AJAX con Google Tag Manager per GA4

Pubblicato il Aggiornato il 16 min di lettura
Come configurare il tracciamento dei moduli AJAX con Google Tag Manager per GA4
Aggiungi Marketing News comeFonte preferita su Google

Perché i form asincroni ingannano i trigger standard di Tag Manager

I moduli di contatto moderni funzionano quasi ovunque in modalità asincrona. Quando un utente compila i campi e preme il pulsante di invio, la pagina web non effettua una nuova richiesta HTTP completa né ricarica l'interfaccia. Il browser trasmette le informazioni al server in background tramite una chiamata XMLHttpRequest oppure tramite l'API Fetch di JavaScript, e riceve una risposta strutturata in formato JSON prima di mostrare un avviso di conferma nello stesso riquadro visivo.

Questa architettura perfeziona l'esperienza di navigazione perché abbassa i tempi di attesa e cancella i salti grafici della finestra. Allo stesso tempo, spezza il funzionamento nativo dei trigger predefiniti presenti dentro Google Tag Manager. Se imposti un attivatore basato sul trigger standard di invio modulo, la piattaforma resta in ascolto dell'evento DOM nativo del form. Moltissimi framework moderni come React, Vue o semplici script basati su librerie legacy bloccano quell'evento con l'istruzione preventDefault per gestire la richiesta via script. Il risultato operativo produce due scenari critici: o il tag non scatta mai, con la perdita totale delle conversioni reali, oppure il tag parte al semplice clic sul pulsante anche quando i campi obbligatori restano vuoti o l'indirizzo email non supera i controlli sintattici.

Per misurare con precisione chirurgica le conversioni dentro Google Analytics 4, nota con la sigla GA4, devi intercettare l'avvenuta risposta positiva dal server. Non puoi limitarti a registrare l'intenzione preliminare dell'utente. Questa solida impostazione su Google Analytics 4 ti aiuta a monitorare le interazioni specifiche degli utenti quando colleghi parametri precisi a ogni azione rilevante.

I prerequisiti tecnici per iniziare la configurazione

Prima di aprire l'interfaccia di lavoro devi raccogliere alcuni elementi indispensabili sul sito e all'interno delle tue piattaforme di analisi. Ti occorre poi una proprietà attiva di Google Analytics 4 con il rispettivo ID di misurazione, riconoscibile dalla stringa alfanumerica che inizia con il prefisso G seguito da numeri e lettere.

Sul versante del sito web, devi verificare quale libreria gestisce le richieste asincrone. Se il tuo portale utilizza WordPress, molti plugin celebri come Contact Form 7, Gravity Forms o WPForms offrono già eventi personalizzati JavaScript pronti per la lettura. Se invece lavori su un'applicazione proprietaria o su un portale sviluppato su misura, ti serve il supporto di chi scrive il codice per inserire un push nel Data Layer, oppure devi configurare un ascoltatore globale basato su uno script dedicato. Apri la modalità di anteprima di Tag Manager e consulta la console degli strumenti per sviluppatori del tuo browser per monitorare il flusso dei dati in tempo reale.

Le quattro vie possibili per catturare l'invio asincrono

Non tutti i siti presentano la medesima struttura tecnica, quindi non esiste una scorciatoia valida per ogni architettura software. Quando imposti un progetto analitico, devi esaminare con attenzione il codice dell'applicazione per scegliere la strategia più robusta. Una scelta affrettata rischia di produrre dati falsati o di richiedere continue correzioni a ogni minimo aggiornamento del tema grafico.

Le quattro soluzioni disponibili si differenziano per stabilità, complessità tecnica e grado di dipendenza dalle modifiche grafiche apportate dai designer. Conoscere le peculiarità di ciascuna via ti permette di valutare subito il rapporto tra costi di implementazione e affidabilità del dato nel lungo periodo.

Il metodo ideale con push nativo nel Data Layer

Questa soluzione offre la massima stabilità nel tempo. Consiste nell'istruire chi scrive il codice del portale affinché inserisca una riga di comando che invoca la funzione del contenitore non appena la risposta asincrona restituisce successo. Il comando deposita un evento arbitrario e una serie di coppie chiave-valore con gli attributi utili, come l'identificativo del form, il servizio richiesto o la lingua selezionata.

L'ascoltatore di eventi personalizzati del browser

Se utilizzi estensioni diffuse, molte di esse rilasciano eventi standard nell'oggetto window del browser. Per esempio, Contact Form 7 genera l'evento denominato wpcf7mailsent quando il server convalida l'email, mentre altri strumenti generano notifiche simili. In questo scenario, ti basta scrivere un piccolo script in un tag HTML personalizzato che resta in ascolto passivo di tale evento per poi trasferire le informazioni utili dentro il Data Layer del tuo contenitore.

Il monitoraggio globale delle chiamate XMLHttpRequest e Fetch

Quando non puoi toccare il codice sorgente e il plugin non offre eventi personalizzati, l'alternativa consiste nell'intercettare a livello globale il traffico di rete generato dal browser. Tramite un codice JavaScript avanzato, puoi riscrivere in modo trasparente i metodi di invio asincrono per ispezionare gli endpoint richiamati. Se la chiamata punta all'URL di gestione dei lead e restituisce una risposta positiva, lo script crea al volo l'evento per Tag Manager. Questo metodo richiede cautela per non interferire con altre funzionalità del portale.

Il trigger di visibilità dell'elemento come ultima risorsa

Costituisce la via più semplice ma anche la più vulnerabile. Sfrutta il trigger nativo di visibilità degli elementi per accorgersi quando compare nel DOM il messaggio di testo che conferma la ricezione del messaggio. Se il messaggio possiede un ID o una classe CSS univoca, il sistema si attiva nel momento esatto in cui il blocco visivo diventa percepibile sullo schermo.

Procedura operativa passo a passo per impostare la misurazione

Per costruire un tracciamento solido e replicabile su qualsiasi piattaforma web, devi seguire una sequenza ordinata di passaggi dentro Google Tag Manager. Questa procedura adotta la tecnica del listener asincrono combinato al passaggio dei parametri verso il Data Layer, così assicuri totale indipendenza dai cambi di layout o dalle modifiche stilistiche dei fogli di stile CSS.

Segui ogni fase con metodo, senza saltare le verifiche intermedie delle variabili. Quando imposti la logica, controlla sempre che ogni elemento mantenga la stessa sintassi e che i nomi dei parametri rispettino la convenzione stabilita all'inizio del lavoro. Un piccolo errore di battitura tra il codice sorgente e la variabile di Tag Manager rende inutilizzabile l'intero flusso dei dati.

1. Creare l'ascoltatore JavaScript per intercettare la risposta positiva

Accedi al tuo contenitore di Google Tag Manager, spostati nella sezione Tag e seleziona il pulsante per crearne uno nuovo. Assegna al tag un nome chiaro come cHTML - AJAX Form Listener. Nel tipo di tag scegli HTML personalizzato. Nel campo di testo devi inserire lo script che controlla la risposta delle chiamate. Se il tuo sito lavora su libreria jQuery, puoi sfruttare i metodi globali ajaxSuccess. Se invece il sito usa codice nativo moderno, devi creare un wrapper attorno all'API Fetch.

Nel caso del listener basato su jQuery, lo script deve monitorare che la chiamata termini con successo e verificare che l'azione corrisponda al modulo di contatto desiderato. All'interno del blocco di codice, inserisci la chiamata a window.dataLayer.push con una proprietà event che nomini ajax_form_submit. Aggiungi all'interno dell'oggetto anche parametri descrittivi, come form_id e form_destination. Nel pannello di attivazione di questo tag, seleziona l'attivatore incorporato Inizializzazione o Visualizzazione di pagina - DOM pronto su tutte le pagine in cui risiede almeno un modulo di contatto. In questo modo mantieni l'ascoltatore vigile ancora prima che l'utente inizi a compilare i campi.

2. Configurare le variabili del livello dati per recuperare i parametri

Ora che il tuo script inietta l'evento nel layer condiviso, devi insegnare a Google Tag Manager a leggere i dati inviati insieme alla notifica di successo. Vai nella sezione Variabili e scorri fino al riquadro delle variabili definite dall'utente. Clicca su Nuova e seleziona il tipo Variabile del livello dati.

Nel campo Nome variabile livello dati scrivi il nome esatto della chiave che hai specificato nello script precedente. Se hai scelto form_id, inserisci esattamente quel testo, con rispetto rigoroso di minuscole e maiuscole. Rinomina questa risorsa dentro lo strumento come dlv - form_id. Ripeti la stessa operazione per ogni attributo che decidi di tracciare, come il tipo di richiesta o la categoria del servizio. Queste variabili conterranno dinamicamente il valore reale estratto al momento della compilazione e ti permetteranno di differenziare un modulo di richiesta preventivo da una semplice iscrizione alla lista di attesa.

3. Definire l'attivatore personalizzato per l'evento asincrono

Passa alla sezione Attivatori e fai clic sul pulsante per creare una nuova regola. Tra le scelte disponibili nella categoria Altro, seleziona Evento personalizzato. Questa tipologia di attivatore ignora i click fisici sul mouse e si concentra unicamente sui messaggi che transitano nel Data Layer.

Ispeziona la console di rete e verifica il rifiuto dei campi errati prima di pubblicare qualsiasi contenitore.

Nel campo Nome evento inserisci la stringa esatta che hai definito nello script al passaggio numero uno, ovvero ajax_form_submit. Lascia la spunta attiva su Tutti gli eventi personalizzati se vuoi che la regola valga per qualunque modulo gestito con questa logica, oppure seleziona Alcuni eventi personalizzati se intendi filtrare l'attivazione solo quando la variabile dlv - form_id corrisponde a uno specifico identificativo alfanumerico. Assegna all'attivatore il nome Evento CE - ajax_form_submit e salva la configurazione.

4. Creare il tag di evento per Google Analytics 4

Torna nell'area Tag e crea un nuovo elemento dedicato all'invio dei dati verso la piattaforma di web analytics. Scegli la voce Google Analytics: evento GA4. Nel campo ID di misurazione inserisci la variabile con l'identificativo della tua proprietà, oppure incolla direttamente la stringa alfanumerica corrispondente.

Nel campo Nome evento adotta la nomenclatura raccomandata dalla documentazione ufficiale di Google per preservare la compatibilità con i modelli di attribuzione predefiniti. Espandi la sezione Parametri evento e aggiungi le righe corrispondenti alle informazioni contestuali che vuoi inviare ai tuoi report. Nel riquadro di attivazione, associa l'attivatore personalizzato creato al passaggio tre. Salva il tag e assegna il nome GA4 - Evento - generate_lead.

La fase di collaudo con anteprima e console del browser

Non pubblicare mai le modifiche senza aver eseguito una verifica puntuale del comportamento dinamico. Premi il pulsante Anteprima in alto a destra nell'interfaccia di Tag Manager per avviare Tag Assistant. Inserisci l'indirizzo della pagina di atterraggio contenente il modulo e attendi l'apertura della finestra di test.

Prima di inviare i dati, lascia volutamente i campi vuoti e premi il bottone di invio. Se nulla si muove nella colonna degli eventi, il sistema ha superato la prima barriera.

Compila ora il modulo con dati di prova corretti e premi nuovamente il pulsante di trasmissione. Osserva la colonna di sinistra di Tag Assistant: non appena compare il messaggio visivo di successo sulla pagina, deve comparire il record ajax_form_submit. Clicca sopra questo evento e verifica che il tag GA4 - Evento - generate_lead risulti nello stato Fired. Spostati sulla scheda Variabili per verificare che la variabile dlv - form_id contenga il testo corretto estratto dalla pagina. Apri parallelamente il report DebugView all'interno di Google Analytics 4, accessibile nel menu di amministrazione, per verificare che il flusso di telemetria riceva l'evento generate_lead con i relativi parametri valorizzati in tempo reale.

Registrazione dei parametri e gestione delle conversioni in GA4

L'arrivo dei dati dentro Google Analytics 4 non conclude interamente l'opera. Il modello dati basato sugli eventi raccoglie i parametri inviati, ma non li rende automaticamente visibili nei report standard di esplorazione se prima non li mappi come dimensioni personalizzate.

Entra nel pannello di Amministrazione della proprietà GA4, individua la voce Display di dati e clicca su Definizioni personalizzate. Seleziona Crea dimensione personalizzata. Nel campo Nome dimensione inserisci un'etichetta leggibile come Identificativo modulo, mentre nel campo Ambito mantieni il valore Evento. Nel menu a discesa Parametro evento devi selezionare o digitare esattamente la stringa form_id, identica al parametro configurato dentro Tag Manager. Salva la nuova dimensione. Da questo momento, GA4 accumula i valori associati a ogni lead e ti permette di filtrare e segmentare le analisi nei mesi successivi.

Per fare in modo che questa interazione pesi nelle strategie di offerta delle campagne pubblicitarie o nei report di rendimento, naviga nella sezione Conversioni o Eventi chiave, a seconda della versione dell'interfaccia attiva sul tuo account. Se l'evento non appare ancora in lista a causa dei tempi di latenza del processing, usa il pulsante Nuovo evento di conversione.

Altri articoli in Guide