Hotjar: Einrichtung und Hilfe

Schnellstart

  1. Laden Sie die ZIP-Datei mprhotjar über "Modules > Module Manager > Upload a module" hoch.
  2. Klicken Sie auf "Configure", um Hotjar-Einstellungen zu öffnen.
  3. Geben Sie die numerische Site-ID Ihrer bestehenden Hotjar-Website ein.
  4. Prüfen Sie "Exclude employee browsing" und "Respect analytics consent".
  5. Setzen Sie Hotjar aktivieren auf Ja, lassen Sie die benötigten Standardereignisse aktiviert und speichern Sie.
  6. Prüfen Sie die Bereitschaftstabelle, öffnen Sie den Shop in einem Kundenbrowser und erteilen Sie über Ihr konfiguriertes Einwilligungswerkzeug die Analyse-Einwilligung.
  7. Bestätigen Sie die Hotjar-Skriptanfrage und ein product_view-Ereignis, das nur den Namen enthält, und prüfen Sie anschließend die Sitzung in Hotjar.

Erfordert PrestaShop 1.6 oder höher und PHP 7.1 oder höher.

Einrichtungsanleitung

Installieren und konfigurieren

Folgen Sie den Schritten im Schnellstart.

Hotjar-Einstellungen

Öffnen Sie "Configure" im Modulmanager. Das Tracking ist anfangs deaktiviert. Erstellen Sie Ihre Website in Hotjar, bevor Sie deren Site-ID eingeben.

Einstellung Standard Ihre Konfiguration
Hotjar aktivieren Nein Aktivieren Sie das Laden im Browser und die Ereignisübermittlung.
Site-ID Leer Geben Sie die numerische Hotjar-Websitekennung ein.
"Exclude employee browsing" Ja Halten Sie das Tracking für als Mitarbeiter markierte Browser zurück. Auch der manuelle Opt-out mpr_notrack=1 gilt.
"Respect analytics consent" Ja Verlangen Sie eine ausdrückliche Analyse-Einwilligung. Ein unbekannter Einwilligungsstatus hält das Tracking zurück.
"Persist consent withdrawal" Nein Aktivieren Sie die private dauerhafte Speicherung authentifizierter Widerrufe.

Das Modul prüft die Einwilligung vor dem Senden. Es unterstützt Cookies Revolution, Cookie Banner, Cookiebot, OneTrust und TCF. Konfigurieren und testen Sie die betreffenden Kategorie- und Dienstentscheidungen in Ihrem Einwilligungswerkzeug. Ohne ausdrückliche Entscheidung bleibt das Tracking zurückgehalten. Eine vom Modul erkannte unterstützte CMP gilt auch bei deaktiviertem Einwilligungsschalter des Moduls.

Hotjar-Ereignisse

Alle folgenden Schalter stehen standardmäßig auf Ja. Deaktivieren Sie Ereignisse, die Sie nicht senden möchten.

Einstellung Auslöser des Ereignisses
"Track page_view event" page_view auf einer erfassten Shopseite.
"Track product_view" product_view auf einer Produktseite.
Kategorieaufrufe erfassen category_view auf einer Kategorieseite.
"Track add_to_cart" add_to_cart nach einer bestätigten erfolgreichen Mengenerhöhung.
"Track add_to_wishlist" add_to_wishlist aus einer unterstützten Erfolgsmeldung der Wunschliste.
"Track checkout_start" checkout_start auf erkannten Einstiegsseiten des nativen oder eines modulbasierten Bestellvorgangs.
"Track search" search auf einer erkannten Suchseite.
"Track purchase" purchase bei der Bestellbestätigung, einmal pro Shop, Bestellung und Ziel beansprucht.
"Track sign_up" sign_up nach der Kontoerstellung über eine private Anfrage zum Besucherkontext.

Hotjar erhält Ereignisnamen über hj('event', 'event_name'). Produkt-IDs, Warenkorbsummen, Suchbegriffe oder Bestelldetails erhält es von dieser Integration nicht als Ereigniseigenschaften.

Kontakt und Produktinteraktion

"Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" und "Track product engagement" stehen standardmäßig auf Nein. Aktivieren Sie nur überprüfbare Signale. Ein Formularereignis benötigt einen serverbestätigten Erfolgsbeleg. Ein Chatereignis benötigt eine unterstützte Meldung über den tatsächlichen Start.

Verwenden Sie "Product engagement thresholds" für JSON-Schwellenwerte und Selektoren. Standardwerte sind 3 Galerieinteraktionen, 1 Variantenwechsel, 1 Detailinteraktion oder 45 Sekunden Verweildauer. Das Drosselintervall für Optionen beträgt standardmäßig 1500 ms. Zulässig sind 1 bis 20 Interaktionen, 5 bis 600 Sekunden und 250 bis 60000 ms für die Drosselung. Behalten Sie high_intent_product_engagement als Ereignisnamen bei. Standardmäßig begrenzt der Tracker dieses Ereignis auf einmal pro Produkt/Sitzung, wenn Tracking-Speicherung erlaubt ist.

