Planverfügbarkeit
Verfügbar für Aufzeichnungen und Heatmaps mit Observe oder Observe
Verfügbar für Aufzeichnungen und Heatmaps mit Observe
Verfügbar für Feedback und Umfragen mit Ask oder Ask
Hotjars Identify-API ermöglicht es Ihnen, Daten über Ihre Benutzer an Hotjar weiterzugeben, indem Sie Javascript verwenden und sie als Benutzerattribute speichern. Diese Benutzerattribute können von Hotjar verwendet werden, um erweiterte Filterung und Segmentierung zu ermöglichen und Ihnen qualitativ hochwertige Einblicke schneller als zuvor zu bieten. Sie können bis zu 100 Benutzerattribute auf jeder Website senden, mit einer beliebigen Anzahl von Benutzern, die mit diesen Attributen verbunden sind.
Benutzerattribute können für das Filtern von Aufzeichnungen und Zielgruppen für Umfragen und Feedback-Widgets verwendet werden, sowie für die Durchführung von Benutzersuche und Löschungsanfragen nach Benutzer-ID.
Folgen Sie den untenstehenden Links, um mehr über Benutzerattribute zu erfahren:
- Übersicht
- Umgang mit Benutzer-IDs
- Aufrufen von Identify
- Benutzerattributwerte
- Umgang mit E-Mail-Adressen
- Beispiele für das Weitergeben von Benutzerattributen an Hotjar
- Verwendung der Identify-API auf rechtlich konforme Weise
- Deaktivieren von Benutzerattributen
- Löschen von Benutzerattributen
- Best Practices
- FAQs
Sie können Benutzerattribute mit Google Tag Manager oder Segment senden
Sie können Benutzerattribute an Hotjar senden, indem Sie Google Tag Manager oder Segment verwenden. Weitere Details finden Sie in unserem Artikel zur Übermittlung von Benutzerattributen mit Google Tag Manager oder wenn Sie Segment verwenden, besuchen Sie unseren Leitfaden zur Verwendung von Hotjar mit Segment.
Übersicht
User-Attribute sind Datenwerte über Benutzer Ihrer Website, die über Hotjars Identify-API von Ihrem Client-Code an Hotjar übermittelt werden. Diese API ist auf allen Seiten verfügbar, die den Hotjar-Tracking-Code enthalten.
Diese Daten werden Hotjar als Schlüssel-Wert-Paare über einen asynchronen AJAX-Aufruf an Hotjars Server übermittelt. Diese Werte sind mit einer Benutzer-ID verknüpft, einem eindeutig identifizierbaren Wert, der Hotjar in Ihrem Code von einem Benutzer-ID-Wert aus Ihrer Benutzerdatenbank übergeben wird. Dies ermöglicht es Hotjar, die über sie gesammelten Daten mit derselben Benutzer-ID zu verknüpfen, die Sie in Ihrer eigenen Datenbank verwenden, sowie Benutzerinformationen abzurufen, die Hotjar über diesen Benutzer gespeichert hat.
Es gibt 4 Phasen im Prozess des Sendens von Benutzerattributen an Hotjar und der Verwendung von ihnen.
- Daten von Ihrer Website abrufen.
- Daten über das Identify-API an Hotjar übermitteln.
- Hotjar speichert die Daten zu jedem Benutzer als Benutzerattribute unter ihrer user_id.
- Sie können nun Hotjar-Tools verwenden, um nach Benutzerattributen zu filtern und sie zu verwenden.
Aufrufen von Identify
Bevor Sie Anrufe an Identify tätigen können, müssen Benutzerattribute in Ihren Hotjar-Einstellungen für jede Website aktiviert sein, für die Sie Benutzerattribute verwenden möchten.
Aktivieren und Deaktivieren von Benutzerattributen
Die Möglichkeit, auf das Identify-API und Benutzerattribute zuzugreifen, wird standardmäßig aktiviert, wenn diese Funktion in Ihrem Hotjar-Plan enthalten ist. Wenn Benutzerattribute in der Vergangenheit jedoch deaktiviert wurden, müssen Sie sie möglicherweise erneut aktivieren, um sie verwenden zu können.
Auf Ihrer Benutzerattribut-Seite (Einstellungen > Benutzerattribute) finden Sie die Website, zu der Sie Benutzerattribute hinzufügen möchten, indem Sie die Auswahl im Dropdown-Menü treffen. Sie sehen etwas Ähnliches wie dies, das den Status Ihrer Benutzerattribut-Implementierung anzeigt:
Sie können Benutzerattribute auch auf dieser Seite deaktivieren. Sobald Sie eine Website mit aktivierten Benutzerattributen ausgewählt haben, klicken Sie auf Benutzerattribute deaktivieren. Nachdem Sie dies getan haben, werden weitere API-Aufrufe blockiert. Die Schaltfläche "Benutzerattribute deaktivieren" wird erst nachdem Benutzerattributdaten von Hotjar empfangen wurden, angezeigt, aber nicht davor.
Alle Berichte, die Benutzerattribute für Targeting-Zwecke verwenden, werden deaktiviert, und Sie können sie nicht wieder aktivieren, es sei denn, Sie ändern ihre Targeting-Optionen oder aktivieren Benutzerattribute erneut.
Wenn Sie verhindern möchten, dass Benutzerattribute in Zukunft gesendet werden, sollten Sie den Identify-API-Code auf Ihrer Website entfernen. Sobald der Code von Ihrer Website gelöscht ist, werden zuvor gesammelte Benutzerattribute weiterhin vorhanden sein, aber sie werden nicht mehr aktualisiert oder neuen Benutzern auf Ihrer Website hinzugefügt.
Der API-Aufruf
Hier ist das Format für einen Aufruf an das Identify-API:
hj('identify', userId, {
user_attribute: value
});
- Der erste Parameter sollte immer den Zeichenfolgenwert "identify" enthalten.
- Der zweite sollte eine Zeichenfolge enthalten, die die Benutzer-ID für einen Benutzer auf Ihrer Website aus Ihrer eigenen Benutzerdatenbank enthält oder null, wenn sie nicht bekannt ist.
- Der dritte ist eine Reihe von Schlüssel-Wert-Paaren innerhalb eines Objekts. Der Schlüssel gibt den Namen des Benutzerattributs an, und der Wert definiert sowohl den Typ eines Benutzerattributs als auch seinen Wert für diesen Benutzer.
Benutzerattributnamen haben eine maximale Länge von 50 Zeichen
Hotjar kann Benutzerattributnamen, die länger als 50 Zeichen sind, nicht ordnungsgemäß verarbeiten.
Die in diesem Aufruf übergebenen Werte müssen aus dem eigenen Code Ihrer Website stammen. Diese Werte können direkt von Ihren Servern abgerufen oder clientseitig generiert werden.
Sobald sie an Hotjar gesendet wurden, werden diese Attribute und die Werte für jeden Benutzer auf den Servern von Hotjar gespeichert. Jedes Mal, wenn ein Aufruf an Identify erfolgt, werden die auf den Servern von Hotjar gespeicherten Werte durch die aktuellsten Werte für diese Attribute ersetzt.
Sie können alle an Hotjar gesendeten Attribute in Ihrer Benutzerattribut-Einstellungsseite nachschlagen. Sie können die Benutzersuche verwenden, um zu überprüfen, welche Werte für einen bestimmten Benutzer auf Ihrer Website übermittelt wurden.
Solange ein Benutzer während seiner Sitzung identifiziert ist, kann Hotjar sowohl Benutzer-IDs als auch Benutzerattribute mit einer Sitzungsaufzeichnung verknüpfen und eine fein abgestimmte Ausrichtung des Feedback-Widgets anbieten, um gezieltes Feedback von bestimmten Benutzern mithilfe von Feedback und Umfragen zu sammeln. Zum Beispiel: "Ich möchte, dass diese Umfrage nur zahlende Kunden anspricht, die vor mehr als 10 Tagen einen Kauf getätigt haben".
Aufzeichnungen werden anhand der zuletzt gesendeten Werte an Hotjar während der Sitzung gespeichert.
Wenn Sie während einer Benutzersitzung mehrere Aufrufe an Identify senden, aktualisiert Hotjar immer mit den aktuellsten Werten. Das bedeutet, dass es wichtig ist, dass Benutzer-IDs und Benutzerattribute bei jedem Aufruf konsistent gesendet werden, damit Hotjar eine Aufzeichnung einem bestimmten Benutzer zuordnen kann.
Umgang mit Benutzer-IDs
Das zweite Argument, das über den Identify-API-Aufruf an Hotjar übergeben wird, sollte eine eindeutig identifizierbare Benutzer-ID aus der eigenen Website-Datenbank sein. Benutzerattribute sind mit dieser Benutzer-ID verknüpft.
Die Benutzer-ID sollte pro Benutzer eindeutig sein, darf jedoch keine persönlichen Informationen enthalten. Es sollte auch ein Wert sein, der sich für diesen Benutzer niemals ändert. Sobald Sie eine Benutzer-ID in Hotjar festgelegt haben, kann sie nicht geändert werden. Wenn sie sich ändert, wird Hotjar dies als einen völlig neuen Benutzer betrachten.
Wenn eine Benutzer-ID bekannt ist, wird die Hotjar-ID des Benutzers mit seiner Benutzer-ID verknüpft. Eine Hotjar-ID ist eine zufällig generierte eindeutige Benutzer-ID, die auf der Hotjar-Site-Ebene erstellt wird. Wenn ein Benutzer beim ersten Besuch einer Website keine Benutzer-ID hat, wird die Hotjar-ID dann mit seiner Benutzer-ID verknüpft, sobald der Aufruf an die Identify-API mit einer Benutzer-ID erfolgt.
Es ist hilfreich, dies anhand eines Beispiels zu verdeutlichen.
Angenommen, wir hätten einen Benutzer, Rachel. Sie besucht die Website 3 Mal auf 2 verschiedenen Geräten.
-
Sitzung A - Rachel besucht radbooks.com auf ihrem Tablet.
- Sie ist noch kein Benutzer der Seite und wird mit einer Hotjar-ID von 123 versehen.
-
Sitzung B - Rachel besucht dann die Seite auf ihrem Handy.
- Sie ist noch kein Benutzer und wird mit einer Hotjar-ID von 456 versehen.
-
Sitzung C - Rachel kehrt von ihrem Handy zur Seite zurück.
- Hotjar erkennt sie anhand der Hotjar-ID 456.
- Dann registriert sie ein Konto.
- Ihr Aufruf von Identify weist ihr eine Benutzer-ID von ABC zu, unter Verwendung derselben Benutzer-ID, die Sie für sie in Ihrer Datenbank haben.
Weil wir sie mit einer Benutzer-ID auf Ihrer Seite verknüpft haben, verbinden wir dann alle Daten, die mit der Hotjar-ID 456 verbunden sind, mit ihrer Benutzer-ID von ABC, auch wenn sie während Sitzung B nicht eingeloggt war.
Wenn Rachel dann in einer vierten Sitzung die Seite auf ihrem Tablet besucht und sich dieses Mal einloggt, verknüpft Hotjar die Daten aus Sitzung A mit Sitzung B und C, um Ihnen ein vollständiges Bild ihrer Interaktionen mit Ihrer Seite zu geben.
Was ist, wenn Sie keine Benutzer-ID haben?
Wenn die Benutzer-ID nicht bekannt ist, müssen Sie einen Wert von null als zweiten Parameter übergeben. Wenn Sie dies tun, werden alle Benutzerattribute, die an die Identify-API übergeben werden, mit der Hotjar-ID des Benutzers verknüpft.
Geben Sie keine persönlich identifizierbaren Informationen als Benutzerattribut ohne Benutzer-ID weiter
Wenn eine Benutzer-ID nicht bekannt ist (durch Übermittlung eines Nullwerts), dürfen keine anderen Benutzerattribute an Hotjar übergeben werden, die persönlich identifizierbare Informationen (PII) enthalten. Ihre Fähigkeit, Benutzerattribute, die mit einem einzelnen Benutzer auf Hotjar verknüpft sind, nachzuschlagen, hängt davon ab, ob Sie in der Lage sind, ihre Benutzer-ID nachzuschlagen. Hotjar hat keine Möglichkeit, diese Daten abzurufen oder zu löschen, es sei denn, Sie löschen die gesamte Website in Hotjar.
Benutzerattributwerte
Sie können die folgenden Werte an einen Benutzerattributschlüssel mit der Identify-API übergeben. Sonderzeichen können derzeit nicht verwendet werden.
Umgang mit E-Mail-Adressen
Derzeit gibt es einen Benutzerattributschlüssel für E-Mail-Adressen: email. E-Mail-Adressen sollten als Zeichenfolgen an email übergeben werden. Zum Beispiel:
hj('identify', userId, {
email: 'test@test.com'
});
Wenn andere Benutzerattribute vom Typ Zeichenfolge eine E-Mail-Adresse enthalten, werden diese abgelehnt, was bedeutet, dass Sie nur `email` verwenden sollten, um E-Mail-Adressen zu übergeben.
E-Mail-Adressen und Benutzer-IDs
user_id kann in Form von E-Mail-Adressen vorliegen. Wenn der Primärschlüssel für Benutzer in Ihrer Datenbank deren E-Mail-Adresse ist, kann dies als user_id verwendet werden. Dies sollte nur als letzter Ausweg verwendet werden. Wenn der Primärschlüssel eines Benutzers in Ihrer Datenbank eine andere Form als eine E-Mail-Adresse hat, sollten Sie diese verwenden.
Weil E-Mail-Adressen sich in der Regel ändern können, behandelt Hotjar einen Benutzer als völlig anderen Benutzer, wenn sich seine E-Mail-Adresse ändert. Dies würde verhindern, dass Sie die Benutzersuche für die ältere E-Mail-Adresse verwenden können, was möglicherweise gegen Ihre Datenschutzanforderungen verstößt.
Beispiele für die Übermittlung von Benutzerattributen an Hotjar
Identifizierung zahlender Kunden
Hier ist ein Beispiel, bei dem wir Hotjar mitteilen möchten, wie viel Geld jemand auf Ihrer Website ausgegeben hat.
hj('identify', userId, {
total_spend: 500
});
Mehrere Attribute können durch Hinzufügen weiterer Schlüssel-Wert-Paare in das Objekt übergeben werden. Vielleicht möchten Sie, dass Hotjar weiß, wann sie zum ersten Mal Kunde wurden?
hj('identify', userId, {
total_spend: 500,
first_purchase: '2019-06-20Z'
});
Hier teilen wir Hotjar mit, dass Ihr Benutzer mit einem ISO8601-Datumsstring Kunde Ihres Dienstes wurde.
Identifizierung von Attributen für nicht identifizierte Benutzer
Manchmal ist es nützlich, Informationen über Benutzer auf Ihrer Website zu verfolgen, auch wenn sie noch keine Benutzer oder zahlende Kunden sind. Angenommen, Sie möchten die Referrer-Quelle und die A-B-Testvariante der Zielseite verfolgen, von der ein potenzieller Lead zu Ihnen gelangt ist:
hj('identify', null, {
ab_test: 'Variante-A',
referrer: 'facebook_paid'
});
Dies wäre nützlich, wenn Sie eine Umfrage gegen Benutzer auf Variante-A richten möchten oder nur gegen diejenigen, die über Facebook-Werbeanzeigen zu Ihnen gekommen sind, zum Beispiel.
Verwendung der Identify-API auf rechtlich konforme Weise
Die Identify-API ist standardmäßig deaktiviert, um es zu vermeiden, versehentlich personenbezogene Daten zu erfassen, bis Sie Datenschutzbedenken angemessen behandelt haben. Durch Aktivieren von Benutzerattributen können Sie die personenbezogenen Daten Ihrer Endbenutzer an Hotjar übermitteln. Wir erwarten, dass Sie Ihre rechtlichen Verpflichtungen bei der Durchführung dieser Aktion anerkennen und Hotjars Datenauftragsverarbeitungsvereinbarung akzeptieren.
Es liegt in Ihrer Verantwortung, diese Funktion auf rechtlich konforme Weise zu verwenden, im Einklang mit den Gesetzen Ihres Landes und der Länder, die Ihre Benutzer besuchen. Besuchen Sie unsere Datenschutzseite, um mehr über Hotjars Ansatz zum Benutzerschutz zu erfahren. Bei der Verwendung von Benutzerattributen sollten Sie sich über Hotjars Nutzungsbedingungen und Akzeptable-Nutzung-Richtlinien im Klaren sein und diesen entsprechen.
Behandlung von Benutzersuche- und Löschungsanfragen
Es ist möglich, die Daten eines Benutzers anhand seiner Benutzer-ID nachzuschlagen und zu löschen. Lesen Sie mehr darüber in unserem Artikel "Wie man die Benutzersuche verwendet". Es ist wichtig zu beachten, dass wenn Sie die Benutzer-ID eines Benutzers und seine E-Mail-Adresse kennen, Sie seine Informationen mit beiden nachschlagen sollten. Dies ist der einzige Weg, um sicherzustellen, dass alle personenbezogenen Informationen, die Hotjar über diesen Benutzer hat, nachgeschlagen und gelöscht wurden.
Deaktivierung von Benutzerattributen
Um zu verhindern, dass weitere Benutzerattribute an Hotjar gesendet werden, sollten Sie die Benutzerattribute deaktivieren.
Solange Benutzerattribute auf Ihrer Website aktiviert sind, sollten Sie den Code auf Ihrer Website entfernen, der sie an Hotjar sendet, wenn Sie verhindern möchten, dass sie in Zukunft gesendet werden. Sobald der Code von Ihrer Website gelöscht ist, werden zuvor gesammelte Benutzerattribute weiterhin vorhanden sein, jedoch nicht mehr aktualisiert oder neuen Benutzern auf Ihrer Website hinzugefügt werden.
Löschen von Benutzerattributen
Benutzerattribute können auf der Benutzerattributverwaltungsseite gelöscht werden, indem Sie auf das Papierkorb-Symbol rechts neben dem Attribut klicken. Nur Teammitglieder mit Berechtigungen 'Lesen & Schreiben' oder höher können Benutzerattribute löschen.
Wenn ein Attribut gelöscht wird, verschwindet es sofort aus der Hotjar-Anwendung. Das Attribut wird jedoch noch 7 Tage lang im Hintergrund gespeichert, bevor es dauerhaft gelöscht wird. Daten, die mit dem Attribut verbunden sind, werden während des 7-tägigen Zeitraums ignoriert. Dies dient dazu, zu verhindern, dass Daten aufgrund von Caching-Problemen gesendet werden.
Wenn Sie ein gelöschtes Attribut erneut erstellen möchten, müssen Sie 7 Tage warten, bevor das Attribut erfolgreich neu erstellt werden kann.
Stellen Sie sicher, dass alle gelöschten Benutzerattribute aus allen Identify-API-Aufrufen entfernt werden
Das Löschen eines Benutzerattributs entfernt es nicht aus vorhandenen Sitzungen oder Antworten, die es enthalten. Das Attribut wird nur aus Filtern und Zielen entfernt. Denken Sie daran, das gelöschte Benutzerattribut aus allen Identify-API-Aufrufen zu entfernen, da es sonst wieder in der Liste auftauchen wird.
Beste Praktiken
Wann API-Aufrufe an Identify gemacht werden sollten
Sie sollten bei jedem der folgenden Fälle Anrufe an Identify tätigen:
- Eine Seite mit den aktuellsten Werten geladen wird (auch wenn sie sich nicht geändert haben).
- Nach einer URL-Änderung in Single-Page-Apps.
- Immer wenn eine Änderung vorgenommen wird. Z.B. wenn Sie den letzten Kauf eines Benutzers in einem Geschäft verfolgen möchten, sollten Sie dieses Benutzerattribut aktualisieren, sobald ein Kauf getätigt wurde.
Jeder Anruf aktualisiert die Benutzerattribute bei Hotjar mit den aktuellsten Werten. Wenn eine Sitzungsaufzeichnung endet, speichert die Aufzeichnung die aktuellsten Werte zum Zeitpunkt des Sitzungsendes. Wenn ein Anruf getätigt wird, aber die Werte nicht aktualisiert wurden, wird die Netzwerkanfrage nicht gesendet, um unnötige AJAX-Anfragen zu vermeiden.
Kombinieren von Identify-API-Aufrufen mit Triggern für die Ausrichtung von Umfragen/Feedback-Widgets
Wenn Sie Events mit der Ausrichtung von Benutzerattributen für Umfragen oder Feedback-Widgets kombinieren möchten, stellen Sie sicher, dass der Identify-Aufruf vor dem Trigger in Ihrer Ausführungsreihenfolge erfolgt, unter Berücksichtigung etwaiger asynchroner Aufrufe an andere Dienste. Wenn der Trigger ausgeführt wird, bevor der Identify-API-Aufruf abgeschlossen ist, wird das Umfrage-/Feedback-Widget nicht angezeigt.
Warten auf API-Aufrufe, bevor Hotjar geladen ist
Wenn dieses Skript vor Ihrem Hotjar-Trackingcode hinzugefügt wird, wird ein Fehler auftreten.
Das hj() Objekt kann nicht aufgerufen werden, bis das Hotjar-Tracking-Code-Tag ausgeführt wurde. Wenn Sie aus irgendeinem Grund auf die Identify API zugreifen, bevor der Tracking-Code ausgeführt wurde, können Sie die folgende Codezeile hinzufügen, bevor die API aufgerufen wird:
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};
Testen von Benutzerattributen
Es gibt einige Möglichkeiten, wie Sie testen können, ob Benutzerattribute über die Identify API korrekt gesendet werden.
- Sobald der Code auf Ihrer Seite live ist und mindestens einmal ausgelöst wurde, können Sie Ihre Benutzerattribut-Einstellungsseite besuchen, um zu sehen, ob das von Hotjar erfasste Benutzerattribut auf Ihrer Seite aktiv ist.
- Sie können den Hotjar Debug-Modus in Ihrem Browser aktivieren, um zu sehen, ob Identify API-Aufrufe während Ihrer Sitzung erfolgreich an Hotjar gesendet werden.
- Für Benutzer mit Nullwert können Sie eine beliebige E-Mail-Adresse verwenden, um zuzustimmen, Feedback zu verknüpfen Antworten über eine Umfrage oder Feedback. Dadurch können Sie sehen, welche Benutzerattribute an nicht identifizierte Benutzer übermittelt werden, was besonders nützlich ist, um zu überprüfen, dass Sie Hotjar nicht versehentlich PII senden. Es ist wichtig zu beachten, dass Benutzer, die nicht zugestimmt haben, Feedback zu verknüpfen, auf diese Weise nicht nachgeschlagen werden können. Daher sollten Sie für Testzwecke ein Feedback-Widget einrichten, um mit Ihrer eigenen E-Mail-Adresse zuzustimmen.