Hotjar: configurazione e aiuto

Avvio rapido

  1. Carica lo ZIP mprhotjar tramite "Modules > Module Manager > Upload a module".
  2. Fai clic su "Configure" per aprire Impostazioni Hotjar.
  3. Inserisci l’ID sito numerico del tuo sito Hotjar esistente.
  4. Controlla "Exclude employee browsing" e "Respect analytics consent".
  5. Imposta Attiva Hotjar su Sì, lascia attivi gli eventi standard necessari e salva.
  6. Controlla la tabella di preparazione, apri il negozio in un browser cliente e concedi il consenso analitico tramite lo strumento di consenso configurato.
  7. Conferma la richiesta dello script Hotjar e un evento product_view contenente 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.

Hotjar, Eventi azione prodotto Hotjar

Hotjar, Monitor eventi acquisto Hotjar

Hotjar, Frammento Hotjar nel sorgente del negozio

Hotjar, Eventi personalizzati Hotjar nell'amministrazione

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

RisoltoAggiornato:
Risolto nella versione: 1.2.0
Registrazione ed eventi potevano continuare dopo una modifica del consenso analitico. Ora il consenso attuale controlla registrazione ed eventi e la revoca interrompe ulteriori registrazioni.

Le visite del personale e interne finivano nelle registrazioni

RisoltoAggiornato:
Risolto nella versione: 1.2.0
Le visite del personale e interne potevano essere registrate quando le pagine venivano servite dalla cache. Ora queste visite sono escluse.

Testi tradotti del back office

RisoltoAggiornato:
Risolto nella versione: 1.2.0
Alcuni testi del back office restavano in inglese anche quando era selezionata un’altra lingua. Ora le etichette usano le traduzioni disponibili.

Il modulo non funziona su PHP 7.1

RisoltoAggiornato:
Risolto nella versione: 1.1.8
Il modulo poteva non caricarsi nei negozi con PHP 7.1. La compatibilità con la versione PHP supportata è stata ripristinata.

Le pagine del back office non si aprivano

RisoltoAggiornato:
Risolto nella versione: 1.1.7
L’apertura della configurazione del modulo poteva fallire con un errore invece di mostrare le impostazioni. Ora le pagine delle impostazioni si aprono correttamente.

Compatibilità con le risorse combinate del negozio

RisoltoAggiornato:
Risolto nella versione: 1.1.7
Gli script o gli stili del modulo potevano essere esclusi dalla combinazione delle risorse di PrestaShop. Ora funzionano con le impostazioni di prestazioni del negozio.

Richieste funzionalità

9

Implementato

Eventi automatici del negozio per Hotjar

Implementato
Invia gli eventi abilitati di pagina, prodotto, categoria, inizio acquisto, acquisto, ricerca, lista desideri e registrazione tramite Hotjar Events API. Puoi scegliere gli eventi e configurare regole personalizzate nelle impostazioni del modulo.

Eventi e-commerce Hotjar

Implementato
Invia a Hotjar eventi di prodotto, categoria, carrello, lista dei desideri, checkout, ricerca, acquisto e registrazione, con interruttori separati per ogni tipo di evento.

Eventi Hotjar personalizzati

Implementato
Definisci eventi Hotjar aggiuntivi per le interazioni nella vetrina.

Verifiche della configurazione Hotjar

Implementato
Individua le impostazioni Site ID e degli eventi personalizzati mancanti o non valide prima di attivare il tracciamento.

Amministrazione multilingue

Implementato
Usa le impostazioni Hotjar tradotte in tedesco, francese, spagnolo, italiano e polacco.

Gestione della licenza

Implementato
Visualizza e gestisci la licenza del modulo da una pagina dedicata del back office.

Aggiornamenti del modulo con un clic

Implementato
Cerca e installa gli aggiornamenti del modulo dal back office.

Eventi di contatto e coinvolgimento facoltativi

Implementato
Registra facoltativamente eventi di telefono, chat, modulo di contatto e coinvolgimento. Questi segnali aggiuntivi sono disattivati per impostazione predefinita.

Report delle conversioni confermate

Implementato
Comunica le azioni confermate del carrello e della lista dei desideri e verifica se gli acquisti sono già stati segnalati prima di inviare un altro evento.

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.
Avvia il negozio demo

Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.

Aprendo questa demo accetti i termini della demo e la politica sulla privacy.

Caricamento...
Torna su