Benutzerdefinierte Ereignisse konfigurieren

Benutzerdefinierte Ereignisse erfassen steht standardmäßig auf Nein. Benutzerdefinierte Ereignisregeln ist anfangs leer. Fügen Sie vor dem Aktivieren mindestens eine gültige Regel hinzu.

Verwenden Sie unterschiedliche Namen mit bis zu 250 unterstützten Zeichen: Buchstaben, Zahlen, Unterstriche, Leerzeichen, Punkte, Doppelpunkte, senkrechte Striche, Schrägstriche oder Bindestriche. Sie können bis zu 50 unterschiedliche benutzerdefinierte Namen konfigurieren. Integrierte Handels- und Kontaktnamen sind reserviert.

[
  {"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"}
]

Verwenden Sie selector für Klicks, contains für URL-Fragmente, controllers für Controller-Regeln und dom_event für Browserereignisse. Bei einer Controller-Regel mit modules müssen beide Bedingungen zutreffen. Sie ist kein Modul-Fallback. Eine DOM-Ereignisregel ohne Namen lauscht auf mprhjar:custom. once ist standardmäßig false für Klicks und true für URL-, Controller- und DOM-Ereignisregeln.

Lösen Sie das konfigurierte Ereignis aus Ihrem Theme aus:

document.dispatchEvent(new CustomEvent('mprhjar:size-guide'));

Die Regel sendet nur SizeGuideOpened. params, Beschriftungen, Formularwerte und DOM-Ereignisdetails werden nicht zu Hotjar-Ereigniseigenschaften.

Tracking überprüfen

Öffnen Sie Ihren Shop außerhalb eines ausgeschlossenen Mitarbeiterbrowsers. Prüfen Sie bei erteilter Analyse-Einwilligung die Anfrage an https://static.hotjar.com/c/hotjar-SITE_ID.js?sv=6. Öffnen Sie ein Produkt und eine Kategorie, suchen Sie, fügen Sie erfolgreich ein Produkt hinzu, registrieren Sie ein Konto und geben Sie eine Testbestellung auf. Prüfen Sie die aktivierten Ereignisnamen in den Browserwerkzeugen und Ihrem Hotjar-Konto.

Testen Sie Ablehnung und Widerruf. Prüfen Sie, dass kein anderes Modul oder Theme ein eigenes Hotjar-Skript geladen hat. Die Integration prüft vor dem Senden Zielinhaberschaft, Mitarbeiterstatus, Einwilligung und Seitensicherheit. Heatmaps, Aufzeichnungen und Feedbackberichte bleiben in Hotjar.

Fehlerbehebung

Wenn kein Skript geladen wird, prüfen Sie Site-ID, Hotjar aktivieren, Bereitschaftszeilen, Analyse-/Diensteinwilligung, lokale Ressourcen und blockierte Anfragen. Testen Sie in einem Kundenbrowser. Eine fehlende Einwilligungsentscheidung hält das Tracking auch ohne installiertes MPR-Banner zurück.

Wenn ein Warenkorbereignis fehlt, prüfen Sie das bestätigte Warenkorb-Erfolgssignal. Ein Klick auf die Warenkorbschaltfläche allein löst dieses Ereignis nicht aus. Passen Sie nach Änderungen der Theme-Selektoren Ihre benutzerdefinierten Regeln an.

Wenn sich benutzerdefinierte Regeln nicht speichern lassen, prüfen Sie JSON, reservierte Namen, Namensgrenzen und Auslöseranforderungen. Wird ein Kauf beim erneuten Laden der Bestätigung nicht erneut erfasst, kann die einmalige Ereignisfreigabe pro Bestellung bereits verbraucht sein.

Dieses Modul sendet Browserereignisnamen. Es besitzt weder Hotjar-Servertoken noch Wiederholungswarteschlange oder sendenden Cron-Worker.

Deaktivieren oder deinstallieren

Setzen Sie Hotjar aktivieren auf Nein und speichern Sie, um das Tracking unter Beibehaltung der Einstellungen anzuhalten. Deinstallieren Sie über den Modulmanager, um Menü und Modulkonfiguration zu entfernen. Verwalten Sie bereits gesammelte Berichte in Hotjar.

Referenz-Screenshots

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenz-Screenshot von Ihrer installierten Version abweicht.

Hotjar, Hotjar-Produktaktionsereignisse

Hotjar, Hotjar-Kaufereignismonitor

Hotjar, Hotjar-Ausschnitt im Shop-Quelltext

Hotjar, Benutzerdefinierte Hotjar-Ereignisse im Backoffice

Fragen

Noch keine Fragen zu diesem Modul

Fragen Sie alles zu Installation, Kompatibilität oder Einrichtung. Die Antworten erscheinen hier.

