This guide covers all the ways you can install Zenovay tracking on your website.

Finding Your Tracking Code

First, get your unique tracking code:

Log in to your Zenovay dashboard
Open Domains and select the site you want to track
Open the website's settings and go to the General tab
Copy the script from the Tracking Script section

Your tracking code is a unique 12-character identifier (for example aB3xYz9kLm2P). It is embedded in the script snippet you copy, so you usually do not need to handle it on its own.

The Tracking Script card in a website's settings, showing HTML, React, Next.js, and First-Party install tabs with a copyable script snippet and an install-verification button. — The Tracking Script section is where you copy your snippet and pick the install method that matches your stack.

Installation Methods

The simplest way to add tracking is with a script tag. Add this code to your website's <head> section:

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

Replace YOUR_TRACKING_CODE with your actual tracking code from the dashboard.

For React or other SPA frameworks, add the same script tag to your index.html or root layout:

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

Then use the global zenovay function in your components:

// Track custom events after the script loads
function handleSignup() {
  zenovay('track', 'signup_click', { plan: 'pro' });
}

For Next.js, add the script in your _app.tsx or layout.tsx:

import Script from 'next/script'

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

If you build with a bundler, install the @zenovay/tracker npm package instead of adding a script tag. The wire-format is identical to the script-tag install.

npm install @zenovay/tracker

import { init, track } from '@zenovay/tracker';

init('YOUR_TRACKING_CODE');

// From any component or handler:
track('Signup clicked', { source: 'hero' });

Available now as @zenovay/tracker v0.1.0+. Both this method and the script-tag tabs above are fully supported, so pick whichever fits your stack.

Script Options

You can customize the tracking behavior with additional data attributes:

Attribute	Description	Default
`data-tracking-code`	Your unique tracking code (required)	-
`data-api-url`	Custom API endpoint URL	`https://api.zenovay.com`
`data-debug`	Enable debug mode in console	`false`
`data-ignore-dnt`	Switch off the Do Not Track check and track anyway. Has no effect on GPC	`false`
`data-allow-localhost`	Enable tracking on localhost	`false`
`data-heartbeat`	Send periodic heartbeat pings	`true`
`data-track-outbound`	Track outbound link clicks	`false`
`data-silent`	Suppress all console output	`false`

DNT (Do Not Track) and GPC (Global Privacy Control) are respected by default, and no attribute is needed to enable that.

GPC cannot be overridden. There is no attribute and no setting that makes the tracker record a visitor whose browser sends Global Privacy Control.

DNT can be. data-ignore-dnt="true" switches off the DNT check for that page. It is also applied automatically to every bundle served through the first-party proxy, so a script loaded from your own subdomain records DNT visitors even if you never set the attribute. Use the standard api.zenovay.com snippet if you want DNT honored.

Other privacy settings such as IP anonymization and cookieless mode are configured in Settings in the dashboard.

Example with Options

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

First-Party Tracking

Scale Plan

For ad-blocker resistant tracking, serve the script from your own domain. The custom-domain (CNAME) setup below requires a Scale or Enterprise plan:

Add CNAME Record
Add a CNAME DNS record pointing a subdomain (e.g., analytics.yourdomain.com) to proxy.zenovay.com.

Update Script URL

Change the script source to use your subdomain:

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

Wait for DNS Propagation
DNS changes can take up to 48 hours to propagate fully.

First-party tracking helps ensure your analytics work even when visitors use ad blockers or privacy extensions.

Verifying Installation

After adding the script:

Open your website in a new browser tab
Open browser DevTools (F12) and go to the Network tab
Filter by "zenovay" or "tracker"
You should see requests being made to the Zenovay API

Alternatively, open your website's dashboard and select the Live View tab to see your visit appear in real time.

Installing the Tracking Script

Finding Your Tracking Code

Installation Methods

Script Options

Example with Options

First-Party Tracking

Add CNAME Record

Update Script URL

Wait for DNS Propagation

Verifying Installation

Troubleshooting

Script Not Loading?

Next Steps

Related articles

Quick Start Guide

How do I install Zenovay on Webflow?

Can I install Zenovay via Google Tag Manager?

Was this article helpful?

Related articles

Quick Start Guide
Get Zenovay up and running on your website in under 5 minutes. This guide walks you through the essential setup steps. A detailed Zenovay getting started guide.

How do I install Zenovay on Webflow?
Step-by-step instructions for adding the Zenovay tracker to a Webflow site using the built-in custom code panel. No plugin required.

Can I install Zenovay via Google Tag Manager?
Yes. Here's how to load the Zenovay tracker through Google Tag Manager, including how to fire custom events from GTM triggers.