Configuração de Proxy First-Party

Sirva o rastreamento do Zenovay através do seu próprio domínio para contornar a proteção de rastreamento do navegador e bloqueadores de anúncios.

Por Que Usar um Proxy First-Party?

Navegadores modernos bloqueiam scripts de rastreamento de terceiros. Aqui está o que cada navegador bloqueia:

Como Funciona

Sem proxy (bloqueado):
Browser → api.zenovay.com ❌ (Third-party = bloqueado por navegadores)

Com proxy (funciona):
Browser → yourdomain.com/api/_z/* ✅ (First-party = permitido)
     ↓
Seu Servidor → api.zenovay.com/fp/* (Servidor-para-servidor = sempre funciona)

O navegador apenas vê requisições para SEU domínio, então a proteção de rastreamento não se aplica.

Entendendo Same-Origin (Crítico!)

As Duas Abordagens

O Que é "Same Origin"?

Navegadores definem "same origin" como: mesmo protocolo + mesmo domínio + mesma porta

https://yourdomain.com (seu site)

❌ https://z.yourdomain.com    → Origem diferente (subdomínio diferente)
❌ https://api.yourdomain.com  → Origem diferente (subdomínio diferente)
✅ https://yourdomain.com/api/ → MESMA origem (apenas um caminho)

Por Que Subdomínios Não Funcionam no Firefox

Mesmo que z.yourdomain.com pareça "primeira parte", o Firefox ETP o trata como de terceiros porque:

1. Verificação de origem: z.yourdomain.com ≠ yourdomain.com
2. Requisição cross-origin: O navegador faz requisição para uma origem diferente
3. ETP bloqueia: Firefox bloqueia requisições de rastreamento cross-origin

Por Que o Proxy Same-Domain Funciona

Com /api/_z/script.js:

1. Verificação de origem: yourdomain.com/api/_z/ = yourdomain.com ✅
2. Requisição same-origin: O navegador faz requisição first-party
3. ETP permite: Firefox permite requisições same-origin
4. Servidor proxifica: Seu servidor encaminha para o Zenovay (navegador nunca vê isso)

Escolha Sua Plataforma

Selecione sua plataforma de hospedagem para começar com um guia passo-a-passo detalhado:

Referência Rápida

Após a Configuração: Atualize Seu Script

Após configurar o proxy, atualize seu script de rastreamento. Você pode encontrar o snippet first-party nas configurações do seu domínio: abra Domains, clique em seu site, depois vá para a página General e selecione a aba First-Party no cartão de script de rastreamento.

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

<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>

Verifique Se Está Funcionando

Após configurar, verifique se o proxy está funcionando:

1. Verifique a Aba Network

1. Abra DevTools (F12 ou Cmd+Option+I)
2. Vá para a aba Network
3. Recarregue sua página
4. Procure por /api/_z/script.js (ou seu caminho de domínio customizado)
5. Deve mostrar status 200 do SEU domínio

2. Teste no Firefox (O Mais Rigoroso)

Firefox tem a proteção de rastreamento mais rigorosa:

1. Abra Firefox
2. Settings → Privacy & Security → Enhanced Tracking Protection: Strict
3. Visite seu site
4. Verifique se o script carrega com sucesso

Se funcionar no modo rigoroso do Firefox, funciona em qualquer lugar.

Referência de Endpoints de API

Seu proxy deve encaminhar estes caminhos:

Solução de Problemas

Tendo problemas? Verifique esses problemas comuns:

• Script retorna 404 - Verifique a configuração do caminho do proxy
• Erros CORS - Certifique-se de que seu proxy adiciona headers CORS
• Geolocalização incorreta - Encaminhe o IP do cliente com o header X-Zenovay-Real-IP
• Ainda bloqueado - Certifique-se de usar o caminho proxificado, não a URL direta

Para solução de problemas detalhada, consulte o guia específico de cada plataforma ou a página geral de solução de problemas.

Próximos Passos

• Eventos Customizados - Rastreie cliques de botão e envios de formulário
• Identificação de Visitante - Conecte análises a contas de usuário
• Solução de Problemas - Problemas comuns e soluções