Der Hotjar-Debug-Modus kann in Ihrem Browser aktiviert werden, um komplexe Probleme zu beheben und zu bestätigen, dass Hotjar korrekt funktioniert. In diesem Artikel wird erklärt, wie der Debug-Modus aktiviert werden kann und welche Anwendungsfälle es dafür gibt.
So aktivieren Sie den Debug-Modus über die URL
Fügen Sie den Debug-Parameter zu Ihrer Seiten-URL hinzu
Um den Debug-Modus zu aktivieren, fügen Sie den folgenden URL-Parameter an das Ende der Seite an, an der Sie arbeiten: ?hjDebug=1
Um zum Beispiel 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
Nachfolgend finden Sie die Schritte, mit denen Sie die Entwicklertools in den folgenden Browsern öffnen können:
- Chrome - klicken Sie in der Menüleiste auf Ansicht > Entwickler > Entwicklertools
- Firefox Klicken Sie in der Menüleiste auf Werkzeuge > Browser-Werkzeuge > Webentwickler-Tools
- Safari - klicken Sie in der Menüleiste auf Entwickeln > JavaScript-Konsole anzeigen
Laden Sie die Seite neu
Wenn Sie die Seite neu laden, nachdem die oben genannten Schritte abgeschlossen sind, können Sie alle Debug-Protokolle sehen, die während des Ladens der Seite aufgetreten sind. Wenn die Konsolenprotokolle angezeigt werden, sehen sie ähnlich aus wie diese:
*Die Debug-Protokolle sind auf der Registerkarte Konsole in den Entwicklertools Ihres Browsers sichtbar.
So aktivieren Sie den Debug-Modus mit Cookies
Öffnen Sie die Entwicklertools Ihres Browsers
Nachfolgend finden Sie die Schritte zum Öffnen der Entwicklertools in den folgenden Browsern:
- Chrome - klicken Sie in der Menüleiste auf Ansicht > Entwickler > Entwicklertools
- Firefox Klicken Sie in der Menüleiste auf Werkzeuge > Browser-Werkzeuge > Webentwickler-Tools
- Safari - klicken Sie in der Menüleiste auf Entwickeln > JavaScript-Konsole anzeigen
Öffnen Sie die Registerkarte Anwendung
Öffnen Sie Ihre Cookies, indem Sie die Registerkarte "Anwendung" auswählen.
Fügen Sie hjDebug als Cookie hinzu
Scrollen Sie zum Ende der Cookies und doppelklicken Sie auf die leere Stelle. Geben Sie dann hjDebug in die Spalte Name ein.
Cookie auf true setzen
Geben Sie in der zweiten Spalte das Wort true ein, um das Cookie zu setzen, und drücken Sie dann ENTER.
Laden Sie die Seite neu
Wenn Sie die Seite neu laden, nachdem die oben genannten Schritte abgeschlossen sind, können Sie alle Debug-Protokolle sehen, die während des Ladens der Seite aufgetreten sind. Wenn die Konsolenprotokolle angezeigt werden, sehen sie ähnlich aus wie diese:
Anwendungsfälle
Der Debug-Modus wird häufig von Entwicklern verwendet, um Ereignisse zu testen und API-Funktionen zu identifizieren. Sie können jedoch auch verwendet werden, um zu sehen, ob die Zielkriterien erfüllt werden, und um zu klären, warum ein Umfrage- oder Feedback-Widget nicht auf einer Seite angezeigt wird. In diesem Abschnitt werden einige Beispiele für die Funktionsweise vorgestellt.
Durchsuchen Sie die Registerkarte Konsole, um relevante Debug-Protokolle zu finden
Sie können Strg+F (Windows) bzw. Befehl+F (Mac) verwenden, um die Registerkarte Konsole nach bestimmten Meldungen zu durchsuchen. Die folgenden Screenshots zeigen Beispiele für Suchbegriffe, die verwendet wurden, um die Anzahl der in der Browser-Konsole sichtbaren Protokolleinträge zu reduzieren.
Ereignis-API
In den Debug-Protokollen wird angezeigt, wenn ein Hotjar-Ereignis erfolgreich im Browser ausgelöst wurde. Wenn ein Ereignis erfolgreich ausgelöst wurde, erscheint eine Bestätigungsmeldung in blauer Farbe, ähnlich der letzten Meldung im Screenshot unten:
COMMAND: Verarbeitungsbefehl: event testEvent
Dabei steht "testEvent" für den eindeutigen Namen des Ereignisses, das ausgelöst wird.
Um dies manuell auszulösen, können Sie Folgendes direkt in Ihre Browser-Konsole eingeben:
hj('event', 'testEvent');
Identify-API
Wenn ein Identify-API-Aufruf von Hotjar empfangen wird, erscheint eine Bestätigungsmeldung in blauer Farbe, ähnlich wie im folgenden Beispielbild:
COMMAND: Befehl wird verarbeitet: identify , {"userAttribute": "value"}
Dabei ist "userAttribute" der Name des empfangenen Attributs und "value" ein mit diesem Attribut verknüpfter Wert.
Sie können manuell einen API-Aufruf an Hotjar senden, indem Sie Folgendes in Ihre Browserkonsole eingeben:
hj('identify', null, {
userAttribute: 'value'
});
Außerdem können Sie Protokolle einsehen, die angeben, ob Attribute geändert wurden oder nicht, indem Sie im Konsolenfenster nach "attribute" suchen. Die Ergebnisse sehen dann ähnlich aus wie hier:
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 hat und wann es auf der Seite gerendert wird.
Wenn Sie zum Beispiel in der Konsole nach "Umfrage" suchen, können Sie Meldungen finden, die sich auf das Tool "Umfragen" beziehen. Im folgenden Beispiel sehen wir, dass eine bestimmte Umfrage (ID: 888238) den Zielkriterien auf der Seite entspricht und Hotjar die Umfrage aufgerufen hat, damit sie auf der Seite erscheint.
In ähnlicher Weise können Sie mit der Suche nach "Feedback" in der Konsole Nachrichten finden, die sich auf das Feedback-Tool beziehen. Im Beispiel unten sehen wir, dass ein bestimmtes Feedback-Widget (ID: 14573) den Zielkriterien auf der Seite entspricht und Hotjar das Feedback-Widget aufgerufen hat, um auf der Seite zu erscheinen.
Suchen Sie nach weiteren Informationen zu einer bestimmten Debug-Protokollmeldung?
Derzeit haben wir keine Referenz für alle möglichen Debug-Protokollmeldungen. Dies ist jedoch etwas, das unser Team in Zukunft erforschen wird, und wir werden dieses Dokument aktualisieren, sobald mehr Informationen zur Verfügung stehen. Wenn Sie Probleme haben, Hotjar-Tools und -Funktionen zum Laufen zu bringen, wenden Sie sich bitte an unser Support-Team, indem Sie die Schaltfläche " Kontakt" unter diesem Artikel verwenden.