Live View

Live View é a aba de tempo real dentro do dashboard de cada domínio. Mostra quem está no seu site agora — país, cidade, página, duração da sessão, fonte de tráfego, dispositivo — e atualiza a cada 3 segundos enquanto a aba está visível.

Planos Pro e superior também podem ativar o Ghost Multiplayer, uma sobreposição de cursor que transmite os movimentos do mouse do visitante para uma captura de tela da página que ele está visualizando, com um painel lateral de detalhes da sessão. A sobreposição é efêmera por design: nenhum conteúdo DOM é capturado, nenhum armazenamento de longa duração, nenhum endereço IP na carga útil.

---

Início rápido

1. Entre em app.zenovay.com.
2. Abra Domínios e escolha o domínio que deseja monitorar.
3. Abra a aba Live view.
4. Quando visitantes chegarem, uma lista de sessões ativas aparecerá, atualizando a cada 3 segundos.
5. (Pro+) Clique em Assistir cursor em qualquer cartão para abrir a sobreposição Ghost Multiplayer para esse visitante.

---

Anatomia do cartão de visitante

Cada visitante ativo mostra um cartão único contendo:

Uma sessão está "ativa" se o último evento ocorreu nos últimos 5 minutos. Após 5 minutos de inatividade, o cartão sai da lista automaticamente.

---

Filtros

A barra de filtros no topo da aba restringe a lista no lado do cliente — não altera o que é consultado, apenas o que é exibido. Filtros disponíveis:

• País — dropdown de seleção única de países atualmente representados.
• Página — correspondência exata do caminho.
• Fonte — Direto / Orgânico / Pago / Social / Referência.
• Dispositivo — Computador / Celular / Tablet.

Limpar um filtro restaura a lista completa. Não há integrações de segmento salvo na aba ao vivo em V1 — filtros são intencionalmente leves para manter a atualização de 3 segundos econômica.

---

Atualização automática e pausa ciente da visibilidade

• Intervalo de atualização: 3 segundos enquanto a aba está focada.
• Pausa em segundo plano: quando a aba do navegador está oculta (você muda para outra ou minimiza a janela), a sondagem para para evitar solicitações desperdiçadas e CPU.
• Retomar na visibilidade: a sondagem é retomada em até 3 segundos após trazer a aba para o primeiro plano.

A pausa é acionada pelo evento visibilitychange padrão — nenhum heartbeat customizado, nenhum botão manual necessário.

Se uma breve interrupção de rede descartar uma sondagem, a lista de visitantes se reconecta automaticamente no próximo intervalo em vez de mostrar um erro.

---

Ghost Multiplayer (Pro+)

Ghost Multiplayer é uma sobreposição de cursor opcional. Está desativada por padrão e é ativada por visitante quando um administrador Pro+ a abre.

Como ativar

1. Em qualquer cartão de visitante, clique em Assistir cursor.
2. Uma sobreposição de tela cheia abre com:
   • Fundo: uma captura de tela da página que o visitante está visualizando atualmente.
   • Cursor: um ponteiro animado refletindo sua posição de mouse em tempo real.
   • Painel lateral: ID do visitante anônimo, duração da sessão, páginas visitadas nesta sessão, dispositivo, navegador e país.
3. Pressione Esc ou clique fora da sobreposição para fechar.

O cursor é atualizado com um atraso de 1-2 segundos em V1 (sondagem HTTP). V2 mudará para WebSocket para atualizações quase instantâneas — veja V2 backlog abaixo.

Como funciona nos bastidores

Enquanto a sobreposição está ativa, o rastreador do visitante:

1. Escuta eventos mousemove na página (listener passivo, sem preventDefault).
2. Restringe-os a um máximo de 10 amostras por segundo.
3. Agrupa as amostras em janelas de 1 segundo e as envia por POST para POST /api/analytics/live-cursor/ingest.
4. A carga útil contém apenas coordenadas como percentuais da viewport, um ID de sessão e um timestamp. Sem IP, sem conteúdo DOM, sem valores de campo de formulário.

No servidor:

1. O Worker armazena o lote no Cloudflare KV com um TTL de 10 segundos.
2. A sobreposição consulta GET /api/analytics/live-cursor/:websiteId/:sessionId a cada 1 segundo.
3. Amostras antigas expiram automaticamente. Nada é escrito no banco de dados.

Limite de visualização de página ao vivo

A imagem de fundo de visualização de página atrás do cursor é uma captura de tela sob demanda do lado do servidor e é limitada por site por dia. O contador é redefinido às 00:00 UTC:

Visualizar novamente uma página que já foi capturada no mesmo dia não consome orçamento — essa captura é servida do cache.

Quando o limite diário é atingido, a sobreposição mostra uma mensagem clara: "Limite de visualização ao vivo diário atingido — retoma 00:00 UTC". O cursor ao vivo e a lista de visitantes continuam funcionando normalmente; apenas o fundo de captura de tela da página pausa até o próximo reset.

Detalhes do painel lateral

O painel lateral exibe contexto de nível de sessão que já existe no seu dashboard — não introduz uma nova fonte de dados:

• ID de visitante anônimo (o mesmo identificador opaco usado em outros lugares do produto)
• Duração da sessão
• Páginas visitadas nesta sessão
• Dispositivo, navegador, país

V1 não mostra o nome da empresa ou histórico de receita (veja V2 backlog).

---

