Come installare Microsoft Clarity con GTM e tracciare eventi utili per form, click e abbandoni
La procedura per installare Microsoft Clarity con GTM e tracciare eventi utili per form, click e abbandoni va eseguita in ordine. Se salti un controllo, rischi di vedere il tag attivo senza avere un dato realmente verificato.
Alla fine devi poter ricostruire il test: pagina usata, azione eseguita, evento generato e schermata dove hai verificato il risultato.
Prerequisiti. Servono progetto Clarity, GTM, pagine da analizzare e ipotesi CRO concrete.
- project ID Clarity
- tag GTM
- consenso se necessario
- eventi o custom tags
- pagine form/checkout
Controlla i permessi prima di iniziare. Se non puoi salvare, pubblicare o aprire il debug, fermati qui e risolvi l accesso prima di proseguire.
Configurazione passo passo. Segui i passaggi nell ordine indicato e verifica ogni salvataggio prima di passare al successivo.
Passo 1: crea progetto Clarity
Apri Clarity > Project settings e GTM > Tag e confronta progetto Microsoft Clarity corretto, Project ID e container GTM del sito prima di fare modifiche: se parti da account, property, stream, dataset o container sbagliato, il test non vale.
Clicca sul selettore principale, apri la voce corretta e confronta dominio, nome property, ID stream o container con il sito da misurare. Se uno di questi dati non coincide, fermati e cambia risorsa.
A questo punto devi avere la risorsa giusta aperta, i permessi necessari e la schermata da cui prenderai i valori gia identificata.
Se account, property o container non sono quelli corretti, torna al selettore principale e cambiali prima di modificare qualsiasi cosa.
Passo 2: installa script via GTM
Entra in Clarity > Settings > Setup, poi GTM Tags > New > Custom HTML o template Clarity se disponibile e crea o modifica evento Clarity, custom tag, form e click, usando un nome che descriva azione, strumento e pagina coinvolta.
Clicca il pulsante di creazione o modifica, scegli il tipo richiesto dalla guida, apri il riquadro di configurazione e collega il trigger, l evento o la regola che deve far partire il dato.
Il risultato da ottenere e una configurazione salvata, leggibile e agganciata alla condizione che deve far partire evento Clarity, custom tag, form e click.
Se il trigger o la regola e troppo generica, apri la condizione e restringila a URL, evento dataLayer, consenso, form riuscito, checkout o acquisto completato.
Passo 3: verifica registrazione sessioni
Compila Project ID Clarity, codice di installazione, custom tag name, valore evento e trigger su form/click/pagina copiando i valori da Clarity Project settings e mappa eventi della pagina. Non accorciare ID, label o nomi evento e non cambiare mai formato mentre li incolli.
Clicca dentro ogni campo obbligatorio, incolla il valore esatto, rileggilo nel riepilogo e usa Salva solo quando ogni campo ha una provenienza chiara.
Quando rileggi il riepilogo, nessun campo obbligatorio deve essere vuoto: il controllo minimo e vedere Project ID Clarity, codice di installazione, custom tag name, valore evento e trigger su form/click/pagina nel posto corretto.
Se un valore non torna, non riscriverlo a memoria: se non trovi sessioni, ricontrolla Project ID, blocchi consenso, trigger GTM e tempo di elaborazione Clarity.
Passo 4: aggiungi custom tags per eventi critici
Apri GTM Preview, Clarity Live recordings o sezione Recordings filtrata per custom tag, completa l azione richiesta sulla pagina di test e segui la sequenza finche vedi cosa parte, quando parte e con quali parametri.
Clicca il pulsante di anteprima o test, inserisci l URL della pagina se richiesto, conferma con Connect o Avvia test e poi esegui una sola volta l azione utente prevista.
Nel debug devi vedere sessione registrata e custom tag filtrabile in Clarity; se vedi solo un tag attivo ma mancano parametri o momento corretto, il test non e chiuso.
Se non compare nulla nel debug, controlla prima collegamento Preview/Connect, poi trigger, consenso e pagina usata per generare il test.
Passo 5: analizza heatmap e recording per ipotesi CRO
Apri Clarity > Recordings / Heatmaps e GA4 > Eventi e usa custom tag, pagina, recording, heatmap e ora del test per isolare il test appena fatto, invece di cercarlo dentro tutto il traffico della giornata.
Clicca sul report o pannello finale, applica il filtro piu stretto disponibile e verifica che il dato compaia una sola volta con ora, pagina o nome evento coerenti.
Nel report finale devi ritrovare il test con custom tag, pagina, recording, heatmap e ora del test, oppure riconoscere chiaramente che lo strumento richiede qualche minuto di elaborazione.
Se il dato non arriva nel report, ripeti il test annotando ora, pagina e azione; poi controlla ritardi di elaborazione, filtro sbagliato o property non corretta.
Tagga gli eventi chiave, altrimenti cercherai manualmente pattern dentro sessioni non segmentate.
Debug e validazione. Verifica tag fired, arrivo sessioni e custom tags nei filtri Clarity.
- script caricato: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- sessioni presenti: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- custom tags visibili: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- privacy rispettata: verifica il punto nella preview e poi nel report finale. Se non compare, torna al passaggio collegato e ripeti il test.
- ipotesi CRO documentata: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
Errori frequenti e come risolverli
Se il tag o l evento non compare nel debug, di solito la preview non e collegata alla pagina giusta, il trigger e troppo stretto oppure il consenso non si aggiorna. Riapri Clarity Live recordings, GTM Preview e GA4 DebugView, ricollega la pagina e ripeti il test.
Se il dato compare due volte, controlla se hai un doppio tag, un doppio percorso browser/server o un reload della pagina finale. Disattiva il duplicato, ripeti l azione e verifica che nel report resti un solo invio.
Se il report finale resta vuoto, ricontrolla ID, label, stream, dataset o property. Copia di nuovo i valori dalla piattaforma sorgente, salva e ripeti il test annotando ora, URL e azione eseguita.
Quando il debug non torna, non moltiplicare le modifiche. Cambia un punto, salva, rigenera l evento e ricontrolla.
Checklist finale prima di considerare chiuso il lavoro.
- installazione ok
- filtri evento ok
- heatmap lette
- recording campionati
- azioni CRO definite
Prima di usare la configurazione su traffico reale, salva uno screenshot del debug e uno del report in cui il test risulta visibile.
Lunedì – Sabato : 9:30 am – 21:00 pm
Lunedì – Sabato : 9:30 am – 21:00 pm
Studierò la strategia più adeguata per le tue esigenze e insieme al mio staff individueremo la Buyer Personas migliore per trasformare il tuo processo commerciale offline nella più efficace macchina di vendita online, e la strategia di comunicazione più convincente per convincere il pubblico che il tuo prodotto è quello che stanno cercando, anche se costa di più della concorrenza.
Lunedì – Sabato : 9:30 am – 21:00 pm
