Hotjar: configurazione e aiuto
Avvio rapido
- Carica lo ZIP
mprhotjartramite "Modules > Module Manager > Upload a module". - Fai clic su "Configure" per aprire Impostazioni Hotjar.
- Inserisci l’ID sito numerico del tuo sito Hotjar esistente.
- Controlla "Exclude employee browsing" e "Respect analytics consent".
- Imposta Attiva Hotjar su Sì, lascia attivi gli eventi standard necessari e salva.
- Controlla la tabella di preparazione, apri il negozio in un browser cliente e concedi il consenso analitico tramite lo strumento di consenso configurato.
- Conferma la richiesta dello script Hotjar e un evento
product_viewcontenente solo il nome, poi controlla la sessione in Hotjar.
Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.
Manuale di configurazione
Installazione e configurazione
Segui i passaggi in Avvio rapido.
Impostazioni Hotjar
Apri "Configure" dal gestore moduli. Il tracciamento è inizialmente disattivato. Crea il sito in Hotjar prima di inserirne l'ID.
| Impostazione | Valore predefinito | Cosa configuri |
|---|---|---|
| Attiva Hotjar | No | Attiva il caricamento nel browser e l'invio degli eventi. |
| ID sito | Vuoto | Inserisci l'identificatore numerico del sito Hotjar. |
| "Exclude employee browsing" | Sì | Sospendi il tracciamento per i browser contrassegnati come personale. Si applica anche l'esclusione manuale mpr_notrack=1. |
| "Respect analytics consent" | Sì | Richiedi una decisione positiva di consenso analitico. Un consenso sconosciuto sospende il tracciamento. |
| "Persist consent withdrawal" | No | Attiva la persistenza privata delle revoche autenticate. |
Il modulo controlla il consenso prima dell’invio. Supporta Cookies Revolution, Cookie Banner, Cookiebot, OneTrust e TCF. Configura e prova le decisioni pertinenti di categoria e servizio nel tuo strumento di consenso. Senza una decisione esplicita, il tracciamento resta sospeso. Una CMP supportata rilevata dal modulo continua ad applicarsi se disattivi l'opzione di consenso del modulo.
Eventi Hotjar
Tutte le opzioni seguenti sono su Sì per impostazione predefinita. Disattiva gli eventi che non vuoi inviare.
| Impostazione | Cosa attiva l'evento |
|---|---|
| "Track page_view event" | page_view su una pagina tracciata del negozio. |
| "Track product_view" | product_view su una pagina prodotto. |
| Traccia le visualizzazioni delle categorie | category_view su una pagina categoria. |
| "Track add_to_cart" | add_to_cart dopo un aumento di quantità confermato come riuscito. |
| "Track add_to_wishlist" | add_to_wishlist da una notifica di successo della lista desideri supportata. |
| "Track checkout_start" | checkout_start sulle pagine rilevate di ingresso al checkout nativo o di un modulo. |
| "Track search" | search su una pagina di ricerca rilevata. |
| "Track purchase" | purchase alla conferma dell'ordine, riservato una volta per negozio, ordine e destinazione. |
| "Track sign_up" | sign_up dopo la creazione dell'account tramite una richiesta privata del contesto visitatore. |
Hotjar riceve i nomi degli eventi tramite hj('event', 'event_name'). Non riceve da questa integrazione ID prodotto, totali del carrello, termini di ricerca o dettagli dell'ordine come proprietà degli eventi.
Contatto e coinvolgimento con il prodotto
"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" e "Track product engagement" sono su No per impostazione predefinita. Attiva solo i segnali verificabili. Un evento relativo a un modulo di contatto richiede una ricevuta di successo confermata dal server. Un evento chat richiede una notifica supportata di avvio effettivo.
Usa "Product engagement thresholds" per soglie e selettori JSON. I valori predefiniti sono 3 interazioni con la galleria, 1 cambio variante, 1 interazione con i dettagli o 45 secondi di permanenza. L'intervallo di limitazione delle opzioni è di 1500 ms per impostazione predefinita. I limiti sono da 1 a 20 interazioni, da 5 a 600 secondi e da 250 a 60000 ms per la limitazione. Mantieni high_intent_product_engagement come nome evento. Per impostazione predefinita il tracker limita questo evento a una volta per prodotto/sessione quando l'archiviazione di tracciamento è consentita.
Configurare gli eventi personalizzati
Traccia gli eventi personalizzati è su No per impostazione predefinita. Regole eventi personalizzati è inizialmente vuoto. Aggiungi almeno una regola valida prima di attivare l'opzione.
Usa nomi distinti fino a 250 caratteri supportati: lettere, numeri, trattini bassi, spazi, punti, due punti, barre verticali, barre oblique o trattini. Puoi configurare fino a 50 nomi personalizzati distinti. I nomi integrati di commercio e contatto sono riservati.
[
{"event":"GalleryBrowse","trigger":"click","selector":".product-cover img"},
{"event":"CheckoutPathViewed","trigger":"url","contains":["/checkout"]},
{"event":"ProductPageViewed","trigger":"controller","controllers":["product"]},
{"event":"SizeGuideOpened","trigger":"event","dom_event":"mprhjar:size-guide"}
]
Usa selector per i clic, contains per i frammenti URL, controllers per le regole controller e dom_event per gli eventi browser. Una regola controller con modules richiede entrambe le condizioni. Non è un ripiego per il modulo. Una regola evento DOM senza nome ascolta mprhjar:custom. once è false per i clic e true per le regole URL, controller ed eventi DOM per impostazione predefinita.
Genera l'evento configurato dal tuo tema:
document.dispatchEvent(new CustomEvent('mprhjar:size-guide'));
La regola invia solo SizeGuideOpened. params, etichette, valori dei moduli e dettagli degli eventi DOM non diventano proprietà degli eventi Hotjar.
Verificare il tracciamento
Apri il negozio fuori da un browser del personale escluso. Con il consenso analitico concesso, controlla la richiesta a https://static.hotjar.com/c/hotjar-SITE_ID.js?sv=6. Apri un prodotto e una categoria, esegui una ricerca, aggiungi un prodotto con successo, registra un account ed effettua un ordine di prova. Controlla i nomi degli eventi attivati negli strumenti browser e nel tuo account Hotjar.
Prova il rifiuto e la revoca. Verifica che un altro modulo o tema non abbia caricato il proprio script Hotjar. Prima dell'invio l'integrazione verifica proprietà della destinazione, stato del personale, consenso e sicurezza della pagina. Mappe di calore, registrazioni e rapporti di feedback restano in Hotjar.
Risoluzione dei problemi
Se non si carica alcuno script, controlla ID sito, Attiva Hotjar, righe di preparazione, consenso analitico/di servizio, risorse locali e richieste bloccate. Prova in un browser cliente. L'assenza di una decisione di consenso sospende il tracciamento anche senza banner MPR installato.
Se manca un evento carrello, verifica il segnale confermato di successo del carrello. Il solo clic sul pulsante carrello non emette questo evento. Adatta le regole personalizzate dopo le modifiche ai selettori del tema.
Se le regole personalizzate non si salvano, controlla JSON, nomi riservati, limiti dei nomi e requisiti dei trigger. Se un acquisto non si ripete ricaricando la conferma, la sua riserva unica per ordine potrebbe essere già consumata.
Questo modulo invia nomi di eventi browser. Non ha token server Hotjar, coda di tentativi o worker cron di invio.
Disattivare o disinstallare
Imposta Attiva Hotjar su No e salva per sospendere il tracciamento mantenendo le impostazioni. Disinstalla dal gestore moduli per rimuovere menu e configurazione del modulo. Gestisci i rapporti già raccolti in Hotjar.
Schermate di riferimento
Usa i nomi delle impostazioni sopra indicati se una schermata di riferimento differisce dalla versione installata.




