Der Hotjar-Debug-Modus kann in Ihrem Browser aktiviert werden, um komplexe Probleme zu beheben und zu bestätigen, dass Hotjar korrekt funktioniert. Dieser Artikel erläutert, wie der Debug-Modus aktiviert wird, teilt einige häufige Anwendungsfälle mit und bietet Informationen zu spezifischen Debug-Protokollmeldungen.
Scrollen Sie weiter oder klicken Sie auf einen der folgenden Abschnitte, um mehr zu erfahren:
- So aktivieren Sie den Debug-Modus über die URL
- So aktivieren Sie den Debug-Modus mit Cookies
- Anwendungsfälle
- Leitfaden zu Protokollmeldungen
So aktivieren Sie den Debug-Modus über die URL
Fügen Sie den Debug-Parameter zur Seiten-URL hinzu
Der Debug-Modus wird aktiviert, indem der folgende URL-Parameter am Ende der Seite, an der Sie arbeiten, hinzugefügt wird: ?hjDebug=1
Zum Beispiel, um https://www.hotjar.com/blog/ zu debuggen, würden wir stattdessen diese URL verwenden: https://www.hotjar.com/blog/?hjDebug=1
Öffnen Sie die Entwicklertools Ihres Browsers
Hier sind die Schritte, um die Entwicklertools in den folgenden Browsern zu öffnen:
- Chrome - im Menü klicken Sie auf Ansicht > Entwickler > Entwicklertools
- Firefox - im Menü klicken Sie auf Extras > Browser-Tools > Web-Entwicklertools
- Safari - im Menü klicken Sie auf Entwickeln > JavaScript-Konsole anzeigen
Laden Sie die Seite neu
Das Neuladen der Seite, nachdem die oben genannten Schritte abgeschlossen wurden, stellt sicher, dass Sie alle Debug-Protokolle sehen können, die während des Seitenladens aufgetreten sind. Wenn die Konsolenprotokolle erscheinen, sehen sie ähnlich aus wie diese:
*Debug-Protokolle sind im Konsolen-Tab der Entwicklertools Ihres Browsers sichtbar.
So aktivieren Sie den Debug-Modus mit Cookies
Öffnen Sie die Entwicklertools Ihres Browsers
Hier sind die Schritte, um die Entwicklertools in den folgenden Browsern zu öffnen:
- Chrome - Klicken Sie in der Menüleiste auf Ansicht > Entwickler > Entwicklertools
- Firefox - Klicken Sie in der Menüleiste auf Extras > Browser-Tools > Webentwickler-Tools
- Safari - Klicken Sie in der Menüleiste auf Entwickeln > JavaScript-Konsole anzeigen
Öffnen Sie den Anwendungstab
Öffnen Sie Ihre Cookies, indem Sie den Anwendungstab auswählen.
Fügen Sie hjDebug als Cookie hinzu
Scrollen Sie zum Ende der Cookies und doppelklicken Sie in den leeren Bereich. Geben Sie dann hjDebug in die Spalte Name ein.
Setzen Sie das Cookie auf true
Geben Sie im zweiten Feld das Wort true ein, um das Cookie zu setzen, und drücken Sie dann die EINGABETASTE.
Aktualisieren Sie die Seite
Wenn Sie die oben genannten Schritte abgeschlossen haben, aktualisieren Sie die Seite, um sicherzustellen, dass Sie alle Debug-Protokolle sehen können, die während des Seitenladens aufgetreten sind. Wenn die Konsolenprotokolle erscheinen, sehen sie ähnlich aus wie diese:
Anwendungsfälle
Der Debug-Modus wird häufig von Entwicklern verwendet, um Ereignisse und API-Funktionen zu testen. Sie können jedoch auch verwendet werden, um zu überprüfen, ob die Targeting-Kriterien erfüllt sind, und um bei der Fehlersuche zu helfen, wenn ein Umfrage- oder Feedback-Widget nicht auf einer Seite angezeigt wird. Dieser Abschnitt wird einige Beispiele dafür geben, wie es funktioniert.
Suchen Sie im Konsolen-Tab nach relevanten Debug-Protokollen
Sie können Strg+F (Windows) oder Befehl+F (Mac) verwenden, um im Konsolen-Tab nach bestimmten Nachrichten zu suchen. Die folgenden Screenshots zeigen Beispiele für Suchbegriffe, die verwendet wurden, um die Anzahl der im Browser sichtbaren Protokolleinträge zu reduzieren.
Ereignisse API
Die Debug-Protokolle zeigen an, wann ein Hotjar-Ereignis erfolgreich im Browser ausgelöst wurde. Wenn ein Ereignis erfolgreich ausgelöst wurde, erscheint eine Bestätigungsnachricht in Blau, ähnlich wie die letzte Nachricht im folgenden Screenshot:
BEFEHL: Verarbeiten des Befehls: Ereignis testEvent
Wo 'testEvent' den eindeutigen Namen des ausgelösten Ereignisses darstellen würde.
Um dies manuell auszulösen, könnten Sie Folgendes direkt in Ihre Browserkonsole eingeben:
hj('event', 'testEvent');
Identify API
Wenn ein Identify-API-Aufruf von Hotjar empfangen wird, erscheint eine Bestätigungsnachricht in Blau, ähnlich wie im Beispielbild unten:
BEFEHL: Verarbeite Befehl: identify , {"userAttribute":"value"}
Wo "userAttribute" der Name des empfangenen Attributs ist und "value" ein mit diesem Attribut verbundener Wert ist.
Sie können manuell einen API-Aufruf an Hotjar senden, indem Sie Folgendes in Ihre Browserkonsole eingeben:
hj('identify', null, {
userAttribute: 'value'
});
Zusätzlich können Sie Protokolle einsehen, die anzeigen, ob Attribute geändert wurden, indem Sie in der Konsolenansicht nach "attribute" suchen. Die Ergebnisse sehen ähnlich aus wie folgt:
Umfragen und Feedback
Der Debug-Modus kann hilfreich sein, um das Verhalten von Umfrage- und Feedback-Widgets zu verstehen, da er anzeigt, wann ein Tool die Zielkriterien erfüllt und wann es auf der Seite gerendert wird.
Zum Beispiel kann die Suche nach "poll" in der Konsole Ihnen helfen, Nachrichten im Zusammenhang mit dem Umfragen-Tool zu finden. Im folgenden Beispiel sehen wir, dass eine bestimmte Umfrage (ID: 888238) die Zielkriterien auf der Seite erfüllt hat und Hotjar die Umfrage aufgerufen hat, um auf der Seite angezeigt zu werden.
Ebenso ermöglicht die Suche nach "feedback" in der Konsole das Auffinden von Nachrichten im Zusammenhang mit dem Feedback-Tool. Im folgenden Beispiel sehen wir, dass ein bestimmtes Feedback-Widget (ID: 14573) die Zielkriterien auf der Seite erfüllt hat und Hotjar das Feedback-Widget aufgerufen hat, um auf der Seite angezeigt zu werden.
Leitfaden für Protokollnachrichten
Derzeit haben wir keine umfassende Liste aller möglichen Debug-Protokollnachrichten. Dies ist jedoch etwas, das unser Team in Zukunft erkunden wird, und wir werden dieses Dokument aktualisieren, sobald weitere Informationen verfügbar sind. Wenn Sie Schwierigkeiten haben, Hotjar-Tools und -Funktionen zum Laufen zu bringen, wenden Sie sich bitte über die Schaltfläche Kontaktieren Sie uns unter diesem Artikel an unser Support-Team.
Fehler in der Content-Security-Policy
Wenn Sie Fehler bemerken, die Hotjar-Domains (hotjar.com, hotjar.io usw.) erwähnen und sich auf "Content-Security-Policy" beziehen, sollten Sie diesen Artikel konsultieren, um Schritte zur Behebung zu erhalten.
Die folgende Tabelle enthält einige häufige Hotjar Debug-Protokollnachrichten, auf die Sie beim Verwenden von Hotjar auf Ihrer Website stoßen könnten:
Sitzungsaufzeichnungsprotokolle
| Protokollmeldung | Bedeutung |
| WEBSOCKET: Verbindung zum Websocket [wss://wsp4.hotjar.com/api/v2/client/ws] wird hergestellt | Hotjar versucht, ein Websocket auf der Seite zu öffnen. |
| WEBSOCKET: Websocket geöffnet | Bestätigung, dass das Websocket erfolgreich geöffnet wurde. |
| WEBSOCKET: Daten werden an das Websocket gesendet: | Bestätigung, dass das Websocket Daten von der Seite empfängt. Dies ist erforderlich, damit Sitzungsdaten von Aufzeichnungen und Heatmaps erfasst werden können. |
Benutzerattribute und Ereignisprotokolle
| Protokollmeldung | Bedeutung |
| COMMAND: Verarbeiten des Befehls: identifizieren , {"Benutzerattribut":"Wert"} | Ein Identify-API-Aufruf wurde erkannt. Im Beispiel der Nachricht links wurde ein Benutzerattribut namens Benutzerattribut mit einem Wert von Wert gesendet. |
| USERATTRIBUTES: Keine laufende Aufzeichnung. Nicht senden. | Ein Identify-API-Aufruf wurde erkannt, aber die Sitzung des Benutzers wird von Hotjar nicht verfolgt. Dies kann passieren, wenn Ihre Website Stichproben durchführt. |
| COMMAND: Befehl "identifizieren" aufgrund von Opt-out blockiert | Diese Meldung hängt normalerweise mit den Do Not Track (DNT)-Einstellungen des Browsers zusammen. Wenn DNT aktiviert ist, verwirft Hotjar alle Benutzerattribute für die Sitzung. |
| USERATTRIBUTES: Benutzerattribute über Websocket gesendet.: (Für Attribute erweitern) | Benutzerattribute werden erkannt und an Hotjar-Server gesendet. |
| USERATTRIBUTES: API-Aufruf zur Validierung von Benutzerattributen fehlgeschlagen.: | Der Aufruf des Identify-API ist fehlgeschlagen, erweitern Sie die Nachricht, um den Grund zu sehen. Zum Beispiel: "Benutzer hat keine user_id oder Attribute." |
| COMMAND: Verarbeiten des Befehls: Ereignis Aktionsname | Ein Hotjar-Ereignis wurde auf der Seite ausgelöst. Im Beispiel der Nachricht links war der Ereignisname Aktionsname. |
Umfragen und Feedback-Protokolle
| Log-Nachricht | Bedeutung |
| UMFRAGE: Umfrage #xxxxxx wurde gefunden. | Eine Umfrage auf der Seite entspricht den Zielkriterien. Die Nummer #xxxxxx bezieht sich auf die Umfrage-ID innerhalb von Hotjar. Mehrere Tools könnten auf derselben Seite übereinstimmen. |
| DARSTELLUNG: Aufruf des aktiven Elements (Umfrage): x | Hotjar initiiert eine passende Umfrage, die auf der Seite erscheinen soll. Der Wert von x wird sofort, Verzögerung, Abbruch oder Scroll je nach Verhaltenskonfiguration der Umfrage sein. |
| UMFRAGE: Umfrage-Widget wird dargestellt. | Die Umfrage sollte jetzt auf der Live-Seite sichtbar sein. |
| RÜCKMELDUNG: Feedback-Widget #xxxxxx wurde gefunden. | Ein Feedback-Widget auf der Seite entspricht den Zielkriterien. Die Nummer #xxxxxx bezieht sich auf die Widget-ID innerhalb von Hotjar. Mehrere Tools könnten auf derselben Seite übereinstimmen. |
| DARSTELLUNG: Aufruf des aktiven Elements (Feedback): x | Hotjar initiiert ein passendes Feedback-Widget, das auf der Seite erscheinen soll. Der Wert von x wird sofort oder Verzögerung je nach Verhaltenskonfiguration des Feedback-Widgets sein. |
| DARSTELLUNG: Aufruf des aktiven Elements (Feedback): sofort | Hotjar ruft ein passendes Feedback-Widget auf, das auf der Seite erscheinen soll. |
| UMFRAGE: Umfrage wurde bereits abgeschickt. | Die Umfrage entsprach den Zielkriterien, ist jedoch so konfiguriert, dass sie nicht mehr angezeigt wird, nachdem der Benutzer bereits geantwortet hat. |