Disponibilidade do plano
Observe Observe o plano . Agende uma ligação com nossa equipe de vendas para saber mais sobre os recursos do plano .
O recurso de rastreamento do console captura os erros do console JavaScript que seus usuários estão enfrentando durante uma sessão. Isso ajuda a identificar áreas de atrito e possíveis pontos de frustração que seus usuários estão experimentando em seu site.
Você pode visualizar os erros do console junto com uma reprodução da gravação e ampliar para ver uma tendência ou outras gravações do mesmo erro ocorrendo para ver se há um problema mais generalizado. Aplicando um filtro de Erro, você também pode refinar seus dados de sessão com base nos erros do console. Isso permite identificar problemas em seu site, investigar a causa e priorizar uma correção.
- Como ligar e desligar o rastreamento do console
- Quais tipos de erros são capturados
- Como visualizar os erros no console do player de gravações
- Como aplicar o filtro de Erro à sua lista de gravações
- Perguntas frequentes sobre o rastreamento do console
Como ligar ou desligar o rastreamento do console
Para habilitar o rastreamento do console, que está desativado por padrão, são necessárias permissões de Administrador.
Você precisará ter permissões de nível de permissão de Administrador para ligar ou desligar o rastreamento do console nas configurações do seu site. Você pode verificar quais membros da equipe possuem o nível de permissão de Administrador necessário visitando sua página da equipe.
Acesse sua página de Sites e Organizações.
Clique no ícone de engrenagem de configurações do site para acessar a página de configurações do seu site.
Clique na seção Segmentação e rastreamento de sessão na página de configurações do seu site.
Clique em Capturar erros JavaScript e logs do console para ativar ou desativar essa opção e, em seguida, clique em Salvar alterações.
Quais tipos de erros são capturados
O Hotjar atualmente captura erros não capturados. Esses são erros que não estão sendo tratados pelo seu site de forma alguma. "Tratar" um erro significa que seu site identifica o erro e toma medidas para evitá-lo de afetar a experiência do usuário. Por causa disso, você pode ver erros em uma página ao olhar no console do desenvolvedor que não aparecem no Hotjar.
O Hotjar atualmente usa um EventListener
para capturar os seguintes eventos não capturados:
Isso acontece quando houve um erro ao carregar um arquivo externo ou usar um recurso, como uma imagem, ou se um script tem um erro de execução.
Cada erro é um objeto baseado no objeto Erro
, e tem um nome
e uma mensagem
.
Alguns exemplos são:
- Erro: Permissão negada para acessar a propriedade "x" - ocorre quando houve uma tentativa de acessar um objeto para o qual você não tem permissão.
- SyntaxError: caractere ilegal - ocorre quando há um token inválido ou inesperado que não pertence a esta posição no código.
- TypeError: "x" não é uma função - ocorre quando houve uma tentativa de chamar um valor de uma função, mas o valor na verdade não é uma função.
- Erro de script (um erro genérico, mostrando apenas um carimbo de data/hora) - esses erros são lançados por scripts de origem cruzada que o navegador impede de capturar.
Para uma lista mais abrangente, confira este referência de erros do JavaScript
Se uma condição de erro surgir dentro de uma promise JavaScript, você pode "rejeitar" a promise chamando a função reject(). No entanto, se esta função não for chamada, mas a promise JavaScript ainda for rejeitada, isso resultará em um evento UnhandledRejection
.
Sua equipe de desenvolvimento poderá definir a mensagem de rejeição do evento que aparece no Console do Desenvolvedor, mas pode se parecer com algo assim:
- Não capturado (na promise) algo deu errado
Como visualizar erros no console do player de Recordings
Visite sua página de Recordings.
Clique em Reproduzir em qualquer gravação na lista de reprodução.
Dentro do player de Recordings, clique no ícone Abrir console para mostrar o console de Recordings.
Na aba Informações da sessão, você pode ver se ocorreram erros do console na gravação atual e o número de erros. Você também poderá visualizá-los no console de Recordings acima da linha do tempo de reprodução.
Ao encontrar um erro do console na reprodução de uma gravação, você também pode visualizar uma tendência ou gravações do mesmo erro ocorrendo, clicando no ícone de erro na barra de ferramentas de reprodução e selecionando Visualizar tendência ou o ícone de reprodução das gravações.
Quando o rastreamento do console está desativado, você verá a mensagem mostrada abaixo pedindo para ativar o rastreamento do console. Se você tiver níveis de permissão de Administrador, clicar em Ativar rastreamento do console irá ativar o rastreamento do console. Para desativá-lo novamente, siga os passos na seção Como ativar ou desativar o rastreamento do console acima.
Você também pode criar tarefas com base em erros do console usando as integrações do Jira, Trello ou Asana.
Como aplicar o filtro de Erro à sua lista de Recordings
Os dados de Recordings não podem ser exportados quando um filtro de Erro está aplicado
Quando um filtro de Erro é aplicado à sua Lista de Reprodução de Recordings, atualmente não é possível exportar esses dados. Se você tentar exportar os dados de Recordings com o filtro aplicado, verá a seguinte mensagem: Algo deu errado. Ajuste seus filtros e tente novamente.
O filtro de Erro refina seus dados de sessão com base em se ocorreu ou não um erro do console JavaScript. Você pode refinar ainda mais esse filtro especificando condições para o texto de erro e a URL da página. Isso inclui se o texto de erro e a URL da página contém, é, não é, ou não contém. Atualmente, o filtro de Erro está disponível apenas com a ferramenta de Recordings.
O que acontece com o rastreamento do console se eu fizer downgrade do meu plano?
Ao fazer downgrade para um plano que não suporta o rastreamento do console, a captura de erros não funcionará mais e nenhuma informação do console será registrada. A opção de rastreamento do console será desativada nas configurações do seu site, e a caixa de seleção relacionada permanecerá 'marcada' ou 'desmarcada' com base na configuração feita no momento do downgrade.
Se você fizer upgrade do seu Site Hotjar para um plano Observe BusinessObserve Scale no futuro, o recurso de rastreamento do console será retomado com base nas configurações previamente salvas. O rastreamento do console não funcionará a menos que o Site esteja em um plano Observe BusinessObserve Scale, independentemente das configurações desativadas. Erros que ocorrerem enquanto o site estiver em um plano diferente não serão registrados, mesmo que a caixa de seleção esteja 'marcada'.
Posso ver uma visão geral de todos os erros ocorrendo no meu site?
Não há uma lista completa de todos os erros, mas seus Dashboards têm uma seção onde você pode visualizar os Principais erros de console ocorrendo em seus dados de sessão. Essas informações são exibidas em forma de gráfico de barra/pizza ou gráfico de linha.
Por que vejo uma mensagem de "Erro de script" sem dados?
As mensagens de "Erro de script" ocorrem devido a erros com scripts de origem cruzada. Como os navegadores da web não permitem a captura de dados desses scripts de origem cruzada, o Hotjar não consegue identificar a causa raiz e exibirá uma mensagem genérica de "Erro de script" em vez disso.