Configuración de Proxy de Primera Parte

Sirve el seguimiento de Zenovay a través de tu propio dominio para evitar la protección de seguimiento del navegador y los bloqueadores de anuncios.

¿Por Qué Usar un Proxy de Primera Parte?

Los navegadores modernos bloquean scripts de seguimiento de terceros. Aquí hay lo que cada navegador bloquea:

Cómo Funciona

Sin proxy (bloqueado):
Browser → api.zenovay.com ❌ (Terceros = bloqueado por navegadores)

Con proxy (funciona):
Browser → yourdomain.com/api/_z/* ✅ (Primera parte = permitido)
     ↓
Your Server → api.zenovay.com/fp/* (Servidor a servidor = siempre funciona)

El navegador solo ve solicitudes a TU dominio, por lo que la protección de seguimiento no se aplica.

Entendiendo Same-Origin (¡Crítico!)

Los Dos Enfoques

¿Qué es "Same Origin"?

Los navegadores definen "mismo origen" como: mismo protocolo + mismo dominio + mismo puerto

https://yourdomain.com (tu sitio)

❌ https://z.yourdomain.com    → Diferente origen (subdominio diferente)
❌ https://api.yourdomain.com  → Diferente origen (subdominio diferente)
✅ https://yourdomain.com/api/ → MISMO origen (solo una ruta)

Por Qué los Subdominios No Funcionan para Firefox

Aunque z.yourdomain.com se ve "de primera parte", Firefox ETP lo trata como de terceros porque:

1. Verificación de origen: z.yourdomain.com ≠ yourdomain.com
2. Solicitud entre orígenes: El navegador hace una solicitud a un origen diferente
3. ETP bloquea: Firefox bloquea solicitudes de seguimiento entre orígenes

Por Qué el Proxy del Mismo Dominio Funciona

Con /api/_z/script.js:

1. Verificación de origen: yourdomain.com/api/_z/ = yourdomain.com ✅
2. Solicitud del mismo origen: El navegador hace una solicitud de primera parte
3. ETP permite: Firefox permite solicitudes del mismo origen
4. El servidor proxifica: Tu servidor reenvía a Zenovay (el navegador nunca lo ve)

Elige Tu Plataforma

Selecciona tu plataforma de alojamiento para comenzar con una guía detallada paso a paso:

Referencia Rápida

Después de la Configuración: Actualiza Tu Script

Una vez que hayas configurado el proxy, actualiza tu script de seguimiento. Puedes encontrar el fragmento de Primera Parte en la configuración de tu dominio: abre Dominios, haz clic en tu sitio, luego ve a la página General y selecciona la pestaña Primera Parte en la tarjeta de script de seguimiento.

<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>

Verifica Que Funciona

Después de configurar, verifica que el proxy está funcionando:

1. Comprueba la Pestaña de Red

1. Abre DevTools (F12 o Cmd+Option+I)
2. Ve a la pestaña Network
3. Recarga tu página
4. Busca /api/_z/script.js (o tu ruta de dominio personalizado)
5. Debe mostrar estado 200 desde TU dominio

2. Prueba en Firefox (Más Estricto)

Firefox tiene la protección de seguimiento más estricta:

1. Abre Firefox
2. Settings → Privacy & Security → Enhanced Tracking Protection: Strict
3. Visita tu sitio web
4. Verifica que el script se carga correctamente

Si funciona en modo estricto de Firefox, funciona en todas partes.

Referencia de Puntos Finales de API

Tu proxy debe reenviar estas rutas:

Solución de Problemas

¿Tienes problemas? Comprueba estos problemas comunes:

• El script devuelve 404 - Verifica la configuración de tu ruta proxy
• Errores CORS - Asegúrate de que tu proxy agregue encabezados CORS
• Geolocalización incorrecta - Reenvía la IP del cliente con el encabezado X-Zenovay-Real-IP
• Aún bloqueado - Asegúrate de estar usando la ruta proxificada, no la URL directa

Para solución de problemas detallada, consulta la guía específica de cada plataforma o la página general de solución de problemas.

Próximos Pasos

• Eventos Personalizados - Rastrea clics de botones y envíos de formularios
• Identificación de Visitantes - Conecta análisis a cuentas de usuario
• Solución de Problemas - Problemas comunes y soluciones