Bekannte Probleme

6

Aufzeichnung läuft nach Widerruf der Einwilligung weiter

GelöstAktualisiert:
Behoben in: 1.2.0
Aufzeichnung und Ereignisse konnten nach einer Änderung der Analyse-Einwilligung weiterlaufen. Jetzt steuert die aktuelle Einwilligung Aufzeichnung und Ereignisse; ein Widerruf stoppt weitere Aufzeichnungen.

Mitarbeiter- und interne Besuche wurden aufgezeichnet

GelöstAktualisiert:
Behoben in: 1.2.0
Mitarbeiter- und interne Besuche konnten bei aus dem Cache ausgelieferten Seiten aufgezeichnet werden. Diese Besuche werden jetzt ausgeschlossen.

Übersetzte Backoffice-Texte

GelöstAktualisiert:
Behoben in: 1.2.0
Einige Backoffice-Texte blieben auch bei Auswahl einer anderen Sprache auf Englisch. Beschriftungen verwenden jetzt die verfügbaren Übersetzungen.

Modul schlägt unter PHP 7.1 fehl

GelöstAktualisiert:
Behoben in: 1.1.8
Das Modul konnte in Shops mit PHP 7.1 nicht geladen werden. Die Kompatibilität mit der unterstützten PHP-Version wurde wiederhergestellt.

Backoffice-Seiten ließen sich nicht öffnen

GelöstAktualisiert:
Behoben in: 1.1.7
Beim Öffnen der Modulkonfiguration konnte ein Fehler statt der Einstellungen erscheinen. Die Einstellungsseiten öffnen sich jetzt korrekt.

Kompatibilität mit zusammengefassten Shop-Dateien

GelöstAktualisiert:
Behoben in: 1.1.7
Modulskripte oder Stile konnten bei der Dateizusammenfassung von PrestaShop ausgelassen werden. Sie funktionieren jetzt mit den Leistungseinstellungen des Shops.

Funktionsanfragen

9

Implementiert

Automatische Shopereignisse für Hotjar

Implementiert
Übermittelt aktivierte Ereignisse zu Seiten, Produkten, Kategorien, Bestellbeginn, Käufen, Suche, Wunschliste und Registrierung über Hotjar Events API. Ereignistypen und eigene Ereignisregeln werden in den Moduleinstellungen konfiguriert.

Hotjar-E-Commerce-Ereignisse

Implementiert
Senden Sie Produkt-, Kategorie-, Warenkorb-, Wunschlisten-, Checkout-, Such-, Kauf- und Registrierungsereignisse an Hotjar, mit separaten Schaltern für jeden Ereignistyp.

Benutzerdefinierte Hotjar-Ereignisse

Implementiert
Definieren Sie zusätzliche Hotjar-Ereignisse für Interaktionen im Shop.

Hotjar-Einrichtung prüfen

Implementiert
Erkennen Sie fehlende oder ungültige Einstellungen für Site ID und benutzerdefinierte Ereignisse, bevor Sie das Tracking aktivieren.

Mehrsprachige Verwaltung

Implementiert
Nutzen Sie übersetzte Hotjar-Einstellungen auf Deutsch, Französisch, Spanisch, Italienisch und Polnisch.

Lizenzverwaltung

Implementiert
Sehen Sie die Modullizenz auf einer eigenen Backoffice-Seite ein und verwalten Sie diese.

Modulupdates mit einem Klick

Implementiert
Suchen Sie im Backoffice nach Modulupdates und installieren Sie diese.

Optionale Kontakt- und Interaktionsereignisse

Implementiert
Erfassen Sie optional Telefon-, Chat-, Kontaktformular- und Interaktionsereignisse. Diese zusätzlichen Signale sind standardmäßig deaktiviert.

Bestätigte Conversions melden

Implementiert
Melden Sie bestätigte Warenkorb- und Wunschlistenaktionen und prüfen Sie vor dem Senden eines weiteren Ereignisses, ob Käufe bereits gemeldet wurden.

Änderungsprotokoll

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
Ältere Versionen

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

Testen Sie das vollständige Modul vor dem Kauf

Kaufen Sie die Lizenz später, Ihre Einstellungen bleiben erhalten.

  • Ihre 30-Tage-Demo Testen Sie es 30 Tage ab der ersten Installation in Ihrem eigenen Shop.
  • Fertiger Demo-Shop Entdecken Sie einen fertigen Demo-Shop im Browser.
  • Ohne Registrierung Kein Konto, keine E-Mail-Adresse und keine Shop-Domain nötig.
Demo-Shop starten

Mit dem Download akzeptieren Sie die Demo-Bedingungen und die Datenschutzerklärung.

Mit dem Öffnen dieser Demo akzeptieren Sie die Demo-Nutzungsbedingungen und die Datenschutzerklärung.

Lade ...
Nach oben