Quando você vê o banner Tracker não detectado no seu painel do Zenovay, significa que nossa verificação de detecção automática não conseguiu confirmar um tracker funcionando no seu site. A verificação é executada periodicamente e verifica duas coisas: se seu site é acessível e se recebemos eventos do seu código de rastreamento recentemente.
O que a verificação realmente faz
- Busca seu site com o User-Agent
ZenovayBot/1.0e lê o início do HTML para confirmar que a página é acessível. - Verifica eventos recentes do seu código de rastreamento (os últimos minutos e as últimas 24 horas).
- Compara com o ritmo normal do seu site para que um período calmo em um site com pouco tráfego não seja marcado como problema.
Se seu site não for acessível ou nenhum evento chegou por muito mais tempo que o usual, o banner aparece. O sinal mais importante é se os eventos estão realmente chegando, não se conseguimos ler seu HTML.
Causas comuns
1. O tracker está em uma subpágina mas não na inicial
A verificação recupera o endereço do site registrado (o campo URL do Domínio na página de configurações do site). Se você apenas adicionou o script a páginas específicas, a verificação pode dizer «não detectado» — mesmo que o rastreamento funcione bem nas páginas onde está instalado.
Solução: adicione o tracker ao layout / cabeçalho compartilhado do site para que carregue em todos os lugares, não apenas em algumas páginas. Ou atualize a URL do Domínio na página de configurações do site para um endereço que tenha o tracker. Para ir até lá, abra o site de Domínios, depois abra suas configurações (a aba Geral).
2. A renderização no servidor remove a tag
Alguns sistemas de templating removem tags <script> que consideram não essenciais, especialmente em builds de produção. Se você vê o script no seu build de desenvolvimento local mas não na fonte da página em produção, o build está removendo.
Solução: verifique sua configuração de build (painel de código personalizado Webflow, componente Script do Next.js, cache do tema WordPress).
3. O cache do CDN serve uma versão antiga
Se você adicionou o tracker recentemente mas seu CDN (Cloudflare, Fastly, Vercel Edge) está cacheando uma versão antiga da página, a verificação vê o HTML em cache.
Solução: purgue o cache da página. Espere alguns minutos e use Verificação de instalação na página de configurações do site.
4. O tracker é carregado mas não consegue alcançar api.zenovay.com
Às vezes o script carrega mas é impedido de postar eventos. Razões comuns:
- A diretiva CSP
connect-srcnão incluiapi.zenovay.com - Um firewall corporativo bloqueia o domínio
- Falha de rede na região dos seus visitantes
Abra DevTools → aba Network em uma visita real e procure por requisições falhadas para api.zenovay.com. A mensagem de erro dirá qual.
5. Discrepância no código de rastreamento
A verificação espera o código de rastreamento registrado. Se você o regenerou sem atualizar a tag script, o tracker carrega mas os eventos são rejeitados pelo código errado.
Solução: na página de configurações do site, encontre a seção Script de rastreamento (mesma página que o campo URL do Domínio), copie o código atual e confirme que o valor data-tracking-code combina com o do seu site em produção.
6. Desenvolvimento em localhost
Se sua URL do Domínio registrada é localhost:3000 ou similar, a verificação não consegue acessá-la pela internet pública. Isso é esperado — registre sua URL real em produção em seu lugar.
Re-executar a verificação de detecção
Depois de corrigir o problema:
- Abra a página de configurações do site e use o botão Verificação de instalação (ou aguarde — a verificação de detecção é re-executada periodicamente).
- O banner desaparece quando conseguimos confirmar um tracker funcionando E pelo menos um evento recente do seu código de rastreamento.
Ainda travado?
Se você percorreu a lista e o banner persiste:
- Abra a página de Status para confirmar que os serviços do Zenovay estão saudáveis.
- Envie um e-mail para [email protected] com a URL do seu site, o valor de
data-tracking-codena sua página em produção e uma captura do banner do painel.