6分で読めます

AI Integration Prompts

Use these prompts with AI coding assistants (Cursor, Lovable, Replit, Windsurf, etc.) to install Zenovay tracking on your website.

Building with the Zenovay API? Check out API Prompts for AI Assistants -- 8 ready-to-use prompts for building dashboards, widgets, maps, email digests, and more using the External API.

Replace YOUR_TRACKING_CODE with your actual tracking code from the Zenovay Dashboard. It looks like ZV_ABC123XYZ.

Basic Installation Prompt

Copy this prompt and paste it into your AI assistant:

Copy this promptTEXT

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.

Next.js Specific Prompt

For Next.js ProjectsTEXT

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

React (Vite/CRA) Prompt

For React ProjectsTEXT

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.

First-Party Proxy Prompt (Advanced)

Use this if you want to bypass ad blockers:

First-Party Proxy SetupTEXT

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.

Cloudflare Pages Proxy Prompt

Cloudflare Pages First-Party ProxyTEXT

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

WordPress/Shopify Prompt

For WordPress or 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.

Troubleshooting Prompt

If Tracking Isn't WorkingTEXT

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.

Vercel Deployment Prompt

For Vercel ProjectsTEXT

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.

Quick Reference

Framework	Where to Add Script
HTML	Before `</head>` in index.html
React	useEffect in App.jsx/tsx
Next.js	app/layout.tsx or pages/_app.tsx
Vue	public/index.html or App.vue
WordPress	Insert Headers and Footers plugin
Shopify	theme.liquid before `</head>`
Webflow	Project Settings > Custom Code > Head
Squarespace	Settings > Advanced > Code Injection