6 min de lectura

Indicaciones de Integración de IA

Utiliza estas indicaciones con asistentes de codificación de IA (Cursor, Lovable, Replit, Windsurf, etc.) para instalar el seguimiento de Zenovay en tu sitio web.

¿Construyendo con la API de Zenovay? Consulta Indicaciones de API para Asistentes de IA — 8 indicaciones listas para usar para crear paneles, widgets, mapas, resúmenes de correo electrónico y más usando la API externa.

Reemplaza YOUR_TRACKING_CODE con tu código de seguimiento real del Panel de Zenovay. Se ve como ZV_ABC123XYZ.

Indicación de Instalación Básica

Copia esta indicación y pégala en tu asistente de IA:

Copia esta indicaciónTEXT

I need to add Zenovay Analytics tracking to my website.

My tracking code is: YOUR_TRACKING_CODE

Please add the Zenovay tracking script to my website:

Add this script to the <head> section of my HTML or root layout file:

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

For React/Next.js apps:
- Add it to the root layout file (app/layout.tsx or pages/_app.tsx)
- Use the Next.js Script component with strategy="afterInteractive"

The script should load on every page. That's all - Zenovay handles everything automatically.

Indicación Específica para Next.js

Para Proyectos Next.jsTEXT

Add Zenovay Analytics to my Next.js project.

My tracking code is: YOUR_TRACKING_CODE

In my app/layout.tsx (or pages/_app.tsx for Pages Router), add:

import Script from 'next/script'

Then in the <head> section:

<Script
src="https://api.zenovay.com/z.js"
data-tracking-code="YOUR_TRACKING_CODE"
strategy="afterInteractive"
/>

Make sure the Script component is imported from 'next/script'.

Indicación para React (Vite/CRA)

Para Proyectos ReactTEXT

Add Zenovay Analytics to my React project.

My tracking code is: YOUR_TRACKING_CODE

In my main App.jsx or App.tsx file, add this useEffect:

import { useEffect } from 'react';

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);
}, []);

Add this inside the main App component, not inside a nested component.

Indicación de Proxy de Primera Parte (Avanzado)

Usa esto si deseas omitir bloqueadores de anuncios:

Configuración de Proxy de Primera ParteTEXT

I need to set up a first-party proxy for Zenovay Analytics to bypass ad blockers.

My tracking code is: YOUR_TRACKING_CODE

This requires two changes:

1. SET UP THE PROXY

For Next.js, add this to next.config.js:

module.exports = {
async rewrites() {
  return [
    {
      source: '/api/_z/:path*',
      destination: 'https://api.zenovay.com/fp/:path*',
    },
  ]
},
}

For Cloudflare Pages, create functions/api/_z/[[path]].ts with a proxy function.

2. UPDATE THE SCRIPT

Change the script src from:
src="https://api.zenovay.com/z.js"
To:
src="/api/_z/script.js"

And pass the tracking code as a query param:
src="/api/_z/script.js?id=YOUR_TRACKING_CODE"

This routes tracking through my own domain, making it first-party.

Indicación de Proxy para Cloudflare Pages

Proxy de Primera Parte para Cloudflare PagesTEXT

Create a Cloudflare Pages Function to proxy Zenovay Analytics requests.

Create this file: functions/api/_z/[[path]].ts

The function should:
1. Catch all requests to /api/_z/*
2. Forward them to https://api.zenovay.com/fp/*
3. Pass the client IP in X-Zenovay-Real-IP header
4. Handle CORS preflight requests
5. Forward POST bodies for tracking events

Here's the implementation:

export async function onRequest(context) {
const { request, params } = context
const path = (params.path || []).join('/')
const targetUrl = 'https://api.zenovay.com/fp/' + path + new URL(request.url).search

if (request.method === 'OPTIONS') {
  return new Response(null, {
    status: 204,
    headers: {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
      'Access-Control-Allow-Headers': 'Content-Type',
    },
  })
}

const headers = new Headers(request.headers)
headers.set('X-Zenovay-Real-IP', request.headers.get('CF-Connecting-IP') || '')
headers.delete('Host')

const init = { method: request.method, headers }
if (request.method === 'POST') {
  init.body = await request.arrayBuffer()
}

const response = await fetch(targetUrl, init)
const responseHeaders = new Headers(response.headers)
responseHeaders.set('Access-Control-Allow-Origin', '*')

return new Response(response.body, {
  status: response.status,
  headers: responseHeaders,
})
}

Then update my tracking script to use /api/_z/script.js?id=MY_TRACKING_CODE

Indicación para WordPress/Shopify

Para WordPress o ShopifyTEXT

Add Zenovay Analytics to my WordPress/Shopify site.

My tracking code is: YOUR_TRACKING_CODE

For WordPress:
- Install the "Insert Headers and Footers" plugin
- Go to Settings > Insert Headers and Footers
- Paste this in "Scripts in Header":

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

For Shopify:
- Go to Online Store > Themes > Edit code
- Open theme.liquid
- Add before </head>:

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

Save the file.

Indicación para Solución de Problemas

Si el Seguimiento No FuncionaTEXT

My Zenovay Analytics tracking isn't working. Help me debug it.

My tracking code is: YOUR_TRACKING_CODE

Check these things:

1. Is the script in the <head> section? It must be in <head>, not <body>.

2. Is the script loading? Open DevTools (F12) > Network tab > search for "z.js"
 - Should return status 200
 - If 404, the script path is wrong
 - If blocked, need first-party proxy

3. Check console for errors (F12 > Console)
 - Should see: "[Zenovay] Script executing..."
 - If no Zenovay logs, script isn't loading

4. Is tracking enabled? Look for:
 - "Zenovay Analytics loaded { enabled: true }"
 - If enabled: false, check if localhost or DNT is blocking

5. For debugging, add data-debug="true" to the script tag:
 <script defer data-tracking-code="YOUR_CODE" data-debug="true" src="..."></script>

This will show detailed logs in the console.

Indicación para Implementación en Vercel

Para Proyectos en VercelTEXT

Add Zenovay Analytics to my Vercel-deployed project with first-party proxy.

My tracking code is: YOUR_TRACKING_CODE

1. Add rewrites to next.config.js:

module.exports = {
async rewrites() {
  return [
    { source: '/api/_z/:path*', destination: 'https://api.zenovay.com/fp/:path*' },
  ]
},
}

2. In my layout file, add:

import Script from 'next/script'

<Script
src="/api/_z/script.js?id=YOUR_TRACKING_CODE"
strategy="afterInteractive"
/>

3. Deploy to Vercel - the rewrites will work automatically.

This bypasses ad blockers by routing through my Vercel domain.

Referencia Rápida

Framework	Dónde Agregar el Script
HTML	Antes de `</head>` en index.html
React	useEffect en App.jsx/tsx
Next.js	app/layout.tsx o pages/_app.tsx
Vue	public/index.html o App.vue
WordPress	Plugin Insert Headers and Footers
Shopify	theme.liquid antes de `</head>`
Webflow	Project Settings > Custom Code > Head
Squarespace	Settings > Advanced > Code Injection