Resolva os problemas comuns de replay de sessão e mapas de calor com este guia de solução de problemas.
Nenhuma gravação aparece
Verifique o status da gravação
Primeiro, verifique se a gravação está habilitada para o site:
- Abra o site em Domínios, depois abra suas configurações e vá para a guia Avançado
- Nos controles de recurso, confirme que Session Replay está ativado
- Se você deseja apenas gravações de erro, verifique o Modo de gravação (pode ser definido como "Apenas sessões com erros" ou "Gravar todas as sessões")
Verifique o script de rastreamento
Certifique-se de que o script está instalado:
- Ver código-fonte da página
- Procure por "zenovay"
- Verifique se o script é carregado sem erros
Verifique o console para erros
Abra o console do navegador:
- Clique direito → Inspecionar
- Vá para a aba Console
- Procure por erros do Zenovay
Erros comuns:
| Erro | Solução |
|---|---|
| Script não encontrado | Reinstale o código de rastreamento |
| Erro de CORS | Verifique a configuração do domínio |
| Bloqueado por CSP | Atualize a Política de Segurança de Conteúdo |
| Erro de rede | Verifique internet/firewall |
Limites do plano
Verifique se seu plano inclui replay de sessão (plano Pro ou superior) e se as gravações estão dentro do período de retenção:
| Plano | Retenção |
|---|---|
| Pro | 60 dias |
| Scale | 120 dias |
| Enterprise | 180 dias |
Configuração de consentimento
Se usar consentimento:
- Verifique se o consentimento está sendo concedido
- Verifique a integração de consentimento
- Teste com consentimento concedido
Gravações não estão sendo reproduzidas
Problemas de carregamento
Se a reprodução não iniciar:
-
Atualize a página
- Limpe o cache se necessário
-
Verifique a conexão com a Internet
- Tente outra rede
-
Tente um navegador diferente
- Chrome é recomendado
-
Desative extensões
- Bloqueadores de anúncios podem interferir
Erros de reprodução
Se você vir mensagens de erro:
| Erro | Solução |
|---|---|
| "Falha ao carregar" | A sessão pode estar corrompida |
| "Sessão expirada" | Além do período de retenção |
| "Acesso negado" | Verifique as permissões |
| "Sessão inválida" | Entre em contato com o suporte |
Requisitos do navegador
Certifique-se de que o navegador oferece suporte a:
- WebGL
- JavaScript moderno
- Memória suficiente
Problemas visuais
Conteúdo faltante
Se os elementos aparecerem em branco:
| Causa | Solução |
|---|---|
| Mascaramento de privacidade | Verifique as configurações de mascaramento |
| Conteúdo dinâmico | Pode carregar de forma diferente |
| Conteúdo de terceiros | Não é possível capturar cross-origin |
| Carregamento lento | Pode não capturar antes de carregar |
Estilo incorreto
Se o estilo parecer errado:
-
Substituição de fonte
- Fontes personalizadas podem não carregar
- Fontes de fallback são usadas
-
Diferenças de CSS
- Alguns CSS dinâmicos podem diferir
- Verifique problemas de CSS-in-JS
-
Problemas de responsividade
- O viewport pode diferir
- Diferenças de breakpoint
Imagens faltantes
As imagens podem não aparecer se:
- Forem servidas de um domínio diferente
- Forem protegidas por autenticação
- Não estiverem mais disponíveis
Mudanças de layout
Se o layout não corresponder:
- Mudanças de conteúdo dinâmico
- Variantes de teste A/B
- Conteúdo baseado em tempo
Problemas de mapa de calor
Mapa de calor vazio
Se o mapa de calor não mostrar dados:
-
Verifique o volume de dados
- Uma página precisa de tráfego suficiente recente antes de um mapa de calor ser gerado
- Visualize-o dentro de uma janela de tempo que realmente tem visitas
-
Verifique a página
- Escolha o mesmo caminho que recebeu o tráfego
- Os parâmetros de consulta podem dividir o tráfego em URLs separadas
-
Verifique o tipo de mapa de calor
- O visualizador alterna entre mapas de calor de Clique e Rolagem
- Alterne os tipos para confirmar que você está olhando para aquele com dados
Dados de clique imprecisos
Se os cliques parecerem errados:
| Problema | Causa |
|---|---|
| Cliques em elementos errados | Diferenças de viewport |
| Agrupamento incorreto | Mudanças de layout responsivo |
| Cliques ausentes | Amostragem ou limites |
Dados de rolagem ausentes
Se o mapa de calor de rolagem estiver vazio:
- Verifique se os eventos de rolagem estão sendo capturados
- Verifique o comprimento da página
- Confirme que o JavaScript está sendo executado
Problemas de desempenho
Reprodução lenta
Se a reprodução estiver entrecortada:
-
Reduza a velocidade de reprodução
- Tente 0,5x ou 1x
-
Feche outras abas
- Libere memória
-
Verifique a velocidade de rede
- O armazenamento em buffer pode ocorrer
-
Tente um navegador diferente
- Chrome é geralmente mais rápido
Alto uso de recursos
Se estiver consumindo muita CPU/memória:
-
Pule para seções relevantes
- Não reproduza a sessão inteira
-
Feche o painel de eventos
- Reduz a renderização
-
Desative animações
- Nas configurações, se disponível
Impacto no desempenho do site
Se a gravação afetar seu site:
-
Reduza o escopo de gravação
- Adicione páginas pesadas ou sensíveis a Rotas excluídas em Configurações → Avançado
- Defina Modo de gravação como "Apenas sessões com erros" para que as sessões sejam capturadas apenas quando algo der errado
-
Monitore métricas
- Verifique Core Web Vitals
- Compare com gravação desativada
Problemas de precisão de dados
Discrepância de contagem de sessão
Se as contagens não corresponderem à análise:
| Motivo | Explicação |
|---|---|
| Amostragem | Pode fazer amostragem em tráfego alto |
| Consentimento | Nem todos os usuários consentiram |
| Bloqueadores de anúncios | Bloqueiam o script de gravação |
| Tipos de página | Algumas páginas excluídas |
Diferenças de duração
Se a duração parecer errada:
- O tempo ocioso pode ser ignorado
- Mudança de aba afeta o tempo
- As abas em segundo plano podem pausar
Variação da contagem de cliques
As contagens de cliques podem diferir da análise:
- Os mapas de calor podem fazer amostragem
- Diferentes definições de clique
- Correspondência de viewport/elemento
Problemas de configuração
Mascaramento muito agressivo
O mascaramento é controlado por dois controles na aba Configurações → Avançado do site:
- Mascarar todos os campos de entrada (ativado por padrão) substitui o que os visitantes digitam por espaços reservados.
- Mascarar conteúdo de texto também mascara o texto da página visível.
Se muito estiver sendo mascarado, desative Mascarar conteúdo de texto para que a cópia regular da página seja capturada enquanto os valores de entrada permaneçam mascarados.
Mascaramento não está funcionando
Se dados sensíveis ainda estiverem visíveis em uma gravação:
- Confirme que os controles de mascaramento estão ativados em Configurações → Avançado. Mascarar todos os campos de entrada deve estar ativado.
- Re-gravar após salvar. O mascaramento se aplica a novas gravações, então as gravações existentes mantêm o mascaramento que estava em vigor quando foram capturadas.
- Mantenha páginas sensíveis completamente fora da reprodução. Adicione-as a Rotas excluídas (veja abaixo) se nunca forem gravadas.
Páginas excluídas sendo gravadas
Páginas que você não deseja gravar estão listadas em Rotas excluídas em Configurações → Avançado (um caminho por linha). Se uma página excluída ainda aparecer:
- Verifique se o caminho corresponde ao caminho da URL da página
- Confirme que você salvou a alteração
- Lembre-se de que as exclusões se aplicam a novas gravações, não às já capturadas
Problemas de integração
Conflitos do gerenciador de consentimento
Se a integração não estiver funcionando corretamente:
-
Verifique o tempo
- Consentimento antes da gravação
-
Verifique eventos
- Sinais de consentimento disparando
-
Teste manualmente
- Conceda consentimento, verifique a gravação
Aplicativos de página única
O script de rastreamento lida com mudanças de rota SPA automaticamente (ele escuta a navegação da API de histórico), portanto, nenhuma configuração adicional é necessária. Se um aplicativo de página única ainda se comportar inadequadamente:
| Problema | O que verificar |
|---|---|
| Mudanças de página não capturadas | Confirme se o script é carregado uma vez na renderização inicial e não é re-injetado a cada mudança de rota |
| Sessões duplicadas | Certifique-se de que a tag script seja incluída apenas uma vez no seu shell do aplicativo |
| Navegação ausente | Verifique se seu roteador usa a API de histórico padrão (pushState) para que as mudanças de rota possam ser detectadas |
Scripts de terceiros
Conflitos com outras ferramentas:
- Verifique conflitos de script
- Verifique a ordem de carregamento
- Teste isoladamente
Recuperação de dados
Sessões perdidas
Infelizmente:
- As sessões excluídas não podem ser recuperadas
- As sessões expiradas são removidas permanentemente
- Exporte antes do fim da retenção
Sessões corrompidas
Se as sessões parecerem corrompidas:
- Pode ser um upload parcial
- Interrupção de rede durante a captura
- Entre em contato com o suporte com a ID da sessão
Obter ajuda
Informações a fornecer
Ao entrar em contato com o suporte:
- ID da sessão (se sessão específica)
- URL da página afetada
- Navegador e versão
- Mensagens de erro
- Passos para reproduzir
- Capturas de tela/gravações
Canais de suporte
- Chat no aplicativo
- [email protected]
- Ingressos do centro de ajuda
Modo de depuração
Ative o log de depuração adicionando data-debug à sua tag de script:
<script defer
src="https://api.zenovay.com/z.js"
data-tracking-code="YOUR_TRACKING_CODE"
data-debug="true">
</script>
Verifique o console para obter logs detalhados.
Medidas preventivas
Teste regular
Teste a gravação periodicamente:
- Após atualizações do site
- Após mudanças de rastreamento
- Após atualizações de consentimento
Monitoramento
Configure alertas para:
- Quedas na contagem de gravações
- Aumento da taxa de erro
- Mudanças de desempenho
Documentação
Mantenha registros de:
- Mudanças de configuração
- Regras de exclusão
- Problemas conhecidos