Problemas com Session Replay

Resolva problemas quando as gravações de sessão não estão sendo capturadas ou não estão sendo reproduzidas corretamente.

Session Replay é configurado por site, na aba de configurações Avançadas para esse domínio. Abra o painel do seu site, vá para suas configurações e selecione Avançadas – é lá que ficam o botão de reprodução, o modo de gravação e os controles de privacidade. Você assiste às gravações na aba Sessões do site.

Sessões não estão sendo gravadas

Verificar se o recurso está ativado

1. Abra o painel do seu site → configurações → Avançadas
2. Verifique se Session Replay está ativado
3. Verifique se seu plano inclui Session Replay (Pro e superior)

Modo de gravação

Quando Session Replay está ativado, uma opção Modo de gravação aparece abaixo:

• Apenas erros – grava sessões onde um erro ocorreu (padrão). Isso mantém a largura de banda e o armazenamento baixos.
• Tudo – grava cada sessão.

Se você não está vendo gravações para visitas comuns, você provavelmente está em Apenas erros. Mude para Tudo se quiser capturar tudo.

Cobertura de página

Certifique-se de que o script de rastreamento está instalado em cada página que deseja gravar:

• Página inicial
• Páginas de produtos
• Checkout

Uma página sem o script não será gravada.

Configurações de privacidade

Os controles de privacidade na aba Avançadas mascaram ou removem conteúdo das gravações – eles não interrompem a gravação completamente:

• Mascarar entradas – campos de entrada são mascarados por padrão
• Mascarar conteúdo de texto – substitui todo o texto visível por espaços reservados
• Rotas excluídas – caminhos listados nunca são gravados

Se as gravações parecem muito censuradas ou certas páginas nunca aparecem, verifique essas configurações.

Nenhuma sessão aparecendo

Aguardar processamento

Novas sessões levam alguns minutos para aparecer:

1. Grave uma sessão de teste
2. Termine a sessão (feche a aba)
3. Aguarde alguns minutos
4. Atualize a aba Sessões

Verificar filtros

Remova filtros que possam ocultar sessões:

1. Limpe todos os filtros
2. Defina o intervalo de datas para "Hoje"
3. Verifique se as sessões aparecem

Sessões muito curtas

Sessões sem atividade significativa podem não produzir uma gravação útil. A gravação pausa após alguns segundos de inatividade, portanto uma visita que carrega e sai imediatamente pode mostrar pouco ou nada.

Problemas de reprodução

A sessão não vai reproduzir

Tela em branco:

• Sessão ainda em processamento
• Aguarde e tente novamente

Carregando para sempre:

• Sessão grande, conexão lenta
• Tente uma sessão mais curta primeiro

Mensagem de erro:

• Dados de sessão corrompidos
• Tente uma sessão diferente

Qualidade de vídeo ruim

Reduza a carga de rede:

1. Reduza a velocidade de reprodução
2. Pule para as partes importantes
3. Verifique sua conexão

As ações não são visíveis

Alguns elementos podem não ser gravados:

• Conteúdo Canvas/WebGL
• Reprodutores de vídeo
• Certos iframes
• Campos de senha (sempre mascarados)

Conteúdo de página faltando

Estilos não estão carregando

Session Replay obtém o CSS original. Se os estilos mudaram desde a gravação:

• Reprodução mostra estilos atuais
• O layout pode diferir do momento da gravação
• Este é o comportamento esperado

As imagens não estão mostrando

Imagens de fontes externas podem:

• Ser bloqueadas por CORS
• Ter expirado
• Terem sido deletadas

Conteúdo dinâmico diferente

Conteúdo renderizado por JavaScript:

• Reproduções capturam o estado do DOM
• Alguns conteúdos dinâmicos podem diferir
• Elementos interativos estão congelados

Desempenho durante a reprodução

Reprodução lenta

Tente:

1. Pause e deixe buffer
2. Reduza a velocidade de reprodução
3. Pule tempo ocioso

Navegador travando

Sessões grandes podem causar problemas:

1. Tente modo incógnito
2. Feche outras abas
3. Use Chrome (melhor desempenho)

Problemas de qualidade de gravação

A rolagem não é suave

Normal – a rolagem é limitada e gravada em intervalos, não continuamente.

