6 min de lecture

Invites d'intégration IA

Utilisez ces invites avec des assistants de codage IA (Cursor, Lovable, Replit, Windsurf, etc.) pour installer le suivi Zenovay sur votre site web.

Construisez avec l'API Zenovay ? Consultez Invites API pour les assistants IA — 8 invites prêtes à l'emploi pour créer des tableaux de bord, des widgets, des cartes, des digests par e-mail, et bien plus en utilisant l'API externe.

Remplacez YOUR_TRACKING_CODE par votre code de suivi réel du Tableau de bord Zenovay. Il ressemble à ZV_ABC123XYZ.

Invite d'installation de base

Copiez cette invite et collez-la dans votre assistant IA :

Copiez cette inviteTEXT

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.

Invite spécifique à Next.js

Pour les projets 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'.

Invite React (Vite/CRA)

Pour les projets 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.

Invite Proxy première partie (Avancé)

Utilisez ceci si vous souhaitez contourner les bloqueurs de publicités :

Configuration du proxy première partieTEXT

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.

Invite Proxy Cloudflare Pages

Proxy première partie 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

Invite WordPress/Shopify

Pour WordPress ou 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.

Invite dépannage

Si le suivi ne fonctionne pasTEXT

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.

Invite déploiement Vercel

Pour les projets 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.

Référence rapide

Framework	Où ajouter le script
HTML	Avant `</head>` dans index.html
React	useEffect dans App.jsx/tsx
Next.js	app/layout.tsx ou pages/_app.tsx
Vue	public/index.html ou App.vue
WordPress	Plugin Insert Headers and Footers
Shopify	theme.liquid avant `</head>`
Webflow	Project Settings > Custom Code > Head
Squarespace	Settings > Advanced > Code Injection