Se você quer manter o rastreamento no seu próprio domínio e reduzir perdas por ad-blockers, a maneira de fazer isso com o Zenovay é um proxy first-party — um subdomínio no seu próprio domínio que encaminha requisições de rastreamento para o Zenovay, para que o navegador apenas fale com seu domínio.
Existem duas coisas diferentes que as pessoas querem dizer com "server-side GTM" com o Zenovay. Este artigo cobre ambas e é claro sobre o que cada uma pode e não pode fazer.
Informação
O Zenovay NÃO publica um modelo de cliente de contenedor de servidor do Google Tag Manager. O modelo Zenovay GTM é um modelo de tag padrão de web-container que carrega o tracker (z.js) na página a partir de https://api.zenovay.com. O modelo GTM não pode ser apontado para um proxy first-party — sua URL de carregador é fixa. Se você quer um proxy first-party, instale o tracker manualmente (com data-api-url) em vez de usar o modelo GTM — consulte First-party tracking. Se você prefere pular GTM completamente, você pode enviar eventos diretamente para o endpoint de rastreamento — consulte Server-side tracking.
Opção A — Implantar via o modelo Zenovay GTM
Este é o caminho sem código. A tag carrega z.js diretamente de https://api.zenovay.com. Ela NÃO é roteada através de um proxy — se contornar ad-blockers é seu objetivo, use a Opção B em vez disso.
Passo 1 — Adicionar o modelo Zenovay GTM
- No Google Tag Manager (seu contenedor Web), vá para Templates → Tag Templates → Search Gallery.
- Procure por Zenovay e adicione Zenovay Analytics ao seu workspace. (Se ainda não estiver na galeria, você pode importar
template.tpldo repositório de modelos Zenovay GTM em vez disso.) - Clique em Add to workspace.
Passo 2 — Configurar a tag
- Tags → New → Zenovay Analytics (sob Custom).
- Configurações (o modelo tem exatamente esses quatro campos):
- Tracking Code — cole seu código de rastreamento do Zenovay (de Settings → General no dashboard do seu site).
- Cookieless Mode — opcional. Veja Modo cookieless abaixo.
- Track Outbound Links — opcional; rastreia automaticamente cliques em domínios externos.
- Debug Mode — opcional; verbose console logging. Desligue antes de publicar.
- Defina o trigger para All Pages.
- Salvar → Submit → Publish.
Informação
O script Zenovay detecta mudanças de rota SPA via a History API, portanto o trigger All Pages é tudo que você precisa — nenhum trigger History Change separado necessário.
Passo 3 — Verificar
- Abra uma visita real no seu site.
- No modo Preview do GTM, confirme que a tag Zenovay Analytics dispara na página.
- DevTools → Network → filtre por
z.js— você deveria vê-lo carregar deapi.zenovay.com. - Abra a aba Live View no dashboard do seu site — a visita deveria aparecer em alguns segundos.
Opção B — Proxy first-party (contorno de ad-blocker)
Um proxy first-party mantém o rastreamento no seu próprio domínio. Adiciona overhead operacional — você executa um pequeno reverse-proxy em um subdomínio do seu próprio domínio e o mantém. Vale a pena se:
- Você está vendo perda de dados significativa por ad-blockers e quer entrega em domínio first-party.
- Sua equipe de segurança/legal exige que todas as requisições HTTP a terceiros sejam servidas do seu próprio origem.
Se nenhum desses se aplica, o tracker client regular (Opção A ou um snippet simples) é mais simples. O proxy first-party está disponível em todos os planos.
Informação
O modelo GTM não pode fazer isso — sua URL de carregador é fixa para api.zenovay.com. O proxy precisa do snippet de rastreamento manual, onde você controla o src e data-api-url. Assim, essa opção não usa o modelo Zenovay GTM.
Como funciona
Navegador → https://analytics.example.com → https://api.zenovay.com
(seu proxy first-party)
O navegador apenas vê analytics.example.com (seu domínio). Seu proxy busca z.js do Zenovay e encaminha requisições de rastreamento para o Zenovay.
Passo 1 — Configurar um proxy first-party
Crie um subdomínio no seu próprio domínio (por ex. analytics.example.com) e configure-o para fazer reverse-proxy para https://api.zenovay.com. Os passos exatos dependem da sua stack (Cloudflare, nginx, Cloud Run / função serverless, etc.) — o guia First-party tracking o guia pelas opções.
O proxy deve:
- Servir
z.js(encaminhado dehttps://api.zenovay.com/z.js). - Encaminhar requisições de rastreamento para o Zenovay, passando o IP real do visitante via
X-Forwarded-Forpara que a detecção país/cidade ainda funcione no lado do Zenovay.
Passo 2 — Apontar o snippet de rastreamento para seu proxy
Instale o tracker manualmente (não via o modelo GTM), com src e data-api-url definidos para seu subdomínio proxy:
<script
defer
src="https://analytics.example.com/z.js"
data-tracking-code="YOUR_TRACKING_CODE"
data-api-url="https://analytics.example.com"
></script>
Você ainda pode colocar este snippet via GTM se quiser — use uma tag Custom HTML com o trigger All Pages em vez da tag de modelo Zenovay.
Passo 3 — Verificar de ponta a ponta
- Abra uma visita real no seu site.
- DevTools → Network → filtre por
analytics.example.com— você deveria verz.jscarregando e requisições de rastreamento sendo roteadas através do seu domínio proxy. - Abra a aba Live View no dashboard do seu site — a visita deveria aparecer em alguns segundos.
Modo cookieless
Você pode executar cookieless de qualquer uma das formas. No modelo GTM, ative Cookieless Mode ; com um snippet manual, adicione data-cookieless="true". Em modo cookieless, o tracker usa apenas IDs em memória, limitados à janela — nenhum cookie é escrito, nem na página nem através de um proxy.
Disponibilidade do plano
Tanto o modelo GTM quanto o proxy first-party funcionam em todos os planos, Free incluído. Os eventos rastreados contam para sua alocação mensal de eventos do plano da mesma forma, independentemente de como o tracker é carregado.