3 min de lecture

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.

Installation via npm

Si tu app utilise un bundler (Next.js, Nuxt, SvelteKit, Vite, webpack, esbuild, etc.), tu peux installer Zenovay en tant que paquet npm et appeler init() depuis ton code, plutôt que d'ajouter une balise <script> dans ton HTML.

Le paquet est publié sous le nom @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' });

L'appel à init() injecte le même loader https://api.zenovay.com/z.js que la balise <script> — le comportement wire-format est identique. Le paquet npm est un wrapper léger, pas un fork du tracker, donc tu reçois toujours le dernier tracker de production sans devoir mettre à jour une dépendance.

Choisir entre les deux méthodes

Méthode	Idéal pour
Balise `<script>`	Pages HTML statiques, WordPress, Shopify, HTML simple sans bundler
`@zenovay/tracker` npm	Applications modernes avec bundler où tu veux des appels `track`, `identify`, `goal` typés

Le paquet npm est une option d'installation supplémentaire — pas un remplacement de la balise <script>.

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!