Domande
Ancora nessuna domanda su questo modulo
Chiedi qualsiasi cosa su installazione, compatibilità o configurazione. Le risposte compaiono qui.
Problemi noti
6
La registrazione continua dopo la revoca del consenso
Le visite del personale e interne finivano nelle registrazioni
Testi tradotti del back office
Il modulo non funziona su PHP 7.1
Le pagine del back office non si aprivano
Compatibilità con le risorse combinate del negozio
Richieste funzionalità
9
Implementato
Eventi automatici del negozio per Hotjar
Eventi e-commerce Hotjar
Eventi Hotjar personalizzati
Verifiche della configurazione Hotjar
Amministrazione multilingue
Gestione della licenza
Aggiornamenti del modulo con un clic
Eventi di contatto e coinvolgimento facoltativi
Report delle conversioni confermate
Registro modifiche
v1.2.02026-10-19
- AddedHotjar Feedback widget support with configurable button label and colour
- Improvedsnippet loading — async and non-blocking to avoid impact on PageSpeed score
- Fixedduplicate Hotjar snippet when module was active in both head and footer hooks
- Addedsite ID validation on save with live API check
Versioni precedenti
v1.1.62026-09-30
- AddedExpand Hotjar event tracking
- Addedcomplete FR/DE/ES/IT/PL translations
v1.4.02026-04-20
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
v1.3.02026-01-14
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- AddedHotjar Surveys widget embed option with configurable survey ID and trigger
- Improvedconsent handling — Hotjar tracking deferred until user accepts analytics cookies
- Fixedrecording not capturing events inside dynamically injected cart popups
- Addedper-controller suppression list to exclude back-office pages from tracking
v1.0.02025-11-11
- Initialrelease: Hotjar tracking script injection for PrestaShop
- InitialSimple Site ID configuration — no code editing required
- InitialAutomatic exclusion of admin and employee sessions from recordings
- InitialCompatible with Hotjar heatmaps, session recordings, and feedback tools
v1.1.02025-06-03
- Addedheatmap tag attributes to key CTA buttons for easier Hotjar annotation
- Improvedcompatibility with PS 8.x strict CSP headers
- Fixedsession recording not resuming after back navigation in single-page checkout
- Addedconfigurable script load delay (0–5 s) to prioritise core page resources
Demo
Prova il modulo completo prima di acquistare
Acquista la licenza in seguito e mantieni le tue impostazioni.
- La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
- Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
- Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.