Perguntas comuns, dicas e ajuda para solucionar problemas com Gravações.
Por que meus números estão aparecendo como asteriscos?
Sempre que o conteúdo do seu texto aparece como um asterisco (*) (ou 1 dentro do elemento de entrada de um tipo "número"), você está vendo a função de supressão de proteção à privacidade do usuário do Hotjar em ação.
Nós suprimimos números por padrão, mas eles podem ser desativados. É importante notar que números de 9 caracteres ou mais serão sempre suprimidos. Vemos isso mais com números de telefone ou números de cartão de crédito.
Você pode ler mais sobre a supressão de texto, incluindo como configurá-la, em nosso artigo sobre supressão de conteúdo.
Como faço para impedir que informações pessoais apareçam nas minhas gravações?
O Hotjar suprime a entrada de teclado do usuário e números incorporados no conteúdo da página por padrão, mas precisa de direção extra para suprimir informações pessoais contidas no texto da sua página ou imagens.
Solução: Nosso artigo sobre supressão de conteúdo ajuda a aconselhar sobre como você pode configurar o que o Hotjar deve e não deve capturar.
Quando suprimido, suas gravações renderizarão este conteúdo como asteriscos de comprimento ligeiramente aleatório (*). Isso ocorre no dispositivo do usuário, o que significa que nunca é armazenado em nossos servidores.
Como eu uso o console do navegador para identificar problemas?
Vários dos problemas discutidos neste artigo sugerem o uso do console do seu navegador para procurar mensagens de erro. Esses erros podem aparecer no seu site ou em uma Gravação. Se você precisar de ajuda para acessar o console, cada navegador tem sua própria documentação, vinculada abaixo.
- Chrome
- Firefox
- Safari
- Edge
- Internet Explorer (lembre-se de que o Hotjar não é suportado no Internet Explorer).
Quando você abre o console, geralmente verá avisos coloridos em amarelo e erros coloridos em vermelho. Avisos geralmente podem ser ignorados. Erros em vermelho podem ser úteis no diagnóstico de um problema.
No exemplo abaixo, você pode ver um exemplo de um erro indicando um recurso ausente, indicado pela mensagem "404 (Não encontrado)".
Ao identificar razões pelas quais o Hotjar pode não estar capturando dados do usuário, inspecionar o console ao visitar seu site pode ser útil. Dois erros comuns são:
- Erros de política de segurança de conteúdo.
- Erros relacionados a valores específicos nos scripts do Hotjar requerem acesso a ser "indefinido". Isso geralmente significa que o Hotjar está tentando acessar uma função nativa do navegador que outro script em seu site substituiu, impedindo que o Hotjar rastreie os usuários corretamente.
Solução: Esses erros precisarão ser resolvidos por desenvolvedores com acesso ao seu código-fonte.
O console é fundamental para identificar erros que impedem as Gravações de acessar fontes ou imagens usadas pelo seu site. Você pode ver o seguinte:
- Erros 404: geralmente significam que o arquivo que o Hotjar está tentando acessar não está mais disponível na URL capturada no momento da gravação.
- Erros 403: geralmente significam que um arquivo de fonte ou imagem que o Hotjar está tentando acessar não pode ser acessado sem permissões adicionais. Isso geralmente ocorre porque o arquivo está atrás de um login ou porque seu site desativa outros sites de acessar suas imagens ou fontes. Isso geralmente pode ser corrigido permitindo que insights.hotjar.com acesse suas imagens ou fontes.
- Erros CORS: temos instruções detalhadas sobre como resolver esses erros em nosso artigo sobre a correção de erros CORS.
Por que minha Gravação não carrega quando tento assisti-la?
Se você tentar assistir a uma Gravação e a reprodução nunca carregar ou mostrar uma tela em branco, é possível que o Hotjar tenha encontrado um erro ao tentar renderizar alterações específicas de código na sessão do usuário.
Como esse problema não é comum e pode ser causado por um bug, é melhor entrar em contato com o suporte para que nossa equipe possa analisar mais de perto.
Por que as fontes/ícones de fontes estão aparecendo como caixas ou não estão carregando?
Se as fontes da web no seu site não estão aparecendo nas reproduções dos usuários, isso geralmente significa que elas só são permitidas para carregar do seu domínio. Como as sessões são reproduzidas no domínio insights.hotjar.com, você pode ver erros no console, como:
Bloqueio de Solicitação de Origem Cruzada: A Política de Mesma Origem proíbe a leitura do recurso remoto em http://www.dominio.com/fonts/sua-fonte.woff. Isso pode ser corrigido movendo o recurso para o mesmo domínio ou habilitando o CORS.
Solução: Para corrigir isso, você precisará habilitar o CORS (compartilhamento de recursos de origem cruzada).
Habilitar CORS no Apache
Se você tem acesso ao arquivo .htaccess ou ao arquivo de configuração httpd.conf, você pode adicionar o seguinte código para permitir que seus arquivos de fonte sejam carregados externamente:
<FilesMatch "\.(ttf|ttc|otf|eot|woff|font.css|css)$">
Header set Access-Control-Allow-Origin "*"
</FilesMatch>
Habilitar CORS no nginx
Se você tem acesso ao arquivo de configuração httpd.conf, você pode adicionar o seguinte código para permitir que seus arquivos de fonte sejam carregados externamente:
if ($filename ~* ^.*?\.(eot)|(ttf)|(woff)$){
add_header Access-Control-Allow-Origin *;
}
Para mais informações sobre como habilitar o CORS, você pode conferir enable-cors.org.
CORS podem afetar Heatmaps
Se você está vendo este erro dentro de suas Gravações, há uma chance de o mesmo erro ocorrer dentro de seus Heatmaps.
Por que anúncios, widgets de chat ou outros conteúdos de terceiros não aparecem nas Gravações?
Anúncios, widgets de chat e muitos outros softwares de terceiros instalados no seu site são carregados como iframes. Para protegê-lo de possíveis ameaças de segurança ao substituir Gravações, o Hotjar suprime a execução de todos os iframes. Isso significa que não podemos rastrear o conteúdo do iframe no seu site.
Você pode ler mais sobre como o Hotjar lida com iframes em nosso artigo sobre isso.
Por que algumas partes das minhas páginas aparecem em branco ou faltando conteúdo?
O Hotjar captura as interações de um usuário e a própria página durante a sessão dele. Nos bastidores, capturamos o DOM da página e anexamos ouvintes de eventos aos elementos do DOM. O Hotjar é incapaz de capturar e rastrear certos tipos de conteúdo incorporados no DOM. Outros elementos do DOM bloqueiam o acesso do Hotjar a eles.
Certos elementos serão renderizados, mas podemos ser incapazes de replicar a interação do usuário:
- Elementos de vídeo: como o estado do player de vídeo não é mantido no DOM, o Hotjar não pode replicar a interação do usuário com os controles do player de vídeo.
Elementos que bloqueiam tanto a captura de conteúdo quanto de comportamento incluem:
-
Elementos Iframes: eles são melhor pensados como páginas dentro de páginas. Potenciais ameaças de segurança associadas a iframes significam que o Hotjar não pode rastrear o conteúdo do iframe. Saiba mais sobre iframes em Gravações.
Ferramentas de terceiros que são incorporadas como iframes que não podemos suportar incluem:
- Google Maps
- Chatbots
- Fornecedores de formulários de terceiros
-
Elementos Canvas: usados para desenhar gráficos, incluindo jogos e muitas ferramentas gráficas. Isso inclui gráficos 3D criados com WebGL. O conteúdo do Canvas não é exposto ao DOM, o que significa que o Hotjar não pode acessá-lo.
Comumente, vemos isso associado a ferramentas de desenho 3D/2D e jogos.
Esses tipos de conteúdo não são suportados:
- Adobe Flash: isso foi aposentado em dezembro de 2020.
Por que as gravações parecem estar divididas ou parar abruptamente?
Em algumas ocasiões, você pode notar que as gravações estão divididas em gravações separadas ou param abruptamente. Isso pode acontecer por qualquer um dos seguintes motivos:
- O Hotjar continua rastreando uma sessão mesmo se o usuário estiver inativo por alguns minutos. Se um usuário estiver inativo por mais de 30 minutos, o Hotjar encerrará automaticamente essa sessão. Se esse usuário retornar mais tarde, ele iniciará uma nova sessão de gravação. Se você vê gravações sendo divididas, verifique o horário em que foram adicionadas, pode ser que o usuário estivesse inativo por mais de 30 minutos ou deixou seu site e voltou para ele mais tarde.
- O Código de Rastreamento do Hotjar não está presente em todas as páginas, então o Hotjar não é capaz de gravar todas as sessões.
- O Hotjar é incapaz de rastrear usuários que estão se movendo para páginas em vários domínios de nível superior. Um exemplo disso é quando um usuário se move de www.exemplo.com para www.exemplo.co.uk.
Navegar para gateways de pagamento de terceiros sempre interromperá uma gravação
Como o Hotjar não pode ser colocado em um site de terceiros, não seremos capazes de coletar dados em um gateway de pagamento de terceiros. As gravações serão interrompidas assim que o usuário chegar a esta etapa em sua jornada.
Por que as páginas parecem quebradas/sem carregar CSS?
Os servidores do Hotjar precisam ter acesso aos ativos do seu site para gerar gravações com sucesso. Quando o CSS parece quebrado, isso geralmente significa que nossos servidores têm dificuldade em buscar alguns dos arquivos CSS do seu servidor.
Existem várias coisas que podem causar isso. Aqui estão os motivos conhecidos pelos quais os sites podem bloquear o Hotjar de acessar o CSS:
- Bloqueio de acesso com base na geolocalização ou seu site permite apenas IPs específicos para acessar ativos
- Bloqueio com base no domínio/referenciador
- Bloqueio com base na falta de cookie/armazenamento de sessão
Solução: Problemas baseados em bloqueio de referenciador e IP podem ser resolvidos por:
- Permitindo os endereços IP listados em IPs do Hotjar.
- Permitindo o domínio/referenciador https://insights.hotjar.com
Por que a rolagem do usuário parece travada?
Se você perceber que sua Gravação/Mapa de Calor não mostra nenhuma rolagem do usuário, ou mostra um corte de rolagem incomum, isso pode ser o resultado de um problema conhecido com Javascript e uma propriedade CSS específica.
O JavaScript tem uma limitação onde é incapaz de detectar a rolagem quando tanto os elementos HTML quanto o corpo de uma página têm overflow-x: hidden definido no CSS. Essa limitação não é específica do Hotjar, então não é algo que o Suporte do Hotjar possa resolver. Para mais informações sobre essa limitação, veja esta postagem relevante no Stackoverflow.
Solução: Remover overflow-x: hidden do corpo ou do HTML no seu CSS deve resolver esse problema.
Por que o Hotjar não está capturando nenhuma sessão?
Se você começou a gravar, mas não vê novas gravações sendo adicionadas após algumas horas, isso pode significar que o Código de Rastreamento do Hotjar não está corretamente instalado. Você precisará confirmar que todas as páginas do seu site têm o Código de Rastreamento do Hotjar instalado corretamente.
Se o Hotjar estiver instalado corretamente, a captura de sessão estiver habilitada nas configurações do seu site e você ainda não estiver vendo nenhuma gravação, verifique o console do desenvolvedor do seu navegador. Você pode verificar o console do desenvolvedor do seu navegador seguindo os passos neste guia.
Se houver um problema com a Política de Segurança de Conteúdo, você verá algo semelhante ao erro abaixo:
Você pode ler mais sobre problemas de CSP em nosso artigo sobre configurações de política de segurança de conteúdo.
Por que o Hotjar não está capturando todas as sessões/usuários?
Você pode experimentar casos em que outras ferramentas, como o Google Analytics, relatam mais visitas do que o Hotjar tem gravações.
Solução: Nosso artigo, O Hotjar grava todos os meus usuários? explica as razões pelas quais o Hotjar pode não gravar um usuário com base nas configurações que você habilitou ou é impedido de capturar uma sessão com base na configuração do dispositivo local do usuário.
Por que não estou vendo sessões em páginas que usam HTTP?
Para proporcionar uma experiência mais segura no Hotjar, não capturamos páginas que são servidas usando o protocolo HTTP. O Hotjar só capturará páginas que são enviadas por HTTPS. Isso também se aplica a ambientes de desenvolvimento que estão usando HTTP, como testes com localhost. Além de Heatmaps e Gravações, isso inclui widgets de Feedback e Pesquisas, que não serão exibidos em páginas que usam HTTP. Para obter ajuda para mover seu site para HTTPS, veja este guia do Google sobre as etapas que você pode seguir.
Posso rastrear usuários em páginas que estão atrás de um login?
Em geral, sim, o Hotjar funciona atrás de um login. Os dados do usuário e as informações do estado da página são enviados diretamente para nós a partir do cliente, então o Hotjar não precisa acessar a página diretamente. O ponto chave a considerar é que os servidores do Hotjar precisam ter acesso aos ativos do seu site (CSS, imagens, fontes) para renderizar as gravações corretamente.
Existem alguns obstáculos técnicos que você pode encontrar para conseguir isso, dependendo de como seus servidores estão configurados, mas muito frequentemente, rastrear usuários atrás de um login funcionará. Isso se aplica a Heatmaps também.
Como posso parar as Gravações?
Para parar de coletar Gravações, você pode desativar a Captura de Sessão no menu Configurações do Site. Não é possível parar programaticamente as gravações para sessões que já estão em andamento. Se uma sessão começou e o Hotjar começou a rastreá-la, não é possível encerrá-la enquanto a sessão ainda estiver ativa.
Desativar a Captura de Sessão limitará a funcionalidade de outras ferramentas
Desativar a Captura de Sessão também significa que você não coletará dados de sessão do Heatmap ou dados de Atributos do Usuário (incluindo atributos associados a Pesquisas/Feedback). Esses recursos requerem que a Captura de Sessão esteja ativada para funcionar.
Se a Captura de Sessão estiver desativada, é possível direcionar Feedback e Pesquisas usando Eventos ou Atributos do Usuário. No entanto, não haverá gravações para sessões conectadas a respostas de Pesquisa ou Feedback, então os atributos do usuário não serão associados às respostas. Verifique nossa página de preços para ver se sua assinatura do Hotjar inclui acesso aos recursos de Eventos e Atributos do Usuário.
Por que não consigo ver todas as minhas Gravações?
Pode haver um filtro de data aplicado. Se você vê um 0 seguido por um número, como 0/999, isso significa que você tem 999 Gravações no total, e nenhuma está aparecendo na lista.
Solução: Altere o filtro de intervalo de datas para Últimos 90 dias ou Intervalo de datas personalizado para ver mais de suas Gravações.