3 min read

Installation

Get Zenovay Analytics up and running on your website in just a few minutes.

Quick Start

Add our tracking script to your website's <head> tag:

Add to your HTML headHTML

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

Replace YOUR_TRACKING_CODE with your tracking code from the Zenovay dashboard.

Install via npm

If you build with a bundler (Next.js, Nuxt, SvelteKit, Vite, webpack, esbuild, etc.), you can install Zenovay as an npm package and call init() from your code instead of adding a <script> tag to your HTML.

The package is published as @zenovay/tracker.

InstallBash

npm install @zenovay/tracker

Initialize and trackTypeScript

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

init('YOUR_TRACKING_CODE');

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

The init() call injects the same https://api.zenovay.com/z.js loader the <script> tag uses — wire-format behavior is identical. The npm package is a thin wrapper, not a fork of the tracker source, so you always get the latest production tracker without bumping a dependency.

Choosing between the two install methods

Method	Best for
`<script>` tag	Static HTML pages, WordPress, Shopify, plain HTML where no bundler runs
`@zenovay/tracker` npm	Modern bundler-based apps where you want type-safe `track`, `identify`, `goal` calls

The npm package is an additional installation option — not a replacement for the script tag.

Framework-Specific Setup

For modern frameworks like React, Vue, or Next.js, you add the same script tag within your app's HTML template or root layout. See the framework-specific guides for details:

Once the script is loaded, you can use the global window.zenovay object to track custom events:

Track custom events after script loadsJavaScript

// Track a custom event
zenovay('track', 'button_click', {
button_id: 'signup-cta',
page: '/pricing'
});

// Identify a user
zenovay('identify', 'user_123', {
email: '[email protected]',
plan: 'pro'
});

Server-Side Tracking

For server-side applications (Node.js, Express, etc.), use the Zenovay External API directly with fetch. No npm package is needed. See the Node.js Quickstart or Express.js Quickstart for details.

Verification

After installation, you can verify that Zenovay is working correctly:

Visit your website
Open browser developer tools
Check the Network tab for requests to zenovay.com
Visit your Zenovay dashboard to see real-time data

Your analytics should start appearing in your dashboard within 5 minutes!