Entrada de formulário não visível

Por padrão, a entrada é mascarada:

• Campos de texto mostram espaços reservados
• Esta é proteção de privacidade
• Você pode mostrar entradas não sensíveis ajustando Mascarar entradas na aba Avançadas (senhas são sempre mascaradas)

Bloqueio de privacidade

Elementos não estão sendo gravados

O rastreador respeita alguns hooks de exclusão que você pode adicionar ao seu markup. Adicione o atributo data-private para manter um elemento fora da gravação:

<!-- Este elemento está bloqueado da gravação -->
<div data-private>
  Conteúdo sensível
</div>

Você também pode usar classes CSS para controle mais fino:

• zenovay-block-replay – elemento é removido da gravação
• zenovay-mask-replay – texto do elemento é mascarado
• zenovay-ignore-replay – mudanças do elemento são ignoradas

Páginas inteiras excluídas

Um caminho listado em Rotas excluídas nunca é gravado:

1. Abra o painel do seu site → configurações → Avançadas
2. Verifique Rotas excluídas na seção de privacidade
3. Remova qualquer caminho que você não pretendeu excluir

Visitante optou por sair

Se um visitante optou por sair do rastreamento, suas sessões não serão gravadas. Zenovay também respeita o sinal Global Privacy Control (GPC).

Armazenamento e retenção

Sessões antigas desapareceram

Os dados de Session Replay têm seu próprio período de retenção, separado da retenção de dados de análise:

Plano	Retenção de Session Replay
Pro	60 dias
Scale	120 dias
Enterprise	180 dias

Gravações mais antigas que a janela do seu plano são removidas automaticamente.

Monitore seu uso

Session Replay consome muita largura de banda e armazenamento. Se você está produzindo mais gravações do que precisa, mude o Modo de gravação para Apenas erros ou use Rotas excluídas para pular caminhos barulhentos. Você pode acompanhar o uso geral do seu plano em Configurações → Uso.

Conteúdo de terceiros

Iframes não estão sendo gravados

Iframes entre origem:

• Não podem ser gravados
• Mostram um espaço reservado
• Conteúdo externo é protegido

Widgets de terceiros

Widgets de bate-papo, formulários incorporados, etc.:

• Podem não gravar completamente
• Depende da implementação
• Alguns mostram um espaço reservado

Problemas de sessão móvel

Sessões móveis não estão sendo gravadas

A gravação web móvel é suportada, mas:

• Eventos de toque são gravados
• Alguns gestos podem não aparecer

Problemas de AppWebView

WebViews podem ter:

• Um ambiente JavaScript diferente
• Um DOM modificado
• Limitações de gravação

Depuração de gravação

Gravação de teste

1. Abra seu site
2. Abra o console (F12)
3. Verifique se o rastreador está carregado:

console.log('Zenovay loaded:', typeof window.zenovay === 'function');

Nota: Não há método público para verificar o status de gravação. A gravação é controlada a partir da aba de configurações Avançadas do seu site.

Ativar modo de depuração

Adicione data-debug="true" ao trecho de rastreamento para ativar o log de console:

<script
  defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-debug="true"
  src="https://api.zenovay.com/z.js">
</script>

Verifique o console do navegador para mensagens de log. Session Replay é controlado a partir da aba de configurações Avançadas do seu site.

Soluções comuns

Não está gravando nada

1. Verifique se você está em Pro ou superior
2. Ative Session Replay na aba de configurações Avançadas do site
3. Defina Modo de gravação para Tudo se quiser capturar cada sessão
4. Certifique-se de que a página não está listada em Rotas excluídas
5. Limpe cache, atualize

Problemas de reprodução

1. Aguarde processamento
2. Tente um navegador diferente
3. Verifique se há erros
4. Tente uma sessão mais curta

Problemas de qualidade

1. Aceite algumas limitações
2. Concentre-se em interações-chave
3. Use com mapas de calor para a visão completa

Contato com suporte

Forneça:

1. ID da sessão (se disponível)
2. Navegador e versão
3. Problema de gravação ou reprodução
4. Configuração de modo de gravação
5. Erros de console

Próximas etapas

• Visão geral do Session Replay
• Privacidade de sessão
• Problemas de Heatmap