Cloudflare Zaraz

Implante o Zenovay Analytics por meio do Cloudflare Zaraz sem mexer no código-fonte do seu site. O Zaraz move scripts de terceiros para a edge, deixando o impacto da analytics praticamente imperceptível no tempo de carregamento.

---

Por que usar o Zaraz?

O Zaraz é o produto de gerenciamento de tags da Cloudflare. Diferente dos gerenciadores de tags tradicionais do lado cliente, o Zaraz:

• Executa na edge — o script de rastreamento é injetado pela rede da Cloudflare, não por um CDN externo.
• Não bloqueia o render — sem impacto sobre os Core Web Vitals (LCP, INP).
• Respeita o consentimento através do Consent Manager nativo (funciona com o modo sem cookies do Zenovay).
• Sem build — cole um snippet de Custom HTML, salve e pronto.

O Zaraz está incluído em todos os planos Cloudflare, inclusive o gratuito.

---

Instalação via Custom HTML (Recomendada)

Tempo necessário: cerca de 3 minutos

Passo 1 — Abrir o Zaraz

1. Faça login no painel da Cloudflare
2. Selecione a conta dona da sua zona (o Zaraz é configurado no nível da conta, não por zona)
3. Na barra lateral esquerda, expanda Tag Management → clique em Zaraz

Ou abra o Zaraz diretamente — o placeholder :account é resolvido automaticamente para a conta Cloudflare selecionada no momento.

Passo 2 — Adicionar a ferramenta Custom HTML

1. Clique em Add new tool
2. No catálogo, role até Custom Code e selecione Custom HTML
3. Dê um nome à ferramenta: Zenovay Analytics

Passo 3 — Colar o snippet de rastreamento

No campo HTML, cole:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Passo 4 — Configurar o gatilho

Defina o Firing Trigger como Pageview.

• Firing Trigger: Pageview (obrigatório)
• Blocking Triggers: deixar vazio
• Match: Todas as páginas (sem filtro)

Passo 5 — Salvar e publicar

1. Clique em Save
2. O Zaraz publica imediatamente — sem etapa de deploy separada

Abra seu site em uma nova aba. Em menos de um minuto, o primeiro visitante deve aparecer no painel do Zenovay.

---

Modo sem cookies

O modo sem cookies do Zenovay também funciona no Zaraz. Substitua o snippet do passo 3 por:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  data-cookieless="true"
  src="https://api.zenovay.com/z.js">
</script>

Com data-cookieless="true", o Zenovay não grava cookies nem usa localStorage. Isso combina naturalmente com a execução na edge do Zaraz: o navegador do visitante nunca recebe um cookie de rastreamento, atendendo por padrão a ePrivacy / TDDDG / FMG art. 45c.

---

Eventos personalizados

O Zaraz pode chamar window.zenovay() diretamente em qualquer Action do Zaraz. Para enviar um evento personalizado:

1. No Zaraz, abra Custom HTML → adicione uma segunda ferramenta (ou edite a existente)
2. Use este padrão de snippet:

<script>
  if (window.zenovay) {
    window.zenovay('track', 'signup', { plan: 'pro' });
  }
</script>

3. Defina o gatilho no seu evento Zaraz personalizado (por exemplo, um Click trigger no botão de cadastro)

Para todos os helpers de eventos disponíveis, veja Custom Events.

---

Modo consentimento (LGPD / ePrivacy)

Se você usa o Consent Manager embutido do Zaraz:

1. Abra a ferramenta Zenovay → aba Consent
2. Defina Consent Purpose como Analytics (ou a categoria à qual seus visitantes deram consentimento)
3. Salve

Se seus visitantes recusarem o consentimento de analytics, o Zaraz não disparará a ferramenta Zenovay. Para operar sem banner de consentimento, ative o modo sem cookies acima — o Zenovay opera então em conformidade legal sob ePrivacy art. 5(3) sem consentimento.

---

Proxy first-party (driblar bloqueadores de anúncios)

Se você configurou um proxy first-party em um subdomínio próprio (por exemplo analytics.seudominio.com), altere o src do snippet Zaraz para a URL do seu proxy:

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://analytics.seudominio.com/z.js">
</script>

Como o Zaraz já roda na edge para sua zona, combinar com um proxy first-party oferece resistência máxima contra bloqueadores.

---

Suporte a SPA (React, Next.js, Vue, Angular)

O script de rastreamento do Zenovay detecta mudanças de rota em apps single-page automaticamente. Nenhum gatilho adicional do Zaraz é necessário — o gatilho Pageview padrão já basta.

---

Verificando a instalação

Após publicar no Zaraz, a forma mais simples de verificar é:

1. Abra seu site em uma janela Anônima / Privada
2. Abra as Ferramentas de desenvolvedor → aba Network
3. Filtre por zenovay
4. Recarregue a página

Você deve ver uma requisição para https://api.zenovay.com/z.js (o bundle do rastreador) e ao menos uma para /api/track/... (o evento Pageview). Ambas devem retornar HTTP 200.

No painel do Zenovay, o cartão Setup → Installation do seu domínio muda para "Verified" em cerca de 30 segundos após o primeiro evento.

---

Solução de problemas

---

Impacto em performance

Como o Zaraz injeta o script na edge da Cloudflare — antes do HTML chegar ao navegador do visitante — o rastreador é tratado como parte da origem do seu site. Sem resolução DNS de terceiros, sem handshake TLS extra e sem requisição externa que bloqueie o render.

Em um site típico, trocar um rastreador Zenovay injetado no <head> por um injetado via Zaraz remove uma resolução DNS (~20-60 ms) e um handshake TLS (~80-200 ms) do caminho crítico.

---

Recursos relacionados

• Referência do script de rastreamento
• Custom Events
• Conformidade de privacidade
• Rastreamento first-party
• Google Tag Manager — caminho alternativo de gerenciamento de tags
• Documentação do Cloudflare Zaraz (externo)

---

Precisa de ajuda? Fale com [email protected] ou acesse a Central de ajuda.