Privacidade e conformidade

Ghost Multiplayer foi projetado para adicionar zero nova área de superfície de rastreamento de longa duração. As garantias abaixo são válidas para V1 conforme enviado:

• GPC respeitado em ambas as extremidades. Quando o navegador do visitante define navigator.globalPrivacyControl === true, o rastreador não transmite dados de cursor e o endpoint de ingestão do lado do servidor descarta qualquer carga útil desviada com uma resposta 204.
• Apenas KV efêmero. Lotes de cursor vivem no Cloudflare KV com um TTL de 10 segundos. Nunca são escritos no banco de dados de análises.
• Sem cookies de longa duração, sem localStorage. Ativar a sobreposição não introduz nenhum armazenamento no dispositivo do visitante além do ID de sessão de rastreador existente.
• Apenas coordenadas. A carga útil contém x/y como percentuais da viewport, um ID de sessão e um timestamp. Sem endereço IP, sem conteúdo DOM, sem valores de formulário, sem conteúdo da área de transferência, sem pressionamentos de tecla.
• Visibilidade unidirecional. O visitante não vê o cursor do administrador e não é notificado — isso espelha como todo outro dashboard de análises funciona, mas se você publicar um aviso de privacidade voltado ao público, deverá divulgar que os administradores podem observar a atividade do cursor ao vivo.
• Visualização de página anônima. O fundo de visualização é uma captura de tela anônima do lado do servidor da página pública apenas. É renderizado como um visitante Global Privacy Control / do-not-track: não define cookies, suprime banners de consentimento de cookies e não aciona pixels de marketing ou análises. Campos de formulário são mascarados no artefato de captura de tela e nenhum DOM de visitante ou PII é capturado.

As janelas de retenção de nível de plano para as linhas de sessão/pageview subjacentes permanecem regidas por seu nível de assinatura; o fluxo de cursor em si não adiciona nada a essa retenção porque nada é persistido.

---

Desempenho e limites

A aba Live View base em si adiciona uma pequena solicitação a cada 3 segundos para GET /api/analytics/realtime/:websiteId — comparável em custo a qualquer outro tile de dashboard em tempo real.

---

V2 backlog

Os seguintes itens intencionalmente não estão em V1. Eles são rastreados mas ainda não foram enviados:

• iframe ao vivo do site do cliente como fundo de sobreposição, em vez de uma captura de tela.
• Transporte WebSocket para atualizações de cursor sub-segundo (atualmente sondagem HTTP).
• Enriquecimento de IP para empresa com um logotipo da empresa acima do cursor para visitantes B2B.
• Histórico Stripe / faturamento no painel lateral para clientes pagantes.
• Trilhas de cursor / breadcrumbs mostrando caminhos recentes sobre a página.
• Presença multi-administrador — vendo cursores uns dos outros quando vários administradores observam o mesmo visitante.
• Modo de gravação — capturando uma sessão para reprodução posterior (isso será mesclado com o produto Session Replay existente, não o duplicará).

Se você precisar de qualquer um desses anteriormente, a prioridade é definida pela demanda do cliente — entre em contato via [email protected].

---

Perguntas frequentes

O visitante sabe que estou observando seu cursor?

Nenhuma notificação é mostrada ao visitante. A sobreposição é uma visualização unidirecional, como qualquer outro dashboard de análises. Se sua jurisdição exigir divulgação para observação comportamental, mencione monitoramento ao vivo em seu aviso de privacidade.

Por que o cursor está atrasando um ou dois segundos?

V1 usa sondagem HTTP em um cadência de 1 segundo — o cursor se aproxima da posição real do visitante com um atraso de ~1-2 s. Mover para transporte WebSocket está no V2 backlog.

Minha lista de visitantes está vazia, embora eu veja tráfego no dashboard principal.

Algumas causas comuns:

1. Sem visitantes ativos agora. A lista mostra apenas sessões cujo último evento ocorreu nos últimos 5 minutos. Períodos tranquilos são normais.
2. Aba oculta. A sondagem pausa quando a aba está em segundo plano; traga-a para o primeiro plano e aguarde até 3 segundos.
3. Rastreador não instalado na página que está sendo visualizada. Confirme com o diagnóstico Install Health.
4. Bloqueador de anúncios. Alguns bloqueadores de anúncios eliminam a solicitação do rastreador. Isso afeta todos os produtos de análises, não apenas Live View.

Posso ver a página real do visitante na sobreposição, não uma captura de tela?

Não em V1 — veja V2 backlog. Incorporar a página ao vivo do cliente em um iframe requer que o cliente permita enquadramento em seu próprio domínio, o que a maioria não faz por padrão. A abordagem de captura de tela da V1 funciona para todos os sites pronto para uso.

O Ghost Multiplayer conta para minha cota de session replay?

Não. Ghost Multiplayer é apenas em tempo real e não armazena nada; não consome sua cota de session replay.

Posso compartilhar um link de sobreposição Ghost Multiplayer com um colega de trabalho?

Não em V1. A sessão de sobreposição está vinculada à sua sessão autenticada do Zenovay. Um recurso futuro de "compartilhar visualização ao vivo" está no backlog.

---

Relacionado

• Real-time Tracking — o dashboard realtime subjacente
• Session Replay — sessões gravadas para análise posterior
• Heatmaps — dados de clique/scroll agregados
• Privacy Compliance — que dados o rastreador envia e por quê