O modo de depuração do Hotjar pode ser ativado em seu navegador para solucionar problemas complexos e confirmar que o Hotjar está funcionando corretamente. Este artigo explicará como ativar o modo de depuração, compartilhar alguns casos práticos comuns e fornecer informações sobre mensagens de log de depuração específicas.
Continue rolando ou clique em uma das seções abaixo para saber mais:
- Como ativar o modo de depuração via URL
- Como ativar o modo de depuração com cookies
- Casos práticos
- Guia de referência de mensagens de log
Como ativar o modo de depuração via URL
Adicione o parâmetro de depuração à URL da página
Ativar o modo de depuração é feito adicionando o seguinte parâmetro de URL ao final da página em que você está trabalhando: ?hjDebug=1
Por exemplo, para depurar https://www.hotjar.com/blog/, usaríamos esta URL em vez disso: https://www.hotjar.com/blog/?hjDebug=1
Abra as Ferramentas de Desenvolvedor do seu navegador
Aqui estão os passos para abrir as ferramentas de desenvolvedor nos seguintes navegadores:
- Chrome - no menu, clique em Visualizar > Desenvolvedor > Ferramentas de Desenvolvedor
- Firefox - no menu, clique em Ferramentas > Ferramentas do Navegador > Ferramentas de Desenvolvedor da Web
- Safari - no menu, clique em Desenvolver > Mostrar Console JavaScript
Recarregue a página
Recarregar a página, após a conclusão dos passos acima, garantirá que você consiga ver todos os logs de depuração que ocorreram durante o carregamento da página. Quando os logs do Console aparecerem, eles serão semelhantes a estes:
*Os logs de depuração são visíveis na guia Console das Ferramentas de Desenvolvedor do seu navegador.
Como ativar o modo de depuração com cookies
Abra as Ferramentas de Desenvolvedor do seu navegador
Aqui estão os passos para abrir as ferramentas de desenvolvedor nos seguintes navegadores:
- Chrome - na barra de menu clique em Visualizar > Desenvolvedor > Ferramentas de Desenvolvedor
- Firefox - na barra de menu clique em Ferramentas > Ferramentas do Navegador > Ferramentas de Desenvolvedor Web
- Safari - na barra de menu clique em Desenvolver > Mostrar Console JavaScript
Abra a guia Aplicativo
Abra seus cookies selecionando a guia Aplicativo.
Adicione hjDebug como um Cookie
Role até o final dos cookies e clique duas vezes no espaço vazio. Em seguida, digite hjDebug na coluna Nome.
Defina o cookie como true
Na segunda coluna, digite a palavra true para definir o cookie e pressione ENTER.
Recarregue a página
Ao recarregar a página, após os passos acima terem sido concluídos, você poderá ver todos os logs de depuração que ocorreram durante o carregamento da página. Quando os logs do Console aparecerem, eles serão semelhantes a estes:
Casos práticos
O modo de depuração é frequentemente usado por desenvolvedores para testar Eventos e funções da API de Identificação. No entanto, também pode ser usado para verificar se os critérios de segmentação estão sendo atendidos e para ajudar a solucionar por que um widget de Pesquisa ou Feedback não está aparecendo em uma página. Esta seção compartilhará alguns exemplos de como funciona.
Pesquise na guia Console para encontrar logs de depuração relevantes
Você pode usar Ctrl+F (Windows) ou command+F (Mac) para pesquisar na guia Console mensagens específicas. As capturas de tela abaixo mostram exemplos de termos de pesquisa que foram usados para reduzir o número de entradas de log visíveis no Console do navegador.
API de Eventos
Os logs de depuração mostrarão quando um Evento do Hotjar foi disparado com sucesso no navegador. Quando um evento é disparado com sucesso, uma mensagem de confirmação aparecerá em azul, semelhante à última mensagem na captura de tela abaixo:
COMANDO: Processando comando: evento testEvent
Onde 'testEvent' representaria o nome único do Evento sendo disparado.
Para acionar isso manualmente, você pode inserir o seguinte diretamente no Console do seu Navegador:
hj('event', 'testEvent');
API de Identificação
Quando uma chamada da API de Identificação é recebida pelo Hotjar, uma mensagem de confirmação aparecerá em azul, semelhante à imagem de exemplo abaixo:
COMANDO: Processando comando: identificar , {"userAttribute":"valor"}
Onde "userAttribute" é o nome do atributo recebido e "valor" é um valor associado a esse atributo.
Você pode enviar manualmente uma chamada de API para o Hotjar inserindo o seguinte no Console do seu Navegador:
hj('identify', null, {
userAttribute: 'valor'
});
Além disso, você pode ver logs que indicam se os atributos foram alterados ou não, pesquisando por "atributo" na janela do Console. Os resultados serão semelhantes a isso:
Pesquisas e Feedback
O modo de depuração pode ser útil para entender o comportamento dos widgets de Pesquisa e Feedback, pois mostrará quando uma ferramenta atendeu aos critérios de destino, bem como quando é renderizada na página.
Por exemplo, pesquisar "enquete" no Console pode permitir que você encontre mensagens relacionadas à ferramenta de Pesquisas. No exemplo abaixo, vemos que uma pesquisa específica (ID: 888238) atendeu aos critérios de destino na página e o Hotjar chamou a enquete (pesquisa) para aparecer na página.
Da mesma forma, pesquisar "feedback" no Console permite encontrar mensagens relacionadas à ferramenta de Feedback. No exemplo abaixo, vemos que um widget de feedback específico (ID: 14573) atendeu aos critérios de destino na página e o Hotjar chamou o widget de feedback para aparecer na página.
Guia de referência de mensagens de log
No momento, não temos uma lista abrangente de todas as possíveis mensagens de log de depuração. No entanto, isso é algo que nossa equipe explorará no futuro e atualizaremos este documento à medida que mais informações estiverem disponíveis. Se você tiver dificuldades para fazer as ferramentas e recursos do Hotjar funcionarem, entre em contato com nossa equipe de suporte usando o botão Entre em contato conosco abaixo deste artigo.
Erros de Política de Segurança de Conteúdo
Se você notar quaisquer erros que mencionem domínios do Hotjar (hotjar.com, hotjar.io, etc.) e estejam relacionados à "Política de Segurança de Conteúdo", certifique-se de verificar este artigo para saber como resolvê-los.
A tabela a seguir contém algumas mensagens comuns de log de depuração do Hotjar que você pode encontrar ao usar o Hotjar em seu site:
Logs de captura de sessão
| Mensagem de log | Significado |
| WEBSOCKET: Conectando ao Web Socket [wss://wsp4.hotjar.com/api/v2/client/ws] | O Hotjar está tentando abrir um Web Socket na página. |
| WEBSOCKET: Web Socket aberto. | Confirmação de que o Web Socket foi aberto com sucesso. |
| WEBSOCKET: Enviando dados para o Web Socket: | Confirmação de que o Web Socket está recebendo dados da página. Isso é necessário para que os dados da sessão sejam capturados por Recordings e mapas de calor. |
Atributos de usuário e logs de eventos
| Mensagem de log | Significado |
| COMANDO: Processando comando: identify , {"userAttribute":"value"} | Uma chamada da API de identificação foi detectada. No exemplo da mensagem à esquerda, um atributo de usuário chamado userAttribute foi enviado com o valor value. |
| ATRIBUTOSDOUSUÁRIO: Nenhuma gravação em andamento. Não enviando. | Uma chamada da API de identificação foi detectada, mas a sessão do usuário não está sendo rastreada pelo Hotjar. Isso pode acontecer quando seu site está passando por Amostragem. |
| COMANDO: Comando "identify" bloqueado devido à desativação | Essa mensagem está geralmente relacionada às configurações de Não rastrear (DNT) do navegador. Se o DNT estiver ativado, o Hotjar descartará todos os Atributos do Usuário para a sessão. |
| ATRIBUTOSDOUSUÁRIO: Atributos do usuário enviados pelo websocket.: (Expandir para ver os atributos) | Atributos do usuário foram detectados e estão sendo enviados para os servidores do Hotjar. |
| ATRIBUTOSDOUSUÁRIO: Chamada de API de validação de Atributos do Usuário falhou.: | A chamada para a API de identificação falhou, expanda a mensagem para ver o motivo. Por exemplo: "Usuário não possui user_id ou atributos." |
| COMANDO: Processando comando: event nome_da_ação | Um Evento do Hotjar ocorreu na página. No exemplo da mensagem à esquerda, o nome do evento foi nome_da_ação. |
Surveys e logs de feedback
html| Mensagem de log | Significado |
| ENQUETE: A enquete #xxxxxx foi correspondida. | Uma pesquisa na página correspondeu aos critérios de segmentação. O número #xxxxxx refere-se ao ID da pesquisa dentro do Hotjar. Várias ferramentas podem corresponder na mesma página. |
| REPRESENTAÇÃO: Chamando item ativo (enquete): x | O Hotjar está iniciando uma pesquisa correspondente para aparecer na página. O valor de x será imediatamente, atraso, abandonar ou rolar dependendo das configurações de comportamento da pesquisa. |
| ENQUETE: Renderizando widget de enquete. | A pesquisa deve estar visível na página ao vivo. |
| FEEDBACK: O widget de feedback #xxxxxx foi correspondido. | Um widget de feedback na página correspondeu aos critérios de segmentação. O número #xxxxxx refere-se ao ID do widget dentro do Hotjar. Várias ferramentas podem corresponder na mesma página. |
| REPRESENTAÇÃO: Chamando item ativo (feedback): x | O Hotjar está iniciando um widget de feedback correspondente para aparecer na página. O valor de x será imediatamente ou atraso dependendo das configurações de comportamento do widget de feedback. |
| REPRESENTAÇÃO: Chamando item ativo (feedback): imediatamente | O Hotjar está chamando um widget de Feedback correspondente para aparecer na página. |
| ENQUETE: A enquete já foi enviada. | A pesquisa correspondeu aos critérios de segmentação, mas está configurada para não aparecer mais depois que o usuário já respondeu. |