Analytics - Tempo Real

O que é

A página Tempo Real mostra o que está acontecendo no site da agência neste instante. Ela considera os visitantes humanos cuja sessão teve atividade nos últimos 5 minutos e exibe número de visitantes ativos, sessões abertas, páginas que estão sendo vistas, localização geográfica num mapa, dispositivos em uso e uma timeline com as últimas visualizações dos últimos 10 minutos.

Você normalmente abre esta página ao disparar uma campanha (e-mail, anúncio, post em rede social) para ver o efeito imediato no tráfego, ao publicar uma nova excursão para conferir se as pessoas estão entrando, ou para identificar picos suspeitos de acesso. Os dados se atualizam sozinhos a cada 15 segundos enquanto a aba está visível; se você troca de aba, o polling pausa e retoma quando você volta.

Como usar

1. Vá em Analytics > Tempo Real no sidebar.
2. Observe o card de destaque Visitantes Ativos Agora (faixa verde com pulso) - é a contagem distinta de visitantes humanos com atividade nos últimos 5 minutos. Abaixo do número aparece Última atualização: agora / Xs atrás / Xmin atrás.
3. Confira o cabeçalho da página: ao lado do título Tempo Real o sistema mostra "X visitante(s) ativo(s) agora". O contador também aparece dentro do quadrado verde gradiente à esquerda do título.
4. Analise os três cards do grid:
   • Sessões Ativas (lateral esquerda) - lista até 10 sessões com cidade, navegador, dispositivo e duração. O contador no canto direito mostra o total de sessões.
   • Páginas Ativas (centro) - top 20 URLs em visualização agora, cada uma com um contador de espectadores e uma barra proporcional. Passe o mouse sobre a URL truncada para ver o caminho completo no tooltip.
   • Dispositivos (direita) - gráfico em rosca com Desktop, Mobile e Tablet, mais três caixas coloridas com a contagem absoluta de cada tipo.
5. Logo abaixo, no grid de duas colunas:
   • Localização dos Visitantes - mapa Leaflet centralizado no Brasil. Cada cidade ativa vira um marcador verde pulsante; clique no marcador para abrir o popup com a cidade e o número de visitantes. O contador no canto direito mostra "X cidades".
   • Sessões Ativas (tabela) - versão tabular completa com Cidade, Navegador, Dispositivo (pílula colorida), Páginas e Duração para até 30 sessões.
6. Na seção inferior Atividade em Tempo Real veja a timeline cronológica das últimas 50 visualizações nos últimos 10 minutos. Cada linha mostra timestamp relativo (ex: "12s", "3min"), uma bolinha colorida indicando o tipo de página (rosa = excursão, azul = página, roxo = blog, cinza = outro), título, URL, cidade e ícone do dispositivo. Novas visualizações que chegam pelo polling aparecem destacadas em verde por alguns segundos.

Casos especiais

Cidade "Desconhecido" nas sessões

Quando a geolocalização do IP não retorna cidade, a linha aparece com Desconhecido no campo Cidade. Isso acontece com IPs de proxy, VPN, redes corporativas ou operadoras móveis com NAT amplo. A sessão continua sendo contada normalmente, só não aparece no mapa.

Nenhuma sessão ativa

Se ninguém estiver no site, os cards Sessões Ativas mostram um estado vazio com ícone e a mensagem "Nenhuma sessão ativa". O mapa fica em branco (sem marcadores) e a timeline mostra "Nenhuma visualização recente / As visualizações aparecerão aqui em tempo real". Não é erro - significa que não há tráfego humano nos últimos 5 minutos.

Aba em segundo plano

Quando você troca para outra aba do navegador, o polling de 15 em 15 segundos pausa automaticamente para economizar requisições (visibilitychange detecta o document.hidden). Ao voltar para a aba, o polling retoma e a próxima atualização traz dados frescos.

Mapa sem marcadores

Se nenhum visitante ativo tiver latitude/longitude registradas, o mapa fica vazio mas a contagem de sessões continua aparecendo nos demais cards. O cabeçalho do mapa mostra "0 cidades".

Dispositivo fora do padrão

Quando o user-agent não permite classificar como desktop, mobile ou tablet, a coluna Dispositivo da tabela exibe o valor bruto em cinza, sem a pílula colorida.

Erros comuns e como resolver

• Contador "Visitantes Ativos Agora" zerado mesmo com gente no site - Causa: o site da sua empresa não está enviando eventos para a tabela site_visitors, ou os visitantes são identificados como bots. Solução: verifique se o snippet de analytics do Viagilize está ativo no site e se o tráfego está vindo de navegadores reais.
• "Sessões Ativas" mostra menos linhas que "Visitantes Ativos Agora" - Causa: a lista exibe apenas as 30 sessões mais recentes; o contador conta visitantes distintos. Solução: comportamento esperado - use o número do card destaque para o total real.
• "Atualizado a cada 15s" parado em "Xmin atrás" - Causa: aba ficou em segundo plano ou perdeu conexão. Solução: traga a aba para o primeiro plano; o polling retoma automaticamente. Se persistir, recarregue a página.
• Cidade aparece duplicada no mapa - Causa: dois pontos distintos com mesma cidade mas latitude/longitude ligeiramente diferentes (geolocalização por IP). Solução: comportamento esperado, cada par lat/long vira um marcador.

Onde encontrar

• URL: /admin/analytics/tempo-real
• Caminho no menu: Analytics > Tempo Real
• Permissão necessária: ver os relatórios de acesso
• Módulo necessário: nenhum

Veja também

• Analytics - Dashboard Analytics
• Analytics - Páginas e Conteúdo
• Analytics - Fontes de Tráfego
• Analytics - Dados Geográficos
• Analytics - Tecnologia
• Analytics - Por Excursão
• Analytics - Atividade de Clientes