Saltar al contenido principal
Zenovaydocs
6 min de lectura

Instalación del Script de Rastreo

Añade analíticas de Zenovay a tu sitio web con una única línea de código. No requiere configuración.

Instalación Rápida (30 segundos)

Copia este script y pégalo en la sección <head> de tu sitio web:

Instalación BásicaHTML
<!-- Zenovay Analytics v2.0.6 -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Reemplaza YOUR_TRACKING_CODE con tu código de rastreo del Panel de Control de Zenovay. Se ve así: ZV_ABC123XYZ.

Tarjeta del script de rastreo en la configuración del dominio mostrando el fragmento de script con pestañas HTML, React, Next.js y First-Party, y un botón de Verificar Instalación
Encuentra tu código de rastreo en Dominios → tu sitio → Configuración General.

¡Eso es todo! El script rastrea automáticamente:

  • Vistas de página
  • Sesiones de visitantes
  • Ubicación geográfica
  • Información de dispositivo y navegador
  • Fuentes de referencia
  • Parámetros UTM

Instalación Específica por Framework

HTML / Sitios Estáticos

Añade directamente antes de la etiqueta de cierre </head>:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<title>My Website</title>
<!-- Zenovay Analytics v2.0.6 -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<!-- Your content -->
</body>
</html>

React

Añade el script en el useEffect del componente raíz:

App.jsx or index.jsJSX
import { useEffect } from 'react';

function App() {
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://api.zenovay.com/z.js';
  script.defer = true;
  script.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
  document.head.appendChild(script);
}, []);

return <div>Your App</div>;
}

export default App;

Next.js (App Router)

Añade a tu archivo de diseño raíz:

app/layout.tsxTSX
import Script from 'next/script';

export default function RootLayout({ children }) {
return (
  <html lang="en">
    <head>
      <Script
        src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        strategy="afterInteractive"
      />
    </head>
    <body>{children}</body>
  </html>
);
}

Next.js (Pages Router)

Añade a tu archivo _document.tsx:

pages/_document.tsxTSX
import { Html, Head, Main, NextScript } from 'next/document';
import Script from 'next/script';

export default function Document() {
return (
  <Html>
    <Head>
      <Script
        src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        strategy="afterInteractive"
      />
    </Head>
    <body>
      <Main />
      <NextScript />
    </body>
  </Html>
);
}

Vue.js

Añade a tu archivo index.html o úsalo en App.vue:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<!-- Zenovay Analytics -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>

WordPress

Opción 1: Usando un Plugin (Recomendado)

  1. Instala el plugin Insert Headers and Footers
  2. Ve a Configuración → Insert Headers and Footers
  3. Pega esto en "Scripts in Header":
WordPress Header ScriptHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Opción 2: Editar Tema

Añade a header.php antes de </head>:

wp-content/themes/your-theme/header.phpPHP
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Shopify

  1. Ve a Online Store → Themes
  2. Haz clic en Actions → Edit code
  3. Abre theme.liquid
  4. Añade antes de </head>:
theme.liquidHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Webflow

  1. Ve a Project Settings → Custom Code
  2. Pega en la sección Head Code:
Webflow Head CodeHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Squarespace

  1. Ve a Settings → Advanced → Code Injection
  2. Pega en la sección Header

Verificar la Instalación

1. Verificar la Consola del Navegador

Abre las herramientas de desarrollador de tu navegador (F12) y busca:

[Zenovay] Script executing... (v2.0.6)
Zenovay Analytics loaded { trackingCode: 'YOUR_TRACKING_CODE', enabled: true }

2. Activar Modo de Depuración

Para ver registros detallados, activa el modo de depuración en la configuración General de tu dominio (Dominios → selecciona tu sitio → General) o añade el atributo de depuración:

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

Para una vista visual en la página de cada evento que envía tu rastreador — tipo, propiedades, modo sin cookies, estado GPC, estado del consentimiento — activa el Debug Overlay en la configuración de tu dominio y carga cualquier página añadiendo ?zenovay_debug=1 a la URL. Los datos personales se enmascaran.

3. Verificar el Panel de Control en Tiempo Real

Visita tu Panel de Control de Zenovay y verifica la vista en Tiempo Real para ver tu visita aparecer en directo.

Atributos del Script

Personaliza el comportamiento con atributos de datos:

AtributoTipoPor DefectoDescripción
data-tracking-codestringrequeridoTu código de rastreo (p. ej., ZV_ABC123)
data-debugbooleanfalseMostrar registros en la consola
data-allow-localhostbooleanfalseRastrear visitas a localhost

Protección contra Bloqueadores de Anuncios

Algunos bloqueadores de anuncios pueden bloquear api.zenovay.com. Usa nuestro Proxy de Primera Parte para una precisión de rastreo del 100%:

Si ves solicitudes bloqueadas en Firefox o Edge, configura un Proxy de Primera Parte para enrutar el rastreo a través de tu propio dominio.

First-Party Proxy ScriptHTML
<!-- First-Party Proxy (bypasses ad blockers) -->
<!-- Requires proxy setup - see: docs.zenovay.com/guides/first-party-tracking -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>

Política de Seguridad de Contenido (CSP)

Si tu sitio usa encabezados CSP, añade Zenovay:

CSP HeadersTEXT
Content-Security-Policy:
script-src 'self' https://api.zenovay.com;
connect-src 'self' https://api.zenovay.com;

Solución de Problemas

El Script No Se Carga

  1. Verifica que no haya errores de escritura en tu código de rastreo
  2. Verifica que el script esté en <head> no en <body>
  3. Comprueba los encabezados CSP - añade api.zenovay.com a las fuentes permitidas
  4. Desactiva el bloqueador de anuncios temporalmente para probar

Sin Eventos en el Panel de Control

  1. Espera 30 segundos - los eventos se agrupan en lotes
  2. Comprueba la consola del navegador por si hay errores
  3. Activa el modo de depuración para ver los registros de eventos
  4. Prueba en una ventana incógnito/privada para descartar extensiones

Bloqueador de Anuncios Bloqueando el Script

Configura un Proxy de Primera Parte para enrutar el rastreo a través de tu dominio.

Usar IA para Instalar

Si estás usando asistentes de codificación con IA (Cursor, Lovable, Replit), consulta nuestros Prompts de Integración con IA para prompts que puedas copiar y pegar.

Pasos Siguientes

¿Fue útil esta página?