O tracker do Zenovay é uma única tag <script>. Adicioná-lo a qualquer site é um processo de 5 passos.
Os 5 passos
Obtenha seu código de rastreamento
Faça login em app.zenovay.com. Se você ainda não adicionou o site, clique em Adicionar um site — o assistente mostra seu snippet (com o código de rastreamento já preenchido) ao final.
Para um site que você já adicionou, abra-o a partir de Domínios, vá para Configurações e selecione a aba Geral. O snippet pronto para copiar está sob a seção Script de rastreamento. O código de rastreamento é uma string de 12 caracteres como
aB3xK9mP2qR7.Cole a tag script no head HTML do seu site
A instalação padrão é uma única tag na seção
<head>de cada página:<script defer src="https://api.zenovay.com/z.js" data-tracking-code="YOUR_TRACKING_CODE" ></script>Substitua
YOUR_TRACKING_CODEpelo valor do passo 1.Faça o deploy da alteração
O passo exato de deploy depende da sua plataforma — empurre o commit, clique em Save no seu CMS, ou republique seu site no-code. Espere até que a alteração esteja ao vivo no seu domínio real (não só no staging).
Visite seu site e observe a aba Live
Abra seu site em uma janela anônima. Em até 30 segundos, sua visita deve aparecer na aba Live do painel do Zenovay com a localização correta.
Se nada aparecer — diagnostique
Se sua visita não apareceu após 60 segundos, verifique a instalação com primeiro evento não aparece. As causas mais comuns são: código de rastreamento incorreto, bloqueador de anúncios no navegador de teste, ou teste em
localhost.
Guias específicos por plataforma
Escolha a página que combina com sua stack:
| Plataforma | Guia |
|---|---|
| Webflow | Instalar no Webflow |
| WordPress | Integração com WordPress |
| Shopify | Integração com Shopify |
| Next.js | Integração com Next.js |
| React (Create React App, Vite, etc.) | Integração com React |
| Vue | Integração com Vue |
| Google Tag Manager | Instalar via GTM |
| Qualquer outra coisa | Framework personalizado |
Onde a tag script deve ir
A tag script vai no <head> de cada página que você quer rastrear. A localização exata varia por plataforma:
- HTML escrito à mão — diretamente dentro de
<head>, logo antes de</head> - WordPress —
header.phpdo tema ou via actionwp_head - Shopify —
theme.liquid, logo antes de</head> - Next.js —
<Script>no seu layout raiz, comstrategy="afterInteractive" - Webflow — Site settings → Custom code → Head code
- GTM — tag HTML personalizada com gatilho
All Pages
O que o atributo defer faz
defer diz ao navegador: «Carregue este script enquanto faz o parse da página, mas não execute até que a página seja parseada». Isso significa que o tracker não atrasa a renderização da sua página — pontuações do Lighthouse permanecem limpas.
O que NÃO é necessário
Você não precisa:
- Instalar um pacote npm (a menos que use um bundler — veja instalação npm)
- Adicionar um banner de cookies só por causa do Zenovay (modo sem cookies é o padrão — veja preciso de um banner de cookies)
- Configurar uma entrada de política de privacidade (recomendado, mas o tracker funciona sem)
- Whitelistar nada na sua CSP a menos que tenha uma CSP rigorosa — neste caso, permita
https://api.zenovay.comemscript-srceconnect-src