Hotjar: Einrichtung und Hilfe
Schnellstart
- Laden Sie die ZIP-Datei
mprhotjarüber "Modules > Module Manager > Upload a module" hoch. - Klicken Sie auf "Configure", um Hotjar-Einstellungen zu öffnen.
- Geben Sie die numerische Site-ID Ihrer bestehenden Hotjar-Website ein.
- Prüfen Sie "Exclude employee browsing" und "Respect analytics consent".
- Setzen Sie Hotjar aktivieren auf Ja, lassen Sie die benötigten Standardereignisse aktiviert und speichern Sie.
- Prüfen Sie die Bereitschaftstabelle, öffnen Sie den Shop in einem Kundenbrowser und erteilen Sie über Ihr konfiguriertes Einwilligungswerkzeug die Analyse-Einwilligung.
- 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.




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
Mitarbeiter- und interne Besuche wurden aufgezeichnet
Übersetzte Backoffice-Texte
Modul schlägt unter PHP 7.1 fehl
Backoffice-Seiten ließen sich nicht öffnen
Kompatibilität mit zusammengefassten Shop-Dateien
Funktionsanfragen
9
Implementiert
Automatische Shopereignisse für Hotjar
Hotjar-E-Commerce-Ereignisse
Benutzerdefinierte Hotjar-Ereignisse
Hotjar-Einrichtung prüfen
Mehrsprachige Verwaltung
Lizenzverwaltung
Modulupdates mit einem Klick
Optionale Kontakt- und Interaktionsereignisse
Bestätigte Conversions melden
Ä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.
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.