Suporte e solução de problemas

Escreva para hello@seean.io com o domínio do site, a tela afetada, o período selecionado e o que você esperava ver.

Use as perguntas frequentes para dúvidas comuns sobre o produto, a disponibilidade de recursos para verificar as integrações suportadas e cobrança e uso para cotas e acesso a faturas.

Nenhuma visualização de página chega

1. Confirme que a página implantada inclui o token do site e a origem da API corretos, de Configurações.
2. Verifique se o navegador consegue carregar /k.js e enviar a requisição de coleta.
3. Verifique os controles de consentimento, as preferências de privacidade do navegador, bloqueadores e as exclusões configuradas.
4. Verifique se o período de teste expirou ou se o uso atingiu a cota.
5. Abra Settings → Installation → Setup health (Configurações → Instalação → Estado da instalação), que mostra a visualização de página recebida mais recentemente e oferece Check installation (Verificar instalação).

Não gire um token como primeiro passo de solução de problemas: a rotação invalida as instalações existentes.

Verifique a configuração publicada

O Seean verifica automaticamente a página inicial publicada de todo site ainda não verificado, sem que ninguém abra o painel: a cada minuto durante o primeiro dia do site, a cada 5 minutos no restante da primeira semana, a cada 30 minutos no restante do primeiro mês e a cada 6 horas depois disso. Alterar o domínio ou girar o token do site reinicia esse cronograma no ritmo do primeiro dia. A primeira verificação que encontra o trecho, o token e uma política de segurança permissiva verifica o site imediatamente; nenhuma visita é necessária. Sites verificados e sites que já recebem eventos deixam de ser consultados; redefinir as estatísticas de um site não verificado o coloca de volta nesse cronograma.

O banner de instalação da Visão geral vazia também executa uma verificação ao abrir. Proprietários e administradores do site também podem usar Settings → Installation → Setup health → Check installation. Ele lê a página inicial publicada e verifica o endereço do rastreador gerado, a referência ao token do site e a política de segurança (o cabeçalho HTTP e qualquer tag <meta http-equiv="Content-Security-Policy"> no head da página). Os resultados aparecem na tela sem recarregar. Se a conexão com o Seean cair, a tela avisa que os dados recebidos podem estar desatualizados e desativa novas verificações até a reconexão:

• Security policy blocks Seean (A política de segurança bloqueia o Seean) nomeia a diretiva de script ou conexão que bloqueia e as origens a adicionar. Mescle-as com sua política existente e publique a alteração; mantenha as outras permissões da aplicação intactas.
• Seean is installed (O Seean está instalado) significa que o endereço do rastreador e o token do site aparecem no código-fonte da página e a política de segurança (cabeçalho e meta tag) permite o script e as requisições de coleta. Nenhuma visita é necessária. O site é marcado como instalado imediatamente: o banner de instalação da Visão geral fecha, Your sites mostra Installed (Instalado), e o Estado da instalação mostra Installation verified (Instalação verificada) com o horário da verificação. Os relatórios são preenchidos conforme os visitantes chegam; bloqueadores ou escolhas de consentimento ainda podem impedir que visitantes individuais sejam contados.
• Tracker reference found — confirm in a browser (Referência ao rastreador encontrada — confirme em um navegador) significa que o endereço e o token aparecem, mas a política usa regras nonce, hash ou strict-dynamic que a verificação não consegue avaliar, ou o head da página é longo demais para ler (veja os limites abaixo). Uma verificação anterior é mantida; siga a verificação no navegador.
• Setup could not be confirmed (Não foi possível confirmar a configuração) pode significar um trecho ausente ou diferente, carregamento no lado do cliente ou carregamento condicionado a consentimento. Siga a verificação no navegador antes de concluir que o rastreador está ausente.
• Could not inspect (Não foi possível inspecionar) explica uma página indisponível, erro HTTP, resposta grande demais ou endereço não suportado. Tente novamente depois de corrigir a página publicada, ou use a verificação no navegador.
• Last pageview received (Última visualização de página recebida) mostra a visualização de página retida mais recente deste site, independentemente do período de relatório selecionado. Um carimbo de data/hora antigo é evidência de coleta passada, não prova de que a instalação atual funciona. Sem visualizações de página, Installation verified mostra a última verificação bem-sucedida e Not installed yet (Ainda não instalado) significa que nenhuma verificação confirmou a página publicada.

