Adicione o rastreador
Instale a tag de script do seu site e confira se os eventos chegam. Revise seus requisitos de consentimento antes de ativar a coleta.
1. Copie seu trecho
Entre, abra seu site e vá para Settings → Installation → Scripts (Configurações → Instalação → Scripts). Seu trecho se parece com este, com o token do seu próprio site. O estilo Minimal (Mínimo) mostrado aqui lê suas opções em Installation → Dashboard; o estilo Explicit (Explícito) grava as mesmas opções como atributos do script (veja Opções do script).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Mantenha os endereços do script e da API em https://app.seean.io, como mostrado acima, a menos que a coleta primária esteja ativada em Installation; nesse caso, o nome de host gerado <slug>-collect.seean.io - ou um domínio de coleta personalizado seu que esteja ativo - é usado para ambos. Um trecho existente que use esses endereços não precisa mudar quando o Seean atualiza sua infraestrutura.
2. Cole antes de </head>
Use o documento HTML compartilhado ou o layout raiz de todas as páginas que você quer medir. Siga o guia da sua plataforma para a posição correta. Instale o rastreador uma única vez: usar um layout e um gerenciador de tags ao mesmo tempo pode contar as visitas duas vezes.
O rastreador observa a navegação suportada pela History API, como / → /pricing. As strings de consulta não fazem parte do caminho da página; fragmentos de hash são ignorados a menos que você defina data-hash="true". Uma campanha marcada alterada ou uma sessão expirada ainda podem iniciar uma nova sessão e contar o mesmo caminho de novo. Carregue o rastreador como um script externo clássico; não o importe no bundle da sua aplicação nem adicione type="module".
3. Verifique
Abra o site publicado em uma aba normal do navegador e confira Settings → Installation → Setup health (Estado da instalação) do site correspondente. Last pageview received (Última visualização de página recebida) mostra o horário da visualização de página retida mais recente; antes de qualquer visualização, Installation verified (Instalação verificada) mostra quando a página publicada passou na verificação pela última vez. Use Check installation (Verificar instalação) para inspecionar a página inicial publicada em busca do rastreador, do token e da política de segurança. O Seean também verifica a página inicial publicada automaticamente em segundo plano (a cada minuto no primeiro dia do site), então a instalação é verificada assim que o trecho é publicado, mesmo com o painel fechado. O banner da Visão geral então desaparece sem esperar por uma visita.
Uma referência no código-fonte ou uma visita antiga não prova que sua implantação mais recente funciona. Confira um novo caminho de página e horário em Eventos usando as verificações de instalação. O guia de diagnóstico da configuração explica resultados, permissões e limites.
Opções do script
Installation → Dashboard guarda as opções de rastreamento do site: campanhas UTM (ativado), caminhos de página com hash (desativado), Web Vitals (ativado), conversões automáticas (ativado para sites novos e nunca configurados), registro de depuração (desativado) e nomes de host entre domínios. Save tracking options (Salvar opções de rastreamento) as armazena; um trecho mínimo as aplica no próximo carregamento de página. O estilo de trecho Explicit grava as mesmas escolhas como atributos:
| Atributo | Padrão | Efeito |
|---|---|---|
data-conversions="true" |
desativado em HTML puro | Carrega as predefinições de conversão automáticas ativadas uma vez por documento. Os trechos explícitos gerados o incluem enquanto Conversões automáticas está ativado. |
data-hash="true" |
desativado | Conta mudanças de location.hash como visualizações de página e informa o caminho com o fragmento, por exemplo /docs#install. |
data-utm="off" |
ativado | Para de ler utm_source, utm_medium e utm_campaign; um link marcado deixa de iniciar uma nova sessão. |
data-vitals="off" |
ativado | Pula totalmente a medição de Web Vitals (sem observadores de desempenho). |
data-debug="true" |
desativado | Faz console.debug de cada payload antes do envio. Seguro quando o console não está disponível. |
data-domains="a.com,b.com" |
desativado | Repasse entre domínios: links para os hosts listados (e seus subdomínios) carregam o ID do visitante, e uma página de destino adota um ID recebido. |
Quando qualquer um desses atributos está presente, as opções do painel são ignoradas para aquela página. Detalhes e padrões: Script e opções de rastreamento.
O que o rastreador envia
| Campo | O que é |
|---|---|
| path | o caminho da página, sem string de consulta (com o fragmento quando data-hash está ativado) |
| hostname | o site que está sendo medido |
| referrer | a URL de referência do navegador; o coletor guarda apenas seu nome de host |
| timezone | alternativa para o país quando a borda da rede não informa nenhum |
| visitorId, sessionId | as identidades padrão são derivadas no servidor por site e dia UTC; o repasse opcional entre domínios carrega a identidade no armazenamento de sessão do mesmo dia |
| campaign | UTM source, medium, campaign, term e content quando presentes, a menos que data-utm="off" |
| click id | o nome de um parâmetro de ID de clique de anúncio presente na URL de destino (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); o valor nunca é lido. Desativado com data-utm="off" |
| title | document.title, primeiros 200 caracteres |
| uid | seu próprio ID de usuário após seean.identify(id), armazenado apenas quando Identify users (Identificar usuários) está ativado para o site |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP e TTFB; medições posteriores podem atualizar uma amostra. Desativado com data-vitals="off" |
O coletor lê país, região e cidade dos cabeçalhos da borda da rede da requisição, usa o user agent para as categorias de navegador, sistema operacional e dispositivo, registra a primeira tag Accept-Language do navegador como idioma do visitante e pode usar a região desse idioma como alternativa para o país. O endereço IP é comparado apenas com as regras de exclusão e nunca é armazenado. Strings de consulta além dos campos UTM e do nome do ID de clique nunca são coletadas.
O rastreamento padrão usa um hash diário do servidor com escopo de site, sem cookies nem armazenamento de medição persistente no navegador. O repasse opcional entre domínios usa sessionStorage do mesmo dia. A coleta para com Do Not Track, Global Privacy Control ou a exclusão no navegador descrita em Exclusões. Onde o consentimento ou uma exclusão se aplicar, controle o carregamento do script pelo mecanismo de consentimento do seu site. Veja privacidade técnica e armazenamento e consentimento.
Desenvolvimento local
O rastreador ignora localhost e 127.0.0.1 a menos que você adicione data-local à tag de script. Use um site/token do Seean separado para o tráfego de teste e copie o endereço da API do trecho desse site. Navegadores automatizados, Do Not Track, Global Privacy Control e a exclusão no navegador ainda podem interromper a coleta; data-local não desativa essas verificações.
Remova ou atualize uma instalação
Remova o script do layout ou do gerenciador de tags e publique a alteração para interromper a coleta futura dessa instalação. Os relatórios existentes permanecem. Girar o token de rastreamento de um site invalida imediatamente os trechos antigos; atualize todas as instalações com o novo token. Veja configurações do site.
Algo não ficou claro? Fale com o suporte.