Come installare una heatmap con Google Tag Manager (senza toccare il codice, in 5 minuti)

In breve

Con GTM puoi installare una heatmap senza toccare minimamente il codice del sito

Cinque passaggi: crea un tag HTML personalizzato → collega un trigger All Pages → pubblica

Il successo si misura dai numeri che si muovono sulla dashboard di HeatMapX, non semplicemente dall'assenza di errori

Se il tuo sito gestisce già i tag tramite Google Tag Manager (GTM), è il modo più pulito per aggiungere il tracciamento heatmap: tutto avviene nell'interfaccia di GTM, senza alcuna modifica al codice. Questa guida ti accompagna passo dopo passo.

Prima di iniziare: ottieni la tua site key

Registrati su HeatMapX (c'è un piano gratuito, nessuna carta di credito richiesta), registra il tuo sito e otterrai una site key.

Una volta ottenuta, userai un tag di questo tipo: sostituisci YOUR-SITE-KEY con la tua chiave effettiva.

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

Importante: incolla l'intero tag, non solo l'URL. L'attributo data-site-key="..." indica a HeatMapX a quale sito appartengono i dati: se lo elimini, o incolli solo l'URL src, non verrà tracciato nulla.

La configurazione in GTM (5 passaggi)

Apri la console GTM (tagmanager.google.com) e seleziona il container (workspace) del tuo sito
Vai su "Tag" → "Nuovo" nel menu a sinistra e scegli "Custom HTML" come tipo di tag
Incolla l'intero tag riportato sopra nel campo HTML
Nella sezione trigger, scegli "All Pages (Page View)", assegna al tag un nome riconoscibile (ad es. HeatMapX) e salva
Premi "Submit / Publish" in alto a destra per pubblicare la modifica

Fatto: il tracciamento è ora attivo su ogni pagina del tuo sito.

Vuoi verificare prima di pubblicare? (Modalità Preview)

Clicca su "Preview" in GTM per testare il tag nel tuo browser prima di andare live. Apri il tuo sito tramite la schermata di anteprima (Tag Assistant): se il tuo tag HeatMapX compare nella sezione "Fired", significa che funziona.

Se il tag non si attiva — checklist

Hai premuto Publish? Il solo salvataggio non pubblica le modifiche. È la causa più comune
Il trigger è All Pages? Un trigger specifico per una sola pagina significa che le altre pagine non verranno tracciate
Un banner di consenso cookie (consent mode) lo sta bloccando? Con alcuni strumenti di gestione del consenso, i tag HTML personalizzati vengono trattenuti finché il visitatore non acconsente. Controlla le impostazioni di consenso del tag e come il tuo CMP lo categorizza
Il data-site-key è corretto? Incollare la chiave di un altro sito invia i tuoi dati al sito sbagliato

Fatti guidare da Claude Code

Se preferisci non addentrarti nell'interfaccia di GTM, puoi chiedere a un agente AI come Claude Code di guidarti. Copia il prompt qui sotto, sostituisci la tua site key e incollalo.

I want to deploy the HeatMapX heatmap tracking tag via Google Tag Manager.
Walk me through the GTM interface one step at a time, waiting for my reply at each step.

The tag to use (Custom HTML, All Pages trigger):
<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

Se non usi GTM e vuoi inserire il tag direttamente nel codice del tuo sito, questa versione permette a Claude Code di occuparsi delle modifiche ai file per te.

Install the HeatMapX heatmap tracking tag in this project.
Make sure the following tag is included right before </head> on every page, and tell me which files you changed.

<script src="https://heatmapx.com/tracker.js?key=YOUR-SITE-KEY" data-site-key="YOUR-SITE-KEY"></script>

HeatMapX è progettato in modo che anche l'estrazione e l'analisi dei tuoi dati funzionino da Claude Code (integrazione CLI): consulta la pagina "CLI & Skills" sulla tua dashboard una volta configurato.

Verifica che funzioni: i numeri devono muoversi

Dopo l'installazione, naviga qualche pagina del tuo sito, poi apri la dashboard di HeatMapX. Se "Sessions today" del tuo sito è in aumento, il tracciamento è attivo.

Il segnale di successo non è "nessun errore": sono i numeri che si muovono sulla dashboard. Se nulla si muove, ripercorri in ordine la checklist sopra.