Disponibilité du plan
Observer Observer le plan . Planifiez un appel avec notre équipe commerciale pour en savoir plus sur les fonctionnalités du plan .
La fonctionnalité de suivi de la console capture les erreurs de la console JavaScript que vos utilisateurs rencontrent lors d'une session. Cela aide à identifier les zones de friction et les points de frustration potentiels que vos utilisateurs rencontrent sur votre site.
Vous pouvez visualiser les erreurs de la console aux côtés d'une lecture d'enregistrement et zoomer pour voir une tendance ou d'autres enregistrements du même type d'erreur pour voir s'il y a un problème plus généralisé. En appliquant un filtre d'erreur, vous pouvez également affiner vos données de session en fonction des erreurs de la console. Cela vous permet d'identifier les problèmes sur votre site, d'enquêter sur la cause et de prioriser une correction.
- Comment activer ou désactiver le suivi de la console
- Quels types d'erreurs sont capturés
- Comment afficher les erreurs dans la console du lecteur d'enregistrements
- Comment appliquer le filtre d'erreur à votre liste d'enregistrements
- FAQ sur le suivi de la console
Comment activer ou désactiver le suivi de la console
Pour activer le suivi de la console, qui est désactivé par défaut, des autorisations d'administrateur sont requises.
Vous devrez disposer des autorisations d'administrateur niveau pour activer ou désactiver le suivi de la console dans les paramètres de votre site. Vous pouvez vérifier quels membres de l'équipe ont le niveau d'autorisation d'administrateur requis en visitant votre page de l'équipe.
Rendez-vous sur votre page Sites & Organisations.
Cliquez sur l'icône d'engrenage des paramètres du site pour accéder à la page des paramètres de votre site.
Cliquez sur la section Ciblage et suivi des sessions sur la page des paramètres de votre site.
Cliquez sur Capturer les erreurs JavaScript et les journaux de console pour activer ou désactiver cette fonctionnalité, puis cliquez sur Enregistrer les modifications.
Quels types d'erreurs sont capturés
Hotjar capture actuellement les erreurs non capturées. Il s'agit d'erreurs qui ne sont pas gérées par votre site de quelque manière que ce soit. "Gérer" une erreur signifie que votre site détecte l'erreur et prend des mesures pour éviter qu'elle n'affecte l'expérience de l'utilisateur. Pour cette raison, vous pouvez voir des erreurs sur une page en consultant la console du développeur qui n'apparaissent pas dans Hotjar.
Hotjar utilise actuellement un EventListener
pour capturer les événements non capturés suivants :
Cela se produit lorsqu'il y a une erreur de chargement d'un fichier externe ou lors de l'utilisation d'une ressource, telle qu'une image, ou si un script génère une erreur d'exécution.
Chaque erreur est un objet basé sur l'objet Error
, et possède un name
et un message
.
Voici quelques exemples :
- Error: Permission denied to access property "x" - se produit lorsqu'il y a une tentative d'accès à un objet pour lequel vous n'avez pas la permission.
- SyntaxError: illegal character - se produit lorsqu'il y a un jeton invalide ou inattendu qui ne devrait pas se trouver à cette position dans le code.
- TypeError: "x" is not a function - se produit lorsqu'il y a une tentative d'appeler une valeur à partir d'une fonction, mais que la valeur n'est pas réellement une fonction.
- Script error (une erreur générique, affichant uniquement un horodatage) - ces erreurs sont générées par des scripts d'origine croisée que le navigateur empêche de capturer.
Pour une liste plus complète, consultez cette référence aux erreurs JavaScript
Si une condition d'erreur survient à l'intérieur d'une promesse JavaScript, vous pouvez "rejeter" la promesse en appelant la fonction reject(). Cependant, si cette fonction n'est pas appelée, mais que la promesse JavaScript est quand même rejetée, cela entraînera un événement UnhandledRejection
.
Votre équipe de développement pourra définir le message d'événement de rejet qui apparaît dans la console du développeur, mais cela pourrait ressembler à quelque chose comme :
- Uncaught (in promise) something went wrong
Comment afficher les erreurs dans la console du lecteur d'enregistrements
Rendez-vous sur votre page Enregistrements.
Cliquez sur Lire sur n'importe quel enregistrement dans la liste de lecture.
À l'intérieur du lecteur d'enregistrements, cliquez sur l'icône Ouvrir la console pour afficher la console d'enregistrements.
Dans l'onglet Infos de session, vous pouvez voir si des erreurs de console se sont produites dans l'enregistrement en cours et le nombre d'erreurs. Vous pourrez également les visualiser dans la console d'enregistrements au-dessus de la chronologie de lecture.
Lorsque vous rencontrez une erreur de console lors de la lecture d'un enregistrement, vous pouvez également voir une tendance ou des enregistrements de la même erreur en cliquant sur l'icône d'erreur dans la barre d'outils de lecture et en sélectionnant Voir la tendance ou l'icône de lecture des enregistrements.
Lorsque le suivi de la console est désactivé, vous verrez le message ci-dessous vous demandant d'activer le suivi de la console. Si vous avez des niveaux d'autorisation d'administrateur, cliquer sur Activer le suivi de la console activera le suivi de la console. Pour le désactiver à nouveau, suivez les étapes de la section Comment activer ou désactiver le suivi de la console ci-dessus.
Vous pouvez également créer des tâches basées sur les erreurs de console en utilisant les intégrations Jira, Trello ou Asana.
Comment appliquer le filtre d'erreur à votre liste d'enregistrements
Les données d'enregistrements ne peuvent pas être exportées lorsqu'un filtre d'erreur est appliqué
Lorsqu'un filtre Erreur est appliqué à votre liste de lecture d'enregistrements, il n'est actuellement pas possible d'exporter ces données. Si vous essayez d'exporter des données d'enregistrements avec le filtre appliqué, vous verrez le message suivant : Quelque chose s'est mal passé. Veuillez ajuster vos filtres et réessayer.
Le filtre d'erreur affine vos données de session en fonction de la survenue ou non d'une erreur de console JavaScript. Vous pouvez affiner davantage ce filtre en spécifiant des conditions pour le texte d'erreur et l'URL de la page. Cela inclut si le texte d'erreur et l'URL de la page contiennent, sont, ne sont pas, ou ne contiennent pas. Actuellement, le filtre d'erreur n'est disponible qu'avec l'outil d'enregistrements.
Que se passe-t-il avec le suivi de la console si je rétrograde mon plan ?
Lorsque vous rétrogradez vers un plan qui ne prend pas en charge le suivi de la console, la capture des erreurs ne fonctionnera plus et aucune information de la console ne sera enregistrée. L'option de suivi de la console sera grisée dans les paramètres de votre site, et la case à cocher associée restera 'cochée' ou 'décochée' en fonction de ce qui a été configuré au moment de la rétrogradation.
Si vous mettez à niveau votre site Hotjar vers un Observe BusinessObserve Scale plan à l'avenir, la fonction de suivi de la console reprendra en fonction de vos configurations précédemment enregistrées. Le suivi de la console ne fonctionnera pas à moins que le site ne soit sur un plan Observe BusinessObserve Scale, indépendamment des configurations grisées. Les erreurs qui se produisent lorsque le site est sur un plan différent ne seront pas enregistrées même si la case est 'cochée'.
Puis-je voir un aperçu de toutes les erreurs se produisant sur mon site ?
Il n'existe pas de liste complète de toutes les erreurs, mais vos tableaux de bord ont une section où vous pouvez voir les Principales erreurs de console se produisant dans vos données de session. Ces informations sont visibles sous forme de graphique en barres/camembert ou de graphique linéaire.
Pourquoi vois-je un message d'erreur "Script Error" sans données ?
Les messages d'erreur "Script error" se produisent en raison d'erreurs avec des scripts d'origine croisée. Comme les navigateurs Web n'autorisent pas la capture de données à partir de ces scripts d'origine croisée, Hotjar ne peut pas voir la cause première et affichera à la place un message générique "Script error".