3 Min. Lesedauer

Installation

Starten Sie Zenovay Analytics in nur wenigen Minuten auf Ihrer Website.

Quick Start

Fügen Sie unser Tracking-Skript zum <head>-Tag Ihrer Website hinzu:

Zum HTML-Head hinzufügenHTML

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

Ersetzen Sie YOUR_TRACKING_CODE mit dem Tracking-Code aus Domains → Ihre Website → General (die Tracking-Script-Karte). Um Ihre erste Website hinzuzufügen, gehen Sie zu Domains → Domain hinzufügen.

Tracking-Script-Karte mit HTML-, React-, Next.js- und First-Party-Tabs und einer Schaltfläche zur Verifizierung der Installation — Finden Sie Ihren Tracking-Code unter Domains → Ihre Website → General.

Installation via npm

Wenn Sie mit einem Bundler arbeiten (Next.js, Nuxt, SvelteKit, Vite, webpack, esbuild, etc.), können Sie Zenovay als npm-Paket installieren und init() aus Ihrem Code aufrufen, anstatt einen <script>-Tag zu Ihrem HTML hinzuzufügen.

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

InstallierenBash

npm install @zenovay/tracker

Initialisieren und trackenTypeScript

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. Sie erhalten also immer den neuesten Produktions-Tracker, ohne eine Abhängigkeit zu aktualisieren.

Wahl zwischen den beiden Installationsmethoden

Methode	Geeignet für
`<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-Spezifisches Setup

Für moderne Frameworks wie React, Vue oder Next.js fügen Sie denselben Script-Tag innerhalb des HTML-Templates oder Layouts Ihrer App hinzu. Weitere Details finden Sie in den Framework-spezifischen Leitfäden:

Nach dem Laden des Skripts können Sie das globale Objekt window.zenovay verwenden, um benutzerdefinierte Events zu verfolgen:

Benutzerdefinierte Events nach dem Laden des Skripts verfolgenJavaScript

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

Serverseitiges Tracking

Verwenden Sie für serverseitige Anwendungen (Node.js, Express, etc.) die Zenovay External API direkt mit fetch. Es ist kein npm-Paket erforderlich. Weitere Details finden Sie im Node.js Quickstart oder Express.js Quickstart.

Formular zum Hinzufügen einer Domain mit Feldern für Website-Namen und Region — Fügen Sie Ihre erste Website über Domains → Domain hinzufügen hinzu, bevor Sie das Tracking-Skript installieren.

Verifizierung

Nach der Installation können Sie überprüfen, ob Zenovay korrekt funktioniert:

Besuchen Sie Ihre Website
Öffnen Sie die Browser-Entwicklertools
Prüfen Sie den Network-Tab auf Anfragen an zenovay.com
Öffnen Sie Domains → Ihre Website → Analytics, um Echtzeitdaten zu sehen

Ihre Analysen sollten innerhalb von 5 Minuten in Ihrem Dashboard angezeigt werden!