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 e compartilhará alguns casos de uso comuns para fazê-lo.
Como habilitar o modo de depuração através da URL
Adicione o parâmetro de depuração à URL da sua página
Habilitar 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/, nós 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 usados para abrir as ferramentas de desenvolvedor nos seguintes navegadores:
- Chrome - no menu, clique em Exibir > Desenvolvedor > Ferramentas de Desenvolvedor
- Firefox - no menu, clique em Ferramentas > Ferramentas do Navegador > Ferramentas de Desenvolvedor Web
- Safari - no menu, clique em Desenvolver > Mostrar Console de JavaScript
Recarregue a página
Recarregar a página, após a conclusão das etapas acima, garantirá que você consiga ver todos os registros de depuração que ocorreram durante o carregamento da página. Quando os registros do Console aparecerem, eles terão uma aparência semelhante a estes:
*Os registros de depuração são visíveis na guia Console das Ferramentas de Desenvolvedor do seu navegador.
Como habilitar o modo de depuração com cookies
Abra as Ferramentas de Desenvolvedor do seu navegador
Aqui estão os passos usados para abrir as ferramentas de desenvolvedor nos seguintes navegadores:
- Chrome - no menu, clique em Exibir > Desenvolvedor > Ferramentas de Desenvolvedor
- Firefox - no menu, clique em Ferramentas > Ferramentas do Navegador > Ferramentas de Desenvolvedor Web
- Safari - no menu, clique em Desenvolver > Mostrar Console de 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
Recarregar a página, após a conclusão das etapas acima, garantirá que você consiga ver todos os registros de depuração que ocorreram durante o carregamento da página. Quando os registros do Console aparecerem, eles terão uma aparência semelhante a estes:
Casos de Uso
O modo de depuração é frequentemente usado pelos 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 problemas relacionados ao motivo pelo qual um widget de Pesquisa ou Feedback não está aparecendo em uma página. Esta seção compartilhará alguns exemplos de como ele funciona.
Pesquise na guia Console para encontrar registros de depuração relevantes
Você pode usar Ctrl+F (Windows) ou command+F (Mac) para pesquisar na guia Console por 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 registros de depuração mostrarão quando um Evento do Hotjar for disparado com sucesso no navegador. Quando um evento for 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' representa o nome único do Evento sendo disparado.
Para acionar isso manualmente, você pode inserir o seguinte diretamente no Console do seu navegador:
hj('evento', 'testEvent');
Identificar API
Quando uma chamada de 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":"value"}
Onde "userAttribute" é o nome do atributo recebido e "value" é 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 registros que indicam se os atributos foram alterados pesquisando por "atributo" na janela do Console. Os resultados serão semelhantes a este:
Pesquisas e Feedback
O modo de depuração pode ser útil para entender o comportamento dos widgets de Pesquisa e Feedback, pois ele mostrará quando uma ferramenta corresponde aos critérios de destino, bem como quando ela é 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) correspondeu aos critérios definidos 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) correspondeu aos critérios definidos 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 assim que mais informações estiverem disponíveis. Se você tiver algum problema para fazer com que as ferramentas e recursos do Hotjar funcionem, entre em contato com nossa equipe de suporte usando o botão Contate-nos abaixo deste artigo.
A tabela a seguir contém algumas mensagens de log de depuração comuns do Hotjar que você pode encontrar ao usar o Hotjar em seu site:
| Mensagem de log | Significado |
| COMANDO: Processando comando: event action_name | Um Evento do Hotjar foi disparado na página. No exemplo de mensagem à esquerda, o nome do evento foi action_name. |
| 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 capturar os dados da sessão em Gravações e Mapas de Calor. |
| COMANDO: Processando comando: identify , {"userAttribute":"value"} | Uma chamada da API Identify foi detectada. No exemplo de mensagem à esquerda, um atributo de usuário chamado userAttribute foi enviado com o valor value. |
| USERATTRIBUTES: Nenhuma gravação em andamento. Não enviando. | Uma chamada da API Identify 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. |
| POLL: A pesquisa #xxxxxx foi correspondida. | Uma pesquisa na página correspondeu aos critérios de segmentação. O número #xxxxxx se refere ao ID da pesquisa no Hotjar. Várias ferramentas podem corresponder na mesma página. |
| RENDERING: Chamando item ativo (pesquisa): delay | O Hotjar está iniciando uma pesquisa correspondente para aparecer na página. O valor de delay pode ser substituído por immediate, abandon ou scroll, dependendo das configurações de comportamento da pesquisa. |
| POLL: Renderizando widget de pesquisa. | A pesquisa deve estar visível na página ao vivo agora. |
| RENDERING: Chamando item ativo (feedback): immediate | O Hotjar está chamando um widget de Feedback correspondente para aparecer na página. |
| POLL: A pesquisa 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. |