Disponibilité du plan
Disponible pour les enregistrements et les cartes thermiques avec Observe 
ou Observe 
Disponible pour les enregistrements et les cartes thermiques avec Observe
Disponible pour les retours et les enquêtes avec Ask ou Ask
L'API d'identification de Hotjar vous permet de transmettre des données sur vos utilisateurs à Hotjar en utilisant Javascript, en les enregistrant en tant que Attributs utilisateur. Ces Attributs utilisateur peuvent être utilisés par Hotjar pour permettre un filtrage et une segmentation avancés, vous fournissant des informations de qualité plus rapidement qu'auparavant. Vous pouvez envoyer jusqu'à 100 attributs utilisateur sur n'importe quel site, avec n'importe quel nombre d'utilisateurs associés à ces attributs.
Les Attributs utilisateur peuvent être utilisés pour filtrer les enregistrements et cibler les enquêtes et les widgets de retour, ainsi que pour effectuer des demandes de recherche et de suppression d'utilisateurs par ID utilisateur.
Suivez les liens ci-dessous pour en savoir plus sur les Attributs utilisateur :
- Aperçu
- Gestion des ID utilisateur
- Passer des appels à Identify
- Valeurs des attributs utilisateur
- Gestion des adresses e-mail
- Exemples de transmission d'attributs utilisateur à Hotjar
- Utiliser l'API d'identification de manière conforme à la loi
- Désactiver les attributs utilisateur
- Supprimer les attributs utilisateur
- Meilleures pratiques
- FAQ
Vous pouvez envoyer des attributs utilisateur en utilisant Google Tag Manager ou Segment
Il est possible de commencer à envoyer des attributs utilisateur à Hotjar en utilisant Google Tag Manager ou Segment. Pour plus de détails, consultez notre article Comment envoyer des attributs utilisateur avec Google Tag Manager, ou si vous utilisez Segment, consultez notre guide Utiliser Hotjar avec Segment.
Aperçu
Les attributs utilisateur sont des valeurs de données sur les utilisateurs de votre site transmises à Hotjar depuis votre code côté client via l'API d'identification de Hotjar. Cette API est disponible sur toutes les pages contenant le Code de suivi Hotjar.
Ces données sont transmises à Hotjar sous forme de paires clé-valeur via un appel AJAX asynchrone aux serveurs de Hotjar. Ces valeurs sont associées à un ID utilisateur, une valeur identifiable de manière unique transmise à Hotjar dans votre code à partir d'une valeur d'ID utilisateur de votre base de données utilisateur. Cela permet à Hotjar d'associer les données collectées à leur sujet avec le même ID utilisateur que vous utilisez dans votre propre base de données, ainsi que de rechercher les informations utilisateur détenues par Hotjar à propos de cet utilisateur.
Il y a 4 phases dans le processus d'envoi des attributs utilisateur à Hotjar et de les utiliser avec Hotjar.
- Obtenez les données de votre site.
- Transmettez les données à Hotjar via l'API d'identification.
- Hotjar stocke les données sur chaque utilisateur en tant qu'attributs utilisateur associés à leur user_id.
- Vous pouvez maintenant utiliser les outils Hotjar pour cibler et filtrer par attributs utilisateur.
Effectuer des appels à l'identification
Avant de pouvoir commencer à effectuer des appels à l'identification, les attributs utilisateur doivent être activés dans vos paramètres Hotjar pour chaque site avec lequel vous souhaitez utiliser les attributs utilisateur.
Activation et désactivation des attributs utilisateur
La possibilité d'accéder à l'API d'identification et aux attributs utilisateur sera activée par défaut si cette fonctionnalité est incluse dans votre plan Hotjar. Cependant, si les attributs utilisateur ont été désactivés dans le passé, vous devrez peut-être les réactiver pour les utiliser.
Sur votre page des attributs utilisateur (Paramètres > Attributs utilisateur), trouvez le Site auquel vous souhaitez ajouter des attributs utilisateur en utilisant le menu déroulant de sélection. Vous verrez quelque chose comme ceci montrant l'état de votre implémentation des attributs utilisateur :
Vous avez également la possibilité de désactiver les attributs utilisateur sur cette page. Une fois que vous avez sélectionné un Site avec les attributs utilisateur activés, cliquez sur Désactiver les attributs utilisateur. Une fois que vous avez fait cela, les appels ultérieurs à l'API seront bloqués. Le bouton "Désactiver les attributs utilisateur" n'apparaîtra qu'après que les données des attributs utilisateur ont été reçues par Hotjar, mais pas avant.
Tous les rapports qui dépendent des attributs utilisateur à des fins de ciblage seront désactivés, et vous ne pourrez pas les réactiver à moins de modifier leurs options de ciblage ou de réactiver les attributs utilisateur.
Si vous souhaitez empêcher l'envoi d'attributs utilisateur à l'avenir, vous devriez supprimer le code de l'API d'identification sur votre site. Une fois que le code est supprimé de votre site, les attributs utilisateur collectés précédemment existeront toujours, mais ils ne seront plus mis à jour ni ajoutés aux nouveaux utilisateurs de votre site.
L'appel API
Voici le format d'un appel à l'API d'identification :
hj('identify', userId, {
user_attribute: value
});
- Le premier paramètre doit toujours contenir la valeur de chaîne "identifier".
- Le deuxième doit être une chaîne contenant l'identifiant de l'utilisateur pour un utilisateur sur votre site, à partir de votre propre base de données d'utilisateurs, ou null s'il n'est pas connu.
- Le troisième est une série de paires clé-valeur à l'intérieur d'un objet. La clé fournit le nom de l'attribut utilisateur, et la valeur définit à la fois le type d'attribut utilisateur et sa valeur pour cet utilisateur.
Les noms d'attributs utilisateur ont une longueur maximale de 50 caractères
Hotjar ne pourra pas ingérer correctement les noms d'attributs utilisateur de plus de 50 caractères.
Les valeurs transmises dans cet appel doivent provenir de la base de code de votre site. Ces valeurs peuvent être extraites directement de vos serveurs ou générées côté client.
Une fois envoyées à Hotjar, ces attributs et les valeurs pour chaque utilisateur sont stockés sur les serveurs de Hotjar. Chaque fois qu'un appel à Identifier est effectué, les valeurs stockées sur les serveurs de Hotjar seront remplacées par les valeurs les plus récentes pour ces attributs.
Vous pouvez consulter tous les attributs envoyés à Hotjar dans votre page de paramètres des attributs utilisateur. Vous pouvez utiliser la fonction de recherche d'utilisateur pour inspecter les valeurs qui ont été transmises pour un utilisateur spécifique sur votre site.
Dès qu'un utilisateur est identifié pendant sa session, Hotjar est alors capable d'associer à la fois les identifiants d'utilisateur et les attributs d'utilisateur à un enregistrement de session, et d'offrir un ciblage précis du widget de feedback, vous permettant de recueillir des retours ciblés de certains utilisateurs à l'aide de Feedback et de Surveys. Par exemple : "Je veux que cette enquête cible uniquement les clients payants qui ont effectué un achat il y a plus de 10 jours".
Les enregistrements seront sauvegardés avec les valeurs les plus récentes envoyées à Hotjar pendant la session.
Si vous envoyez plusieurs appels à Identifier pendant la session d'un utilisateur, Hotjar mettra toujours à jour avec les valeurs les plus récentes. Il est donc important que les identifiants d'utilisateur et les attributs d'utilisateur soient envoyés de manière cohérente à chaque appel, permettant à Hotjar de connecter un enregistrement à un utilisateur spécifique.
Gestion des identifiants d'utilisateur
Le deuxième argument transmis à Hotjar via l'appel API Identifier doit être un identifiant d'utilisateur unique provenant de la base de données de votre propre site. Les attributs utilisateur sont associés à cet identifiant d'utilisateur.
L'identifiant d'utilisateur doit être unique par utilisateur mais ne doit pas contenir en lui-même des informations personnelles. Il doit également être une valeur qui ne change jamais pour cet utilisateur. Une fois que vous avez défini un identifiant d'utilisateur dans Hotjar, il ne peut pas être modifié. S'il change, Hotjar considérera qu'il s'agit d'un nouvel utilisateur.
Si un identifiant d'utilisateur est connu, l'identifiant Hotjar de l'utilisateur sera associé à son identifiant d'utilisateur. Un identifiant Hotjar est un identifiant utilisateur unique généré de manière aléatoire, créé au niveau du site Hotjar. Si un utilisateur n'a pas d'identifiant d'utilisateur lorsqu'il visite un site initialement, alors l'identifiant Hotjar sera associé à son identifiant d'utilisateur une fois l'appel à l'API Identifier avec un identifiant d'utilisateur est effectué.
Il est utile d'illustrer cela avec un exemple.
Disons que nous avions un utilisateur, Rachel. Elle visite le site 3 fois sur 2 appareils différents.
-
Session A - Rachel visite radbooks.com sur sa tablette.
- Elle n'est pas encore une utilisatrice du site et se voit attribuer un ID Hotjar de 123
-
Session B - Rachel visite ensuite le site sur son mobile.
- Elle n'est pas encore une utilisatrice et se voit attribuer un ID Hotjar de 456
-
Session C - Rachel revient sur le site depuis son mobile.
- Hotjar la reconnaît avec l'ID Hotjar de 456.
- Elle crée ensuite un compte.
- Votre appel à Identify lui attribue un ID utilisateur de ABC, en utilisant le même ID utilisateur que vous avez pour elle dans votre base de données.
Étant donné que nous l'avons associée à un ID utilisateur sur votre site, nous connectons ensuite toutes les données associées à l'ID Hotjar 456 avec son ID utilisateur ABC, même si elle n'était pas connectée lors de la Session B.
Si Rachel visite ensuite le site sur sa tablette lors d'une 4e session, et se connecte cette fois-ci, Hotjar va alors regrouper les données des Sessions A, B et C, vous offrant une vue complète de ses interactions avec votre site.
Que se passe-t-il si vous n'avez pas d'ID utilisateur ?
Si l'ID utilisateur n'est pas connu, vous devez alors transmettre une valeur nulle au deuxième paramètre. Lorsque vous faites cela, toutes les attributs utilisateur transmis à l'API Identify seront associés à l'ID Hotjar de l'utilisateur.
Ne transmettez pas d'informations personnelles identifiables en tant qu'attribut utilisateur sans ID utilisateur
Si un ID utilisateur n'est pas connu (en transmettant une valeur nulle), alors tout autre attribut utilisateur transmis à Hotjar ne doit pas contenir d'informations personnellement identifiables (PII). Votre capacité à rechercher des attributs utilisateur associés à un utilisateur individuel sur Hotjar dépend de votre capacité à rechercher leur ID utilisateur. Hotjar n'a aucun moyen de récupérer ou supprimer ces données à moins de supprimer l'ensemble du site dans Hotjar.
Valeurs des attributs utilisateur
Vous pouvez transmettre les valeurs suivantes à une clé d'attribut utilisateur en utilisant l'API Identify. Les caractères spéciaux ne peuvent pas être utilisés pour le moment.
Gestion des adresses e-mail
Actuellement, il existe une clé d'attribut utilisateur pour les adresses e-mail : email. Les adresses e-mail doivent être transmises en tant que chaînes à email. Par exemple :
hj('identify', userId, {
email: 'test@test.com'
});
Si d'autres attributs utilisateur de type chaîne contiennent une adresse e-mail, ils seront rejetés, ce qui signifie que vous ne devriez utiliser que `email` pour transmettre des adresses e-mail.
Adresses e-mail et identifiants d'utilisateur
user_id peut prendre la forme d'adresses e-mail, donc si la clé primaire de votre base de données pour les utilisateurs est leur adresse e-mail, cela peut être utilisé comme user_id. Cela ne devrait être utilisé qu'en dernier recours. Si la clé primaire d'un utilisateur dans votre base de données est autre chose qu'une adresse e-mail, vous devriez utiliser cette valeur.
Étant donné que les adresses e-mail peuvent généralement changer, si leur adresse e-mail est mise à jour, Hotjar considérera cet utilisateur comme un utilisateur totalement différent. Cela vous empêcherait d'utiliser la recherche d'utilisateur sur l'ancienne adresse e-mail, ce qui pourrait être contraire à vos exigences en matière de confidentialité.
Exemples de transmission d'attributs d'utilisateur à Hotjar
Identification des clients payants
Voici un exemple où nous voulons indiquer à Hotjar combien quelqu'un a dépensé sur votre site.
hj('identify', userId, {
total_spend: 500
});
Plusieurs attributs peuvent être transmis en ajoutant d'autres paires clé-valeur dans l'objet. Peut-être que vous vouliez que Hotjar sache quand ils sont devenus clients pour la première fois ?
hj('identify', userId, {
total_spend: 500,
first_purchase: '2019-06-20Z'
});
Ici, nous indiquons à Hotjar que votre utilisateur est devenu client de votre service en utilisant une chaîne de date ISO8601.
Identification des attributs pour les utilisateurs dé-identifiés
Parfois, il est utile de suivre des informations sur les utilisateurs de votre site, même s'ils ne sont pas encore des utilisateurs ou des clients payants. Disons que vous vouliez suivre la source de référence et la variante du test A-B de la page d'atterrissage à partir de laquelle un lead potentiel vous a rejoint :
hj('identify', null, {
ab_test: 'variant-A',
referrer: 'facebook_paid'
});Cela serait utile si vous vouliez cibler une enquête auprès des utilisateurs de la variante-A, ou uniquement ceux qui sont venus de publicités payantes sur Facebook, par exemple.
Utilisation de l'API Identify de manière conforme à la loi
L'API Identify est désactivée par défaut, ce qui permet d'éviter de capturer accidentellement des informations personnelles jusqu'à ce que vous ayez traité correctement les préoccupations en matière de confidentialité. En activant les attributs d'utilisateur, vous pourriez transmettre les données personnelles de vos utilisateurs à Hotjar. Nous exigeons que vous reconnaissiez vos obligations légales lorsque vous le faites et acceptiez l'Accord de traitement des données de Hotjar.
Il est de votre responsabilité d'utiliser cette fonctionnalité de manière conforme à la loi, en conformité avec les lois de votre pays et des pays visités par vos utilisateurs. Consultez notre page de confidentialité pour en savoir plus sur l'approche de Hotjar en matière de confidentialité des utilisateurs. Lors de l'utilisation des attributs d'utilisateur, vous devez être conscient et vous conformer aux Conditions d'utilisation et à la Politique d'utilisation acceptable de Hotjar.
Gestion des demandes de recherche et de suppression d'utilisateur
Il est possible de rechercher et de supprimer les données d'un utilisateur en utilisant leur identifiant d'utilisateur. En savoir plus à ce sujet dans notre article "Comment utiliser la recherche d'utilisateur". Il est important de noter que si vous connaissez l'identifiant d'utilisateur d'un utilisateur et son adresse e-mail, vous devriez rechercher leurs informations avec les deux. C'est la seule façon de vous assurer que toutes les informations personnelles que Hotjar possède sur cet utilisateur ont été recherchées et supprimées.
htmlDésactiver les attributs utilisateur
Pour empêcher l'envoi de nouveaux attributs utilisateur à Hotjar, vous devez désactiver les attributs utilisateur.
Tant que les attributs utilisateur sont activés sur votre site, si vous souhaitez les empêcher d'être envoyés à l'avenir, vous devez supprimer le code sur votre site qui les envoie à Hotjar. Une fois le code supprimé de votre site, les attributs utilisateur collectés précédemment existeront toujours, mais ne seront plus mis à jour ni ajoutés aux nouveaux utilisateurs de votre site.
Supprimer les attributs utilisateur
Les attributs utilisateur peuvent être supprimés depuis la page de gestion des attributs utilisateur en cliquant sur l'icône de corbeille à droite de l'attribut. Seuls les membres de l'équipe ayant des autorisations de lecture et d'écriture ou supérieures peuvent supprimer des attributs utilisateur.
Lorsqu'un attribut est supprimé, il disparaîtra immédiatement de l'application Hotjar. Cependant, l'attribut est toujours stocké en arrière-plan pendant 7 jours avant d'être définitivement supprimé. Les données associées à l'attribut sont ignorées pendant la période de 7 jours. Cela permet d'éviter l'envoi de données en raison de problèmes de mise en cache.
Si vous souhaitez recréer un attribut qui a été supprimé, vous devrez attendre 7 jours avant que l'attribut puisse être recréé avec succès.
Assurez-vous de supprimer tous les attributs utilisateur supprimés de tous les appels API d'identification
Supprimer un attribut utilisateur ne le supprimera pas des sessions existantes ou des réponses le contenant. L'attribut sera uniquement supprimé des filtres et des ciblages. N'oubliez pas de supprimer l'attribut utilisateur supprimé de tous les appels API d'identification, sinon il réapparaîtra dans la liste.
Meilleures pratiques
Quand effectuer des appels API à l'identification
Vous devriez effectuer des appels à l'identification à chaque fois :
- Qu'une page est chargée avec les valeurs les plus récentes (même si elles n'ont pas changé).
- Après un changement d'URL dans les applications monopages.
- À chaque fois qu'un changement est effectué. Par exemple, si vous souhaitez suivre leur dernier achat dans un magasin, vous voudriez mettre à jour cet attribut utilisateur une fois l'achat effectué.
Chaque appel mettra à jour les attributs utilisateur avec Hotjar avec les valeurs les plus récentes. Lorsqu'un enregistrement de session se termine, l'enregistrement sauvegarde les valeurs les plus récentes au moment où la session se termine. Lorsqu'un appel est effectué, mais que les valeurs n'ont pas été mises à jour, la requête réseau ne sera pas envoyée afin d'éviter les requêtes AJAX inutiles.
Combinaison des appels API d'identification avec des déclencheurs pour cibler des enquêtes/widgets de feedback
Si vous envisagez de combiner des Événements avec le ciblage des attributs utilisateur pour des enquêtes ou des widgets de feedback, assurez-vous que l'appel à l'identification a eu lieu avant le déclencheur dans votre ordre d'exécution, en tenant compte de tout appel asynchrone à d'autres services. Si le déclencheur est exécuté avant que l'appel API d'identification ait terminé son exécution, le widget d'enquête/feedback ne s'affichera pas.
Mise en file d'attente des appels à l'API avant le chargement de Hotjar
Si ce script est ajouté avant votre code de suivi Hotjar, une erreur se produira.
L'objet hj() ne peut pas être accédé tant que la balise de code de suivi Hotjar n'a pas été exécutée. Si, pour une raison quelconque, vous accédez à l'API Identify avant que le code de suivi ne soit exécuté, vous pouvez ajouter la ligne de code suivante avant d'appeler l'API :
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};Test des attributs utilisateur
Il existe plusieurs façons de tester si les attributs utilisateur sont envoyés correctement via l'API Identify.
- Une fois que le code est en ligne sur votre page et a été déclenché au moins une fois, vous pouvez visiter votre page de paramètres des attributs utilisateur pour voir si l'attribut utilisateur capturé par Hotjar est actif sur votre page.
- Vous pouvez activer le mode débogage Hotjar dans votre navigateur pour voir si les appels à l'API Identify sont envoyés avec succès à Hotjar pendant votre session.
- Pour les utilisateurs de valeur nulle, vous pouvez utiliser n'importe quelle adresse e-mail que vous possédez pour consentir à connecter les réponses de Feedback via une enquête ou un feedback. Cela vous permettra de voir quels attributs utilisateur sont transmis aux utilisateurs non identifiés, ce qui est particulièrement utile pour vérifier que vous n'envoyez pas accidentellement des données personnelles identifiables à Hotjar. Il est important de noter que les utilisateurs qui n'ont pas consenti à connecter le Feedback ne peuvent pas être recherchés de cette manière, donc à des fins de test, vous devriez configurer un widget de feedback pour donner votre consentement avec votre propre adresse e-mail.