Cloudflare Zaraz

Despliega Zenovay Analytics a través de Cloudflare Zaraz sin modificar el código fuente de tu sitio. Zaraz traslada los scripts de terceros al edge, por lo que añadir analytics tiene un impacto prácticamente nulo en el tiempo de carga.

---

¿Por qué Zaraz?

Zaraz es el producto de gestión de tags de Cloudflare. A diferencia de los gestores de tags clásicos del lado cliente, Zaraz:

• Se ejecuta en el edge — el script de seguimiento lo inyecta la red de Cloudflare, no un CDN externo.
• No bloquea el renderizado — sin impacto en los Core Web Vitals (LCP, INP).
• Respeta el consentimiento mediante su Consent Manager integrado (compatible con el modo sin cookies de Zenovay).
• Sin paso de build — pega un snippet Custom HTML, guarda y listo.

Zaraz está incluido en todos los planes de Cloudflare, incluido el gratuito.

---

Instalación vía Custom HTML (Recomendada)

Tiempo: aproximadamente 3 minutos

Paso 1 — Abrir Zaraz

1. Inicia sesión en el panel de Cloudflare
2. Selecciona la cuenta propietaria de tu zona (Zaraz se configura a nivel de cuenta, no por zona)
3. En la barra lateral izquierda, despliega Tag Management → haz clic en Zaraz

O abre Zaraz directamente — el marcador :account se resuelve automáticamente a tu cuenta de Cloudflare seleccionada en este momento.

Paso 2 — Añadir la herramienta Custom HTML

1. Haz clic en Add new tool
2. En el catálogo, baja hasta Custom Code y selecciona Custom HTML
3. Da un nombre a la herramienta: Zenovay Analytics

Paso 3 — Pegar el snippet de seguimiento

En el campo HTML, pega:

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

Paso 4 — Configurar el disparador

Ajusta el Firing Trigger a Pageview.

• Firing Trigger: Pageview (obligatorio)
• Blocking Triggers: dejar vacío
• Match: Todas las páginas (sin filtro)

Paso 5 — Guardar y publicar

1. Haz clic en Save
2. Zaraz publica de inmediato — sin paso de despliegue separado

Abre tu sitio en una pestaña nueva. En menos de un minuto, tu primer visitante debería aparecer en el panel de Zenovay.

---

Modo sin cookies

El modo sin cookies de Zenovay también funciona en Zaraz. Sustituye el snippet del paso 3 por:

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

Con data-cookieless="true", Zenovay no escribe cookies ni usa localStorage. Esto encaja de forma natural con la ejecución edge de Zaraz: el navegador del visitante nunca recibe una cookie de seguimiento, cumpliendo por defecto con ePrivacy / TDDDG / FMG art. 45c.

---

Eventos personalizados

Zaraz puede llamar a window.zenovay() directamente desde cualquier Action de Zaraz. Para enviar un evento personalizado:

1. En Zaraz, abre Custom HTML → añade una segunda herramienta (o edita la existente)
2. Usa este patrón de snippet:

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

3. Configura el trigger en tu evento personalizado de Zaraz (por ejemplo, un Click trigger en el botón de registro)

Para todos los helpers de eventos disponibles, consulta Custom Events.

---

Modo consentimiento (RGPD / ePrivacy)

Si usas el Consent Manager integrado en Zaraz:

1. Abre la herramienta Zenovay → pestaña Consent
2. Establece Consent Purpose en Analytics (o la categoría a la que tus visitantes han dado consentimiento)
3. Guarda

Si tus visitantes rechazan el consentimiento de analítica, Zaraz no disparará la herramienta Zenovay. Si prefieres operar sin banner de consentimiento, activa el modo sin cookies arriba — Zenovay opera entonces de forma legal bajo ePrivacy art. 5(3) sin consentimiento.

---

Proxy first-party (evitar bloqueadores de anuncios)

Si has configurado un proxy first-party en tu propio subdominio (por ejemplo analytics.tudominio.com), cambia la src del snippet de Zaraz por la URL de tu proxy:

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

Como Zaraz ya se ejecuta en el edge para tu zona, combinarlo con un proxy first-party ofrece la máxima resistencia frente a bloqueadores de anuncios.

---

Soporte SPA (React, Next.js, Vue, Angular)

El script de seguimiento de Zenovay detecta cambios de ruta en aplicaciones single-page de forma automática. No necesitas triggers adicionales de Zaraz — el trigger Pageview por defecto es suficiente.

---

Verificar la instalación

Después de publicar en Zaraz, la forma más fácil de comprobar es:

1. Abre tu sitio en una ventana de Incógnito / Privada
2. Abre las herramientas de desarrollador → pestaña Network
3. Filtra por zenovay
4. Recarga la página

Deberías ver una petición a https://api.zenovay.com/z.js (el bundle del tracker) y al menos una a /api/track/... (el evento Pageview). Ambas deben responder con HTTP 200.

En el panel de Zenovay, abre Domains → your site → General — la tarjeta Tracking script muestra "Verified" en unos 30 segundos tras el primer evento.

---

Resolución de problemas

---

Impacto en el rendimiento

Como Zaraz inyecta el script en el edge de Cloudflare — antes de que el HTML llegue al navegador del visitante — el tracker se trata como parte del origen de tu sitio. Sin resolución DNS de terceros, sin handshake TLS extra y sin petición externa que bloquee el renderizado.

En un sitio típico, pasar de un tracker Zenovay inyectado en <head> a uno inyectado vía Zaraz elimina una resolución DNS (~20-60 ms) y un handshake TLS (~80-200 ms) de la ruta crítica.

---

Recursos relacionados

• Referencia del script de seguimiento
• Custom Events
• Cumplimiento de privacidad
• Tracking first-party
• Google Tag Manager — vía alternativa de gestión de tags
• Documentación de Cloudflare Zaraz (externa)

---

¿Necesitas ayuda? Escribe a [email protected] o visita nuestro Centro de ayuda.