Zum Hauptinhalt springen
Kostenlos5 minutesEinsteiger

Wie installiere ich das Tracking-Skript auf meiner Website?

Eine 5-Schritte-Checkliste, um Zenovay zu jeder Website hinzuzufügen — Tracking-Code abrufen, Skript-Tag einfügen, deployen, verifizieren und Events bestätigen.

installquickstartscriptchecklistfirst-time
Zuletzt aktualisiert:

Der Zenovay-Tracker ist ein einzelnes <script>-Tag. Es zu jeder Website hinzuzufügen ist ein 5-Schritte-Prozess.

Die 5 Schritte

  1. Tracking-Code abrufen

    Melden Sie sich bei app.zenovay.com an. Wenn Sie die Website noch nicht hinzugefügt haben, klicken Sie auf Website hinzufügen — der Assistent zeigt am Ende Ihren Snippet (mit dem bereits ausgefüllten Tracking-Code).

    Für eine bereits hinzugefügte Website öffnen Sie diese aus Domains, gehen zu Einstellungen und wählen die Registerkarte Allgemein. Der kopierfertige Snippet befindet sich unter dem Abschnitt Tracking-Skript. Der Tracking-Code ist ein 12-stelliger String wie aB3xK9mP2qR7.

  2. Skript-Tag in den HTML-Head Ihrer Site einfügen

    Die Standard-Installation ist ein einzelnes Tag im <head>-Bereich jeder Seite:

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

    Ersetzen Sie YOUR_TRACKING_CODE durch den Wert aus Schritt 1.

  3. Änderung deployen

    Der genaue Deploy-Schritt hängt von Ihrer Plattform ab — pushen Sie den Commit, drücken Sie Speichern in Ihrem CMS oder veröffentlichen Sie Ihre No-Code-Site neu. Warten Sie, bis die Änderung auf Ihrer echten Domain live ist (nicht nur auf Staging).

  4. Site besuchen und Live-Tab beobachten

    Öffnen Sie Ihre Site in einem Inkognito-Fenster. Innerhalb von 30 Sekunden sollte Ihr Besuch im Live-View-Tab Ihres Website-Dashboards mit der korrekten Position erscheinen.

  5. Wenn nichts angezeigt wird — diagnostizieren

    Wenn Ihr Besuch nach 60 Sekunden nicht erschienen ist, prüfen Sie die Installation mit Erstes Event erscheint nicht. Die häufigsten Ursachen sind: Tracking-Code-Konflikt, Adblocker im Test-Browser oder Tests auf localhost.

Plattformspezifische Anleitungen

Wählen Sie die Seite, die zu Ihrem Stack passt:

PlattformAnleitung
WebflowAuf Webflow installieren
WordPressWordPress-Integration
ShopifyShopify-Integration
Next.jsNext.js-Integration
React (Create React App, Vite usw.)React-Integration
VueVue-Integration
Google Tag ManagerÜber GTM installieren
Alles andereCustom Framework

Wo das Skript-Tag hingehört

Das Skript-Tag gehört in das <head> jeder Seite, die Sie tracken möchten. Der genaue Ort variiert je nach Plattform:

  • Hand-codiertes HTML — direkt in <head>, kurz vor </head>
  • WordPressheader.php des Themes oder über wp_head-Action
  • Shopifytheme.liquid, kurz vor </head>
  • Next.js<Script> in Ihrem Root-Layout, mit strategy="afterInteractive"
  • Webflow — Site-Einstellungen → Custom Code → Head-Code
  • GTM — Custom-HTML-Tag mit All Pages-Trigger

Was das defer-Attribut macht

defer sagt dem Browser: „Lade dieses Skript, während die Seite geparst wird, aber führe es erst aus, nachdem die Seite geparst wurde." Das bedeutet, der Tracker verlangsamt das Rendering Ihrer Seite überhaupt nicht — Lighthouse-Werte bleiben sauber.

Was NICHT erforderlich ist

Sie müssen nicht:

  • Ein npm-Paket installieren (es sei denn, Sie verwenden einen Bundler — siehe npm-Installation)
  • Nur für Zenovay einen Cookie-Banner hinzufügen (Cookieless-Modus ist Standard — siehe brauche ich einen Cookie-Banner)
  • Einen Datenschutz-Eintrag konfigurieren (empfohlen, aber der Tracker funktioniert auch ohne)
  • Etwas in Ihrer CSP whitelisten, es sei denn, Sie haben eine strenge CSP — in diesem Fall erlauben Sie https://api.zenovay.com in script-src und connect-src

Weiterführende Lektüre

War dieser Artikel hilfreich?