Come Installare una Heatmap sul Tuo Sito WordPress (Una Riga di Codice, 3 Minuti)

Riepilogo dell'articolo

Aggiungere una heatmap a WordPress richiede solo di incollare una singola riga di codice

Ci sono tre modi per farlo: (1) il campo delle impostazioni header del tuo tema, (2) un plugin per l'inserimento di codice, o (3) la modifica diretta di header.php

Il successo si misura dal conteggio che aumenta effettivamente per il tuo sito nella dashboard di HeatMapX — non semplicemente "nessun errore"

Temi che aggiungere una heatmap significhi lottare con il codice? Su WordPress, si tratta davvero solo di una riga di codice tag. Questa guida illustra tre modi per aggiungerla, dall'opzione più semplice per i principianti a un approccio più avanzato.

Passo 1: Ottieni la Tua Site Key

Prima di tutto, registrati su HeatMapX (è disponibile un piano gratuito), registra il tuo sito e ottieni la tua site key. Non è richiesta alcuna carta di credito.

Una volta ottenuta la tua site key, usa il tag qui sotto, sostituendo YOUR_SITE_KEY con la chiave effettiva che ti è stata assegnata.

<script src="https://heatmapx.com/tracker.js" data-site-key="YOUR_SITE_KEY"></script>

Incolla questo tag nell'<head> del tuo sito usando uno dei tre metodi seguenti.

Metodo 1 (Consigliato per i Principianti): Le Impostazioni Header del Tuo Tema

Molti temi popolari, come Astra o GeneratePress, includono un campo di impostazioni — spesso sotto "Avanzate" o "Script Personalizzati" — dove puoi inserire codice direttamente nella sezione <head>.

Nell'amministrazione di WordPress, apri il personalizzatore o il pannello impostazioni del tuo tema attivo
Cerca un campo etichettato qualcosa come "Header Scripts," "Codice Personalizzato," o "Avanzate"
Incolla il tag sopra in quel campo e salva

Dato che non devi toccare alcun file del tema, questa è l'opzione più sicura se lo stai facendo per la prima volta.

Metodo 2: Un Plugin per l'Inserimento di Codice

Se il tuo tema non ha un campo header, puoi usare un plugin come WPCode (precedentemente Insert Headers and Footers).

Dalla schermata Plugin, cerca e installa un plugin per l'inserimento di codice come WPCode, poi attivalo
Apri le impostazioni del plugin e trova il campo "Header"
Incolla il tag sopra e salva

Il vantaggio di questo approccio è che il tag sopravvive a un cambio di tema. È una scelta adatta se stai pensando di rifare il design del tuo sito in futuro.

Metodo 3 (Avanzato): Modifica header.php in un Child Theme

Se ti trovi a tuo agio nel modificare il codice direttamente, puoi aggiungere il tag direttamente nei file del tuo tema.

Configura prima un child theme per il tuo tema attivo (modificare direttamente il tema parent significa che la tua modifica verrà cancellata al prossimo aggiornamento del tema — un child theme è indispensabile)
Apri header.php nel child theme e incolla il tag subito prima di wp_head(), oppure subito prima del tag di chiusura </head>
Salva il file

Se modifichi direttamente il tema parent, il prossimo aggiornamento del tema sovrascriverà la tua modifica e il tag scomparirà. Se scegli questo metodo, esegui sempre la modifica tramite un child theme.

Come Confermare che Funzioni Davvero

Una volta aggiunto il tag, naviga alcune pagine sul tuo stesso sito. Ma ecco la parte importante.

Una pagina che si carica senza errori non è la stessa cosa del tracciamento che funziona davvero. Anche se la console del tuo browser non mostra nulla di sbagliato, una site key digitata male può significare che nessun dato raggiunge mai HeatMapX.

L'unico controllo affidabile è aprire la dashboard di HeatMapX, trovare il tuo sito nell'elenco dei siti, e confermare che il suo conteggio sia effettivamente aumentato. Dopo aver visitato alcune pagine, se il conteggio aumenta, la tua installazione funziona.

Domande Frequenti

D. Questo rallenterà il mio sito? R. Il tag si carica in modo asincrono ed è leggero, quindi l'impatto sulla velocità di caricamento della pagina è minimo.

D. Uso un plugin di caching — c'è qualcosa a cui fare attenzione? R. Se usi un plugin di caching come WP Super Cache o W3 Total Cache, assicurati di svuotare (purge) la cache dopo aver aggiunto il tag. Se continua a essere servita una vecchia versione in cache, il tag appena aggiunto non avrà effetto.

D. Ho aggiunto il tag, ma il conteggio nella dashboard non aumenta R. La causa più comune è una site key non corrispondente — incollare la chiave di un sito diverso, o un carattere perso durante la copia. Ricontrolla la chiave rispetto a quella nella tua dashboard di HeatMapX.

Conclusione

Aggiungere una heatmap a WordPress si riduce a incollare una riga di codice. HeatMapX è gratuito per iniziare, quindi provalo e scopri come i visitatori vivono davvero il tuo sito.