Le mode de débogage Hotjar peut être activé dans votre navigateur pour résoudre des problèmes complexes et confirmer que Hotjar fonctionne correctement. Cet article expliquera comment activer le mode de débogage, partagera quelques cas d'utilisation courants et fournira des informations sur des messages de journal de débogage spécifiques.
Continuez à faire défiler ou cliquez sur l'une des sections ci-dessous pour en savoir plus :
- Comment activer le mode de débogage via l'URL
- Comment activer le mode de débogage avec des cookies
- Cas d'utilisation
- Guide de référence des messages de journal
Comment activer le mode de débogage via l'URL
Ajoutez le paramètre de débogage à l'URL de votre page
L'activation du mode de débogage se fait en ajoutant le paramètre d'URL suivant à la fin de la page sur laquelle vous travaillez : ?hjDebug=1
Par exemple, pour déboguer https://www.hotjar.com/blog/, nous utiliserions cette URL à la place : https://www.hotjar.com/blog/?hjDebug=1
Ouvrez les outils de développement de votre navigateur
Voici les étapes à suivre pour ouvrir les outils de développement dans les navigateurs suivants :
- Chrome - dans la barre de menu, cliquez sur Afficher > Développeur > Outils de développement
- Firefox - dans la barre de menu, cliquez sur Outils > Outils du navigateur > Outils de développement Web
- Safari - dans la barre de menu, cliquez sur Développer > Afficher la console JavaScript
Rechargez la page
Recharger la page, après avoir suivi les étapes ci-dessus, vous permettra de voir tous les journaux de débogage qui se sont produits pendant le chargement de la page. Lorsque les journaux de la console apparaissent, ils ressembleront à ceci :
*Les journaux de débogage sont visibles dans l'onglet Console des outils de développement de votre navigateur.
Comment activer le mode de débogage avec des cookies
Ouvrez les outils de développement de votre navigateur
Voici les étapes à suivre pour ouvrir les outils de développement dans les navigateurs suivants :
- Chrome - sur la barre de menu, cliquez sur Affichage > Développeur > Outils de développement
- Firefox - sur la barre de menu, cliquez sur Outils > Outils du navigateur > Outils de développement Web
- Safari - sur la barre de menu, cliquez sur Développer > Afficher la console JavaScript
Ouvrez l'onglet Application
Ouvrez vos cookies en sélectionnant l'onglet Application.
Ajoutez hjDebug en tant que Cookie
Faites défiler jusqu'au bas des cookies et double-cliquez dans l'espace vide. Ensuite, saisissez hjDebug dans la colonne Nom.
Définissez le cookie sur true
Dans la deuxième colonne, saisissez le mot true pour définir le cookie, puis appuyez sur ENTRÉE.
Rechargez la page
Recharger la page, après avoir effectué les étapes ci-dessus, vous permettra de voir tous les journaux de débogage qui se sont produits pendant le chargement de la page. Lorsque les journaux de la console apparaissent, ils ressembleront à ceci :
Cas d'utilisation
Le mode de débogage est fréquemment utilisé par les développeurs pour tester les Événements et les fonctions Identify API. Cependant, il peut également être utilisé pour vérifier si les critères de ciblage sont respectés et pour aider à résoudre pourquoi un widget Enquête ou Feedback n'apparaît pas sur une page. Cette section partagera quelques exemples de son fonctionnement.
Recherchez l'onglet Console pour trouver des journaux de débogage pertinents
Vous pouvez utiliser Ctrl+F (Windows) ou command+F (Mac) pour rechercher l'onglet Console à la recherche de messages spécifiques. Les captures d'écran ci-dessous montrent des exemples de termes de recherche qui ont été utilisés pour réduire le nombre d'entrées de journal visibles dans la Console du navigateur.
Événements API
Les journaux de débogage indiqueront quand un Événement Hotjar a été déclenché avec succès dans le navigateur. Lorsqu'un événement est déclenché avec succès, un message de confirmation apparaîtra en bleu similaire au dernier message dans la capture d'écran ci-dessous :
COMMANDE : Traitement de la commande : event testEvent
Où 'testEvent' représenterait le nom unique de l'événement déclenché.
Pour déclencher ceci manuellement, vous pourriez entrer directement dans la Console de votre navigateur :
hj('event', 'testEvent');
API d'identification
Lorsqu'un appel API d'identification est reçu par Hotjar, un message de confirmation apparaîtra en bleu, similaire à l'image d'exemple ci-dessous :
COMMANDE : Traitement de la commande : identifier , {"attributUtilisateur":"valeur"}
Où "attributUtilisateur" est le nom de l'attribut reçu, et "valeur" est une valeur associée à cet attribut.
Vous pouvez envoyer manuellement un appel API à Hotjar en entrant ce qui suit dans la Console de votre navigateur :
hj('identify', null, {
attributUtilisateur: 'valeur'
});
De plus, vous pouvez voir des journaux indiquant si des attributs ont été modifiés en recherchant "attribut" dans la fenêtre de la Console. Les résultats ressembleront à ceci :
Sondages et Retours
Le mode débogage peut être utile pour comprendre le comportement des widgets de Sondages et de Retours car il montrera quand un outil a correspondance avec les critères cibles ainsi que quand il est rendu sur la page.
Par exemple, rechercher "sondage" dans la Console peut vous permettre de trouver des messages liés à l'outil Sondages. Dans l'exemple ci-dessous, nous voyons qu'un sondage spécifique (ID : 888238) a correspondu aux critères cibles sur la page, et Hotjar a appelé le sondage à apparaître sur la page.
De même, rechercher "retour" dans la Console vous permet de trouver des messages liés à l'outil de Retours. Dans l'exemple ci-dessous, nous voyons qu'un widget de retour spécifique (ID : 14573) a correspondu aux critères cibles sur la page, et Hotjar a appelé le widget de retour à apparaître sur la page.
Guide de référence des messages de journal
Actuellement, nous n'avons pas de liste complète de tous les messages de journal de débogage possibles. Cependant, c'est quelque chose que notre équipe explorera à l'avenir et nous mettrons à jour ce document dès que plus d'informations seront disponibles. Si vous rencontrez des difficultés pour faire fonctionner les outils et fonctionnalités Hotjar, veuillez contacter notre équipe d'assistance en utilisant le bouton Nous contacter ci-dessous cet article.
Erreurs de stratégie de sécurité du contenu
Si vous remarquez des erreurs mentionnant les domaines Hotjar (hotjar.com, hotjar.io, etc.) et liées à la "Stratégie de sécurité du contenu", assurez-vous de consulter cet article pour des étapes sur la façon de les résoudre.
Le tableau suivant contient quelques messages de journal de débogage Hotjar courants que vous pourriez rencontrer lors de l'utilisation de Hotjar sur votre site web :
Journaux de capture de session
Message de journal | Signification |
WEBSOCKET: Connexion au Web Socket [wss://wsp4.hotjar.com/api/v2/client/ws] | Hotjar tente d'ouvrir un Web Socket sur la page. |
WEBSOCKET: Web Socket ouvert. | Confirmation que le Web Socket a été ouvert avec succès. |
WEBSOCKET: Envoi de données au Web Socket : | Confirmation que le Web Socket reçoit des données de la page. Cela est nécessaire pour que les données de session soient capturées par les enregistrements et les cartes thermiques. |
Attributs utilisateur et journaux d'événements
Message de journal | Signification |
COMMANDE : Traitement de la commande : identifier , {"attributUtilisateur":"valeur"} | Un appel API d'identification a été détecté. Dans l'exemple de message à gauche, un attribut utilisateur appelé attributUtilisateur a été envoyé avec une valeur de valeur. |
ATTRIBUTSUTILISATEUR : Aucun enregistrement en cours. Pas d'envoi. | Un appel API d'identification a été détecté, mais la session de l'utilisateur n'est pas suivie par Hotjar. Cela peut se produire lorsque votre site subit un Échantillonnage. |
COMMANDE : Commande "identifier" bloquée en raison du refus | Ce message est généralement lié aux paramètres de Ne pas suivre (DNT) du navigateur. Si le DNT est activé, Hotjar rejettera tous les attributs utilisateur pour la session. |
ATTRIBUTSUTILISATEUR : Attributs utilisateur envoyés via websocket : (Développer pour voir les attributs) | Les attributs utilisateur sont détectés et envoyés aux serveurs Hotjar. |
ATTRIBUTSUTILISATEUR : L'appel API de validation des attributs utilisateur a échoué : | L'appel à l'API d'identification a échoué, développez le message pour voir la raison. Par exemple : "L'utilisateur n'a pas d'identifiant utilisateur ou d'attributs". |
COMMANDE : Traitement de la commande : événement nom_action | Un Événement Hotjar s'est déclenché sur la page. Dans l'exemple de message à gauche, le nom de l'événement était nom_action. |
Enquêtes et journaux de rétroaction
Message de journal | Signification |
SONDAGE : Le sondage n°xxxxxx a été trouvé. | Un sondage sur la page correspond aux critères de ciblage. Le numéro #xxxxxx fait référence à l'ID du sondage dans Hotjar. Plusieurs outils pourraient correspondre sur la même page. |
RENDU : Appel de l'élément actif (sondage) : x | Hotjar initie l'affichage d'un sondage correspondant sur la page. La valeur de x sera immédiate, délai, abandon ou défilement en fonction des configurations de comportement du sondage. |
SONDAGE : Affichage du widget de sondage. | Le sondage devrait maintenant être visible sur la page en direct. |
RETROACTION : Le widget de rétroaction n°xxxxxx a été trouvé. | Un widget de rétroaction sur la page correspond aux critères de ciblage. Le numéro #xxxxxx fait référence à l'ID du widget dans Hotjar. Plusieurs outils pourraient correspondre sur la même page. |
RENDU : Appel de l'élément actif (rétroaction) : x | Hotjar initie l'affichage d'un widget de rétroaction correspondant sur la page. La valeur de x sera immédiate ou délai en fonction des configurations de comportement du widget de rétroaction. |
RENDU : Appel de l'élément actif (rétroaction) : immédiate | Hotjar appelle un widget de rétroaction correspondant pour apparaître sur la page. |
SONDAGE : Le sondage a déjà été soumis. | Le sondage correspondait aux critères de ciblage, mais est configuré pour ne plus apparaître une fois que l'utilisateur a déjà répondu. |