Zum Hauptinhalt springen
Zenovaydocs
5 Min. Lesedauer

Tracking-Script Installation

Fügen Sie Zenovay Analytics zu Ihrer Website mit einer einzigen Code-Zeile hinzu. Keine Konfiguration erforderlich.

Schnelle Installation (30 Sekunden)

Kopieren Sie dieses Script und fügen Sie es in den <head>-Bereich Ihrer Website ein:

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

Ersetzen Sie YOUR_TRACKING_CODE durch Ihren Tracking-Code aus dem Zenovay Dashboard. Er sieht wie ZV_ABC123XYZ aus.

Die Tracking-Script-Karte in den Domain-Einstellungen mit dem Script-Snippet für HTML, React, Next.js und First-Party-Tabs sowie einer Schaltfläche zur Überprüfung der Installation
Finden Sie Ihren Tracking-Code unter Domains → Ihre Site → Allgemeine Einstellungen.

Das war's schon! Das Script verfolgt automatisch:

  • Seitenaufrufe
  • Besuchersitzungen
  • Geografischer Standort
  • Geräte- und Browserinformationen
  • Referenzquellen
  • UTM-Parameter

Framework-spezifische Installation

HTML / Statische Websites

Fügen Sie direkt vor dem schließenden </head>-Tag hinzu:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<title>My Website</title>
<!-- Zenovay Analytics v2.0.6 -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<!-- Your content -->
</body>
</html>

React

Fügen Sie das Script in der useEffect Ihres Root-Components hinzu:

App.jsx oder index.jsJSX
import { useEffect } from 'react';

function App() {
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://api.zenovay.com/z.js';
  script.defer = true;
  script.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
  document.head.appendChild(script);
}, []);

return <div>Your App</div>;
}

export default App;

Next.js (App Router)

Fügen Sie zu Ihrer Root-Layout-Datei hinzu:

app/layout.tsxTSX
import Script from 'next/script';

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

Next.js (Pages Router)

Fügen Sie zu Ihrer _document.tsx hinzu:

pages/_document.tsxTSX
import { Html, Head, Main, NextScript } from 'next/document';
import Script from 'next/script';

export default function Document() {
return (
  <Html>
    <Head>
      <Script
        src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        strategy="afterInteractive"
      />
    </Head>
    <body>
      <Main />
      <NextScript />
    </body>
  </Html>
);
}

Vue.js

Fügen Sie zu Ihrer index.html hinzu oder verwenden Sie in App.vue:

index.htmlHTML
<!DOCTYPE html>
<html>
<head>
<!-- Zenovay Analytics -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
</head>
<body>
<div id="app"></div>
</body>
</html>

WordPress

Option 1: Mit einem Plugin (Empfohlen)

  1. Installieren Sie das Plugin Insert Headers and Footers
  2. Gehen Sie zu Settings → Insert Headers and Footers
  3. Fügen Sie dies unter „Scripts in Header" ein:
WordPress Header ScriptHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Option 2: Design bearbeiten

Fügen Sie zu header.php vor </head> hinzu:

wp-content/themes/your-theme/header.phpPHP
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Shopify

  1. Gehen Sie zu Online Store → Themes
  2. Klicken Sie auf Actions → Edit code
  3. Öffnen Sie theme.liquid
  4. Fügen Sie vor </head> hinzu:
theme.liquidHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>
</head>

Webflow

  1. Gehen Sie zu Project Settings → Custom Code
  2. Fügen Sie den Code im Bereich Head Code ein:
Webflow Head CodeHTML
<!-- Zenovay Analytics -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script>

Squarespace

  1. Gehen Sie zu Settings → Advanced → Code Injection
  2. Fügen Sie den Code im Bereich Header ein

Installation überprüfen

1. Browser-Konsole überprüfen

Öffnen Sie die Entwicklertools Ihres Browsers (F12) und suchen Sie nach:

[Zenovay] Script executing... (v2.0.6)
Zenovay Analytics loaded { trackingCode: 'YOUR_TRACKING_CODE', enabled: true }

2. Debug-Modus aktivieren

Um detaillierte Protokolle zu sehen, aktivieren Sie den Debug-Modus in den Einstellungen Ihrer Domain (Domains → Website auswählen → Allgemein) oder fügen Sie das Debug-Attribut hinzu:

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

Für eine visuelle In-Page-Ansicht aller Ereignisse, die Ihr Tracker sendet — Typ, Properties, Cookieless-Modus, GPC-Status, Einwilligungsstatus — aktivieren Sie das Debug Overlay in Ihren Domain-Einstellungen und laden Sie eine beliebige Seite mit ?zenovay_debug=1 angehängt an die URL. Personenbezogene Daten werden maskiert.

3. Echtzeit-Dashboard überprüfen

Besuchen Sie Ihr Zenovay Dashboard und überprüfen Sie die Echtzeit-Ansicht, um Ihren Besuch live zu sehen.

Script-Attribute

Passen Sie das Verhalten mit Datenattributen an:

AttributTypStandardBeschreibung
data-tracking-codestringerforderlichIhr Tracking-Code (z. B. ZV_ABC123)
data-debugbooleanfalseKonsolenprotokolle anzeigen
data-allow-localhostbooleanfalseLocalhost-Besuche nachverfolgen

Ad-Blocker-Schutz

Einige Ad-Blocker können api.zenovay.com blockieren. Verwenden Sie unseren First-Party Proxy für 100 % Tracking-Genauigkeit:

Wenn Sie blockierte Anfragen in Firefox oder Edge sehen, richten Sie einen First-Party Proxy ein, um Tracking über Ihre eigene Domain weiterzuleiten.

First-Party Proxy ScriptHTML
<!-- First-Party Proxy (bypasses ad blockers) -->
<!-- Requires proxy setup - see: docs.zenovay.com/guides/first-party-tracking -->
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>

Content Security Policy (CSP)

Wenn Ihre Website CSP-Header verwendet, fügen Sie Zenovay hinzu:

CSP-HeaderTEXT
Content-Security-Policy:
script-src 'self' https://api.zenovay.com;
connect-src 'self' https://api.zenovay.com;

Fehlerbehebung

Script wird nicht geladen

  1. Überprüfen Sie auf Tippfehler in Ihrem Tracking-Code
  2. Stellen Sie sicher, dass sich das Script in <head> befindet, nicht in <body>
  3. Überprüfen Sie CSP-Header - fügen Sie api.zenovay.com zu den zulässigen Quellen hinzu
  4. Deaktivieren Sie Ad-Blocker vorübergehend zum Testen

Keine Ereignisse im Dashboard

  1. Warten Sie 30 Sekunden - Ereignisse werden gestapelt
  2. Überprüfen Sie die Browser-Konsole auf Fehler
  3. Aktivieren Sie den Debug-Modus, um Ereignisprotokolle zu sehen
  4. Versuchen Sie ein Inkognito-/Privatfenster, um Erweiterungen auszuschließen

Ad-Blocker blockiert Script

Richten Sie einen First-Party Proxy ein, um Tracking über Ihre Domain weiterzuleiten.

Mit KI installieren

Wenn Sie KI-Coding-Assistenten verwenden (Cursor, Lovable, Replit), lesen Sie unsere AI Integration Prompts für Copy-Paste-Prompts.

Nächste Schritte

War diese Seite hilfreich?