Pular para o conteúdo principal
Zenovaydocs
6 min de leitura

Instalação do Script de Rastreamento

Adicione análises do Zenovay ao seu site com uma única linha de código. Nenhuma configuração necessária.

Instalação Rápida (30 segundos)

Copie este script e cole-o na seção <head> do seu site:

Basic InstallationHTML
<!-- Zenovay Analytics v2.0.6 -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Substitua YOUR_TRACKING_CODE pelo seu código de rastreamento do Painel do Zenovay. Ele se parece com ZV_ABC123XYZ.

O cartão do script de rastreamento nas configurações de domínio mostrando o snippet do script com abas HTML, React, Next.js e First-Party, e um botão Verificar Instalação
Encontre seu código de rastreamento em Domínios → seu site → Configurações gerais.

Pronto! O script rastreia automaticamente:

  • Visualizações de página
  • Sessões de visitantes
  • Localização geográfica
  • Informações do dispositivo e navegador
  • Fontes de referência
  • Parâmetros UTM

Instalação Específica do Framework

HTML / Sites Estáticos

Adicione diretamente antes da tag de fechamento </head>:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<title>My Website</title>
<!-- Zenovay Analytics v2.0.6 -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<!-- Your content -->
</body>
</html>

React

Adicione o script no useEffect do seu componente raiz:

App.jsx or index.jsJSX
import { useEffect } from 'react';

function App() {
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://api.zenovay.com/z.js';
  script.defer = true;
  script.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
  document.head.appendChild(script);
}, []);

return <div>Your App</div>;
}

export default App;

Next.js (App Router)

Adicione ao seu arquivo de layout raiz:

app/layout.tsxTSX
import Script from 'next/script';

export default function RootLayout({ children }) {
return (
  <html lang="en">
    <head>
      <Script
        src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        strategy="afterInteractive"
      />
    </head>
    <body>{children}</body>
  </html>
);
}

Next.js (Pages Router)

Adicione ao seu _document.tsx:

pages/_document.tsxTSX
import { Html, Head, Main, NextScript } from 'next/document';
import Script from 'next/script';

export default function Document() {
return (
  <Html>
    <Head>
      <Script
        src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        strategy="afterInteractive"
      />
    </Head>
    <body>
      <Main />
      <NextScript />
    </body>
  </Html>
);
}

Vue.js

Adicione ao seu index.html ou use no App.vue:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<!-- Zenovay Analytics -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>

WordPress

Opção 1: Usando um Plugin (Recomendado)

  1. Instale o plugin Insert Headers and Footers
  2. Acesse Settings → Insert Headers and Footers
  3. Cole isto em "Scripts in Header":
WordPress Header ScriptHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Opção 2: Editar Tema

Adicione ao header.php antes de </head>:

wp-content/themes/your-theme/header.phpPHP
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Shopify

  1. Acesse Online Store → Themes
  2. Clique em Actions → Edit code
  3. Abra theme.liquid
  4. Adicione antes de </head>:
theme.liquidHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Webflow

  1. Acesse Project Settings → Custom Code
  2. Cole na seção Head Code:
Webflow Head CodeHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Squarespace

  1. Acesse Settings → Advanced → Code Injection
  2. Cole na seção Header

Verificar Instalação

1. Verificar o Console do Navegador

Abra as ferramentas do desenvolvedor do seu navegador (F12) e procure por:

[Zenovay] Script executing... (v2.0.6)
Zenovay Analytics loaded { trackingCode: 'YOUR_TRACKING_CODE', enabled: true }

2. Ativar Modo de Depuração

Para ver logs detalhados, ative o modo de depuração nas configurações gerais do seu domínio (Domínios → selecione seu site → Geral) ou adicione o atributo de depuração:

Debug ModeHTML
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
data-debug="true"
src="https://api.zenovay.com/z.js">
</script>

Para uma visualização visual, dentro da página, de cada evento que o rastreador envia — tipo, propriedades, modo sem cookies, estado GPC, estado do consentimento — ative o Debug Overlay nas configurações do seu domínio e carregue qualquer página com ?zenovay_debug=1 acrescentado à URL. Os dados pessoais são mascarados.

3. Verificar o Painel em Tempo Real

Visite seu Painel do Zenovay e verifique a visualização em Tempo Real para ver sua visita aparecendo ao vivo.

Atributos do Script

Personalize o comportamento com atributos de dados:

AtributoTipoPadrãoDescrição
data-tracking-codestringobrigatórioSeu código de rastreamento (por ex., ZV_ABC123)
data-debugbooleanfalseMostrar logs do console
data-allow-localhostbooleanfalseRastrear visitas de localhost

Proteção contra Bloqueadores de Anúncios

Alguns bloqueadores de anúncios podem bloquear api.zenovay.com. Use nosso Proxy First-Party para 100% de precisão no rastreamento:

Se você está vendo solicitações bloqueadas no Firefox ou Edge, configure um Proxy First-Party para rotear o rastreamento através do seu próprio domínio.

First-Party Proxy ScriptHTML
<!-- First-Party Proxy (bypasses ad blockers) -->
<!-- Requires proxy setup - see: docs.zenovay.com/guides/first-party-tracking -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>

Política de Segurança de Conteúdo (CSP)

Se seu site usa headers de CSP, adicione o Zenovay:

CSP HeadersTEXT
Content-Security-Policy:
script-src 'self' https://api.zenovay.com;
connect-src 'self' https://api.zenovay.com;

Solução de Problemas

Script Não Carregando

  1. Verifique erros de digitação no seu código de rastreamento
  2. Verifique se o script está em <head> e não em <body>
  3. Verifique os headers de CSP - adicione api.zenovay.com às fontes permitidas
  4. Desative o bloqueador de anúncios temporariamente para testar

Sem Eventos no Painel

  1. Aguarde 30 segundos - os eventos são agrupados em lote
  2. Verifique o console do navegador para erros
  3. Ative o modo de depuração para ver os logs de eventos
  4. Tente uma janela incógnita/privada para descartar extensões

Bloqueador de Anúncios Bloqueando o Script

Configure um Proxy First-Party para rotear o rastreamento através do seu domínio.

Usando IA para Instalar

Se você está usando assistentes de codificação com IA (Cursor, Lovable, Replit), verifique nossos AI Integration Prompts para prompts prontos para colar.

Próximos Passos

Esta página foi útil?