Uma verificação posterior que encontre o trecho ou o token ausentes, ou uma política que bloqueie o Seean, remove a verificação e o banner volta enquanto o site não tem dados. Alterar o domínio do site, girar seu token ou alterar o nome de host do coletor usado pelo trecho gerado também remove a verificação e reinicia as verificações automáticas. As mudanças de coletor incluem ativar/desativar a coleta primária e ativar, perder ou desconectar um domínio de coleta personalizado; alterar um nome de host alternativo enquanto um domínio personalizado ativo ainda serve o trecho não redefine a verificação. Publique o trecho atual e as origens da sua política de segurança antes de verificar novamente. Os dados de análise existentes são mantidos. Uma verificação que não consegue ler a página deixa o resultado anterior inalterado.

Um resultado manual ou automático de uma configuração de instalação anterior não pode verificar a nova nem remover sua verificação em fila. Se uma verificação manual disser Installation settings or a newer check changed during this check (As configurações de instalação ou uma verificação mais recente mudaram durante esta verificação), revise o trecho gerado atual e tente de novo; o Seean não marca o resultado obsoleto como instalado.

As verificações manuais são limitadas a duas por minuto por usuário autenticado em todos os seus sites; as verificações automáticas não contam para esse limite. O verificador lê apenas a página inicial HTTPS pública do domínio configurado, com até três redirecionamentos dentro desse domínio e seu endereço www, um prazo total de 12 segundos e um limite de resposta de 2 MiB. Endereços privados, sites com IP literal, portas não padrão, sites apenas IPv6 e respostas comprimidas que ignoram o pedido de HTML não comprimido não são inspecionados.

Esta é uma verificação de código-fonte/cabeçalho no servidor: ela não executa JavaScript, não contorna consentimento ou bloqueadores do navegador, não inspeciona outras rotas nem prova que políticas nonce/hash/strict-dynamic funcionam. Um head de página com mais de 16 KB que ainda tenha uma meta tag http-equiv além desse ponto, ou políticas em meta tag com mais de 16 KB, não podem ser confirmados por esta verificação e precisam de verificação no navegador. Respostas diferentes de CDN e políticas em outras páginas exigem verificação no navegador. Ela verifica o nome de host que o trecho gerado usa atualmente - seu próprio domínio de coleta quando ativo, caso contrário o endereço de coleta primária ou app.seean.io; um trecho padrão mais antigo ainda pode funcionar depois que a coleta primária é ativada. A verificação em si não envia eventos de análise e não armazena o HTML buscado; apenas o horário da verificação, o horário da última verificação aplicada e o horário da próxima verificação automática são guardados. Visualizadores não podem executar verificações de instalação.

Verifique uma instalação

1. Abra seu site publicado em uma aba normal do navegador. Complete o fluxo de consentimento de análise do seu site, se aplicável. Continue respeitando as escolhas de privacidade dos seus visitantes.
2. Nas ferramentas de desenvolvedor do navegador, abra Network (Rede). Recarregue a página e procure https://app.seean.io/k.js. Ele deve carregar com sucesso, possivelmente do cache do navegador.
3. Procure um POST para https://app.seean.io/api/collect se você usa o trecho padrão de produção. Seu corpo JSON inclui seu token público em t e o caminho da página em p. Uma resposta 204 sozinha não é prova de que os dados foram armazenados: requisições excluídas também podem terminar sem resposta de erro.
4. No Seean, abra Events (Eventos), selecione um intervalo que inclua agora e atualize a lista. Confira o caminho da sua página e o horário. Verifique também Settings → Installation → Setup health para o horário da última visualização de página recebida.
5. Navegue para um caminho diferente, depois use Voltar e Avançar. Confirme cada visualização de página pretendida em Eventos. Consultas e fragmentos não são caminhos de página distintos; uma nova campanha ou sessão ainda pode contar o mesmo caminho de novo. Notificações consecutivas para um caminho inalterado na mesma sessão são deduplicadas; sair de um caminho e voltar pode produzir outra visualização de página.

Use um site/token separado ao testar para que suas verificações não inflem os relatórios de um cliente. Um download bem-sucedido do script, uma pré-visualização de página funcionando ou dados antigos no Estado da instalação não provam que uma nova instalação funciona.

O script carrega, mas nenhuma requisição de coleta aparece

Verifique a exclusão no navegador, Do Not Track, Global Privacy Control ou um navegador automatizado. window.seean pode existir com métodos inativos quando a coleta está desativada, então verificar apenas esse objeto é insuficiente. Carregue o trecho como um script externo clássico, com data-site e data-api nesse mesmo elemento.

Se o seu site usa uma Content Security Policy, permita https://app.seean.io na política de script efetiva e em connect-src. Se você define script-src-elem, ela também precisa permitir o rastreador. Mescle essas origens na sua política existente; não substitua o restante dela nem permita todas as origens. Carregadores inline usados por um gerenciador de tags podem precisar adicionalmente da sua política de nonce/hash existente. Veja opções do script.

Requisições falham ou contagens dobradas

Um token desconhecido/girado pode produzir um 404; uma cota de cobrança ou um plano inativo podem interromper a coleta. Verifique a cobrança e o token no HTML implantado. Uma requisição bloqueada ou um erro de CSP fica visível nas ferramentas de desenvolvedor do navegador. Siga as exclusões quando as requisições têm sucesso mas os dados esperados estão ausentes.

Busque k.js tanto nos arquivos do projeto quanto nos contêineres do gerenciador de tags. Mantenha uma única instalação e deixe-a observar a navegação suportada. Adicionar um gatilho de History Change que recarrega todo o rastreador, ou enviar pageview manualmente em cada navegação, pode dobrar as contagens.

Testes locais ou automatizados

Localhost e 127.0.0.1 exigem data-local. Automação do navegador ou configurações de privacidade podem interromper a coleta intencionalmente. Um teste de interface no navegador não é evidência de que uma visualização de página real foi ingerida.

Os relatórios parecem diferentes

Confira o site, o intervalo de datas, os filtros e o período calculado. O Tempo real usa janelas de dois e trinta minutos; a Visão geral normalmente cobre um intervalo mais longo. As estimativas de país e as importações de consultas do Google têm seus próprios limites.

Uma análise não iniciou

Cada página de análise inicia um cálculo para seu período. O aviso acima da página explica uma recusa: Your current analyses are still running (Suas análises atuais ainda estão em execução) aguarda as que estão rodando; Too many analyses were started for this website. Try again in N seconds (Análises demais foram iniciadas para este site. Tente novamente em N segundos) significa que o orçamento de início (120 por minuto em todos os sites e colegas do proprietário da conta; uma rajada de vinte e trinta por minuto por site, compartilhado por links de compartilhamento, widgets e visitantes da demonstração que não são membros dela) foi gasto, e a página tenta de novo sozinha após a espera. Could not start this analysis. Please retry (Não foi possível iniciar esta análise. Tente novamente) é uma falha inesperada; o console do navegador registra o ID da requisição do servidor para o suporte. Retry analysis (Tentar análise novamente) inicia de novo imediatamente.

As análises em segundo plano e os detalhamentos sob demanda compartilham um orçamento de execução limitado: dois cálculos em todo o serviço, no máximo um por proprietário de site. Isso inclui o Tempo real e a contagem leve de online. Um cálculo em segundo plano espera enquanto o orçamento está ocupado; um detalhamento expandido pode, em vez disso, mostrar Analytics is busy. Retry the breakdown shortly. (O serviço de análise está ocupado. Tente o detalhamento novamente em breve). Use Retry breakdown (Tentar detalhamento novamente) depois que outro cálculo terminar. Isso limita o trabalho de análise concorrente, mas não é uma garantia de latência de coleta constante nem de capacidade ilimitada. Um cálculo carregando ou com falha não é uma contagem zero.

Quando um cálculo termina, o próximo cálculo elegível em espera recebe sua vaga imediatamente. Abrir vários sites em uma conta não adiciona um atraso fixo de nova tentativa após cada cálculo concluído. Um cálculo em andamento nessa conta ainda precisa terminar primeiro; a preparação dos dados de origem aceitos, interrupções de armazenamento e instantâneos de recuperação podem atrasar quando um relatório fica pronto.

Entre em contato com segurança

Inclua capturas de tela dos erros quando ajudar. Não envie senhas, códigos de verificação, segredos de receita ou dados exportados de visitantes a menos que um processo de suporte seguro específico tenha sido combinado. Dúvidas de cobrança e conta podem ser descritas sem expor esses valores.

Algo não ficou claro? Fale com o suporte.