3 Min. Lesedauer

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 per npm

Wenn du mit einem Bundler arbeitest (Next.js, Nuxt, SvelteKit, Vite, webpack, esbuild, …), kannst du Zenovay als npm-Paket installieren und init() aus deinem Code aufrufen, anstatt einen <script>-Tag in dein HTML einzufügen.

Das Paket wird als @zenovay/tracker veröffentlicht.

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' });

Der init()-Aufruf bindet denselben https://api.zenovay.com/z.js-Loader ein, den auch der <script>-Tag nutzt — das Wire-Format-Verhalten ist identisch. Das npm-Paket ist ein dünner Wrapper, kein Fork der Tracker-Quelle. Du bekommst also immer den aktuellsten Produktions-Tracker, ohne eine Abhängigkeit zu aktualisieren.

Welche Methode wann

Methode	Wofür geeignet
`<script>`-Tag	Statische HTML-Seiten, WordPress, Shopify, einfaches HTML ohne Bundler
`@zenovay/tracker` npm	Moderne Bundler-basierte Apps mit typsicheren `track`-, `identify`-, `goal`-Aufrufen

Das npm-Paket ist eine zusätzliche Installationsoption — kein Ersatz für den 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!