Tutta la documentazione

Hotjar — Documentazione

Hotjar for PrestaShop aggiunge al tuo storefront il tracciamento Hotjar e gli eventi della Browser Events API, così puoi analizzare heatmap, registrazioni, feedback e azioni di acquisto importanti direttamente dalla dashboard Hotjar. Ti aiuta a capire dove gli acquirenti cliccano, scorrono, esitano, cercano, aggiungono prodotti, avviano il checkout e completano gli ordini.

Funzionalità

  • Inserimento dello script Hotjar. Il modulo carica Hotjar da displayHeader dopo che il tracciamento è stato attivato e una Hotjar Site ID numerica è stata salvata.
  • Validazione della Site ID numerica. Il modulo di configurazione blocca le Site ID non valide e mostra un avviso di configurazione obbligatoria finché il negozio non è pronto.
  • Caricamento consapevole del consenso. Hotjar può attendere il consenso marketing da mprcookiesrevolution o mprcookiebanner prima di caricare lo script nel browser.
  • Esclusione delle sessioni dei dipendenti. Le visite allo storefront da parte degli amministratori possono essere escluse, così la tua navigazione non sporca le registrazioni.
  • Eventi standard dello storefront. Il modulo può inviare page_view, product_view, category_view, add_to_cart, add_to_wishlist, checkout_start, search, purchase e sign_up.
  • Interruttori per singolo evento. Ogni tipo di evento standard può essere attivato o disattivato dalla configurazione del modulo.
  • Tracciamento della conferma d’ordine. L’hook displayOrderConfirmation invia l’evento purchase quando è disponibile un ordine valido.
  • Tracciamento delle registrazioni. L’hook actionCustomerAccountAdd registra la creazione di un nuovo account e invia sign_up nella pagina storefront successiva.
  • Regole evento JSON personalizzate. Puoi attivare eventi Hotjar da clic su selettori CSS, regole sul percorso URL, controller, controlli fallback sul nome del modulo o eventi DOM personalizzati.
  • Diagnostica di prontezza. La pagina di configurazione nel Back Office mostra lo stato di Site ID, tracciamento browser, protezione del consenso, eventi standard, eventi personalizzati e API lato server.
Hotjar — Hotjar demo monitor Hotjar — Admin integrity tab

Opzioni di configurazione

Configura queste opzioni in Modules > Module Manager > Hotjar > Configure.

  • Attiva Hotjar. Attiva o disattiva il codice di tracciamento Hotjar sullo storefront e le chiamate Events API; predefinito: 0.
  • Site ID. Memorizza la Hotjar Site ID numerica da Hotjar Sites & Organizations; predefinito: ``.
  • Escludi sessioni dipendenti. Impedisce il tracciamento quando un dipendente collegato al Back Office naviga nello storefront; predefinito: 1.
  • Rispetta il consenso marketing. Carica Hotjar solo dopo il consenso marketing quando mprcookiesrevolution o mprcookiebanner è installato e attivo; predefinito: 1.
  • Traccia visualizzazioni pagina. Invia page_view sulle pagine storefront tracciate; predefinito: 1.
  • Traccia visualizzazioni prodotto. Invia product_view sulle pagine prodotto quando il prodotto corrente può essere rilevato; predefinito: 1.
  • Traccia visualizzazioni categoria. Invia category_view sulle pagine categoria quando la categoria corrente può essere rilevata; predefinito: 1.
  • Traccia aggiunta al carrello. Invia add_to_cart dai clic comuni sui pulsanti di aggiunta al carrello, inclusi .add-to-cart e data-button-action="add-to-cart"; predefinito: 1.
  • Traccia aggiunta alla wishlist. Invia add_to_wishlist dai clic comuni sui pulsanti wishlist; predefinito: 1.
  • Traccia avvio checkout. Invia checkout_start nel checkout nativo e nelle rotte checkout note, inclusi percorsi carrello aggiuntivi di mprcheckoutrevolution; predefinito: 1.
  • Traccia ricerche. Invia search sulle pagine di ricerca rilevate quando è disponibile un termine di ricerca. Il rilevamento della pagina di ricerca controlla controller selezionati, s o search_query; predefinito: 1.
  • Traccia acquisti. Invia purchase nella pagina di conferma ordine tramite displayOrderConfirmation; predefinito: 1.
  • Traccia registrazioni. Invia sign_up dopo la creazione di un nuovo account cliente; predefinito: 1.
  • Traccia eventi personalizzati. Attiva il motore di regole JSON per gli eventi personalizzati; predefinito: 0.
  • Regole eventi personalizzate. Memorizza l’array JSON usato per gli eventi Hotjar personalizzati; predefinito: ``.
Hotjar — Hotjar product action events Hotjar — Admin tracking readiness table

Esempi di personalizzazione

Invia un evento Hotjar quando un acquirente clicca sull’immagine principale del prodotto:

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-cover img",
    "label": "Gallery browse"
  }
]

Invia un evento Hotjar quando il percorso URL contiene /checkout:

[
  {
    "event": "CheckoutPathViewed",
    "trigger": "url",
    "contains": ["/checkout"]
  }
]

Invia un evento sulle pagine prodotto in base al nome del controller:

[
  {
    "event": "ProductPageViewed",
    "trigger": "controller",
    "controllers": ["product"]
  }
]

Invia un evento sui controller checkout nativi oppure, se quei nomi controller non corrispondono, su una rotta front module di mprcheckoutrevolution:

[
  {
    "event": "CheckoutFlowViewed",
    "trigger": "controller",
    "controllers": ["order", "orderopc"],
    "modules": ["mprcheckoutrevolution"]
  }
]

Ascolta un evento browser personalizzato dal tuo tema o da un altro modulo:

[
  {
    "event": "SizeGuideOpened",
    "trigger": "event",
    "dom_event": "mprhjar:size-guide",
    "params": {
      "placement": "product_page"
    }
  }
]

Genera quell’evento browser da uno script del tema:

document.dispatchEvent(new CustomEvent('mprhjar:size-guide', {
  detail: {
    source: 'size_guide_button'
  }
}));

Hotjar riceve il nome dell’evento tramite la Browser Events API:

hj('event', 'add_to_cart');
Hotjar — Hotjar purchase event monitor Hotjar — Storefront source hotjar snippet

Installazione

  1. Nel tuo Back Office, vai su Modules > Module Manager.
  2. Clicca su Upload a module e seleziona il file ZIP del modulo.
  3. Una volta installato, clicca su Configure.
  4. Inserisci la tua Hotjar Site ID numerica.
  5. Attiva il tracciamento Hotjar.
  6. Salva e controlla la tabella di prontezza del tracciamento Hotjar nella pagina del modulo.
Hotjar — Admin hotjar custom events

Come funziona

Il modulo registra displayHeader, displayOrderConfirmation e actionCustomerAccountAdd. Nell’header dello storefront prepara il runtime Hotjar, carica Hotjar in modo asincrono da https://static.hotjar.com/c/hotjar-{SITE_ID}.js?sv=6 e invia tramite browser gli eventi abilitati a livello pagina o basati sui clic.

Nel Back Office vedi un modulo impostazioni Hotjar e una tabella di prontezza. In Hotjar vedi le normali heatmap Hotjar, registrazioni, strumenti di feedback e filtri evento; i report restano nel tuo account Hotjar.

Hotjar — Admin config custom events

Limiti dichiarati

La Browser Events API di Hotjar riceve solo nomi di eventi, come purchase o add_to_cart. Il modulo prepara dettagli e-commerce come ID prodotto, valore, valuta, termine di ricerca e dati ordine per il monitoraggio demo locale, ma Hotjar riceve solo il nome pulito dell’evento.

Il modulo non memorizza heatmap Hotjar, registrazioni, feedback o dati dei sondaggi sul tuo server PrestaShop. Inoltre non fornisce token server, coda di ritentativi o worker cron, perché qui il tracciamento eventi Hotjar avviene lato browser.

Se non è installato alcun modulo di consenso MPR supportato, la protezione del consenso non blocca Hotjar da sola. Per la conformità GDPR e privacy, il tuo banner cookie e la tua privacy policy devono comunque coprire Hotjar per il tuo mercato.

Hotjar — Admin config events

Domande frequenti

Il modulo memorizza le registrazioni Hotjar in PrestaShop?

No. Il modulo carica Hotjar e invia nomi di eventi browser. Heatmap, registrazioni, feedback e report Hotjar sono gestiti nel tuo account Hotjar.

Devo menzionare Hotjar nella mia cookie policy?

Sì. Hotjar imposta cookie e raccoglie dati comportamentali. Per i negozi UE, dichiara Hotjar nella tua privacy e cookie policy e usa il blocco tramite consenso prima di caricare analytics o tracciamento comportamentale.

Il modulo può attendere il consenso ai cookie?

Sì, quando la gestione del consenso è attiva e un modulo di consenso MPR è installato. Il modulo supporta mprcookiesrevolution e mprcookiebanner.

Hotjar riceve ID prodotto, totali ordine o dati cliente da questo modulo?

No. Hotjar riceve solo il nome dell’evento. Il payload e-commerce del modulo viene usato per la verifica demo locale, non come proprietà degli eventi Hotjar.

Hotjar rallenterà il mio negozio?

Lo script Hotjar viene caricato in modo asincrono dal dominio Hotjar, quindi non dovrebbe bloccare il rendering della pagina. Come per qualsiasi script di terze parti, dovresti comunque verificare le prestazioni con i tuoi normali strumenti di test della velocità.

Compatibilità: da PrestaShop 1.6 a 9.0 (latest), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.

Hotjar — Admin config top
Torna su