Zum Hauptinhalt springen
Kostenlos5 minutesEinsteiger

Mein erstes Event ist nicht erschienen — was ist los?

Eine 60-Sekunden-Checkliste zur Diagnose, warum Ihr erstes Zenovay-Event nicht erscheint: falscher Tracking-Code, Adblocker, CSP, localhost und mehr.

troubleshootinginstallfirst-eventdebugmissing-data
Zuletzt aktualisiert:

Wenn Sie den Zenovay-Tracker installiert haben und Ihr erster Besuch nach 30-60 Sekunden nicht im Live-View-Tab erscheint, arbeiten Sie diese Checkliste der Reihe nach ab.

1. Schauen Sie an der richtigen Stelle?

Öffnen Sie das Dashboard Ihrer Website und wählen Sie den Live-View-Tab (unter Audience in der Seitenleiste). Er aktualisiert sich in Echtzeit. Die Hauptdashboard-Charts haben eine 1-2-minütige Aggregationsverzögerung — ein brandneues Event wird dort noch nicht erscheinen. Verifizieren Sie die Installation immer zuerst im Live-View-Tab.

2. Wurde das Skript tatsächlich geladen?

Öffnen Sie Ihre Site in einem Inkognito-Fenster, drücken Sie F12, um die DevTools zu öffnen, gehen Sie zum Tab Network und filtern Sie nach zenovay.

Sie sollten zwei Anfragen sehen:

  • z.js — das Tracker-Skript selbst, Status 200
  • Eine Anfrage an api.zenovay.com/e/... (der Tracking-Endpunkt) — Status 200

Wenn z.js fehlt, wurde das Skript-Tag nie ausgeführt. Wenn es einen 404 zurückgibt, ist die URL falsch (sie sollte exakt https://api.zenovay.com/z.js sein).

3. Ist der Tracking-Code korrekt?

Öffnen Sie in Ihrem Dashboard die Registerkarte Einstellungen → Allgemein der Website und kopieren Sie den Wert aus dem Installationsschnipsel. Es ist ein 12-stelliger Code wie aB3xY9mK2pQz. Vergleichen Sie ihn Zeichen für Zeichen mit dem Attribut data-tracking-code Ihres <script>-Tags.

Ein häufiger Fehler ist, einen Platzhalter wie YOUR_TRACKING_CODE einzufügen und ihn zu vergessen zu ersetzen.

4. Frisst ein Adblocker die Anfrage?

uBlock Origin, AdGuard, Brave Shields und die meisten gängigen Privacy-Erweiterungen blockieren Zenovay standardmäßig nicht — aber eine benutzerdefinierte Blockliste könnte es. Testen Sie:

  • Erweiterungen für die Site deaktivieren, oder
  • Einen anderen Browser verwenden, oder
  • Die Site auf Ihrem Telefon über mobile Daten laden

Wenn das Event mit deaktiviertem Blocker erscheint, ist die Installation in Ordnung — Ihre Besucher haben einfach etwas niedrigere gemeldete Zahlen. Erwägen Sie First-Party-Tracking für Adblocker-Resistenz.

5. Testen Sie auf localhost?

Standardmäßig überspringt der Tracker Events auf localhost und 127.0.0.1. Um lokales Testen zu aktivieren, fügen Sie data-allow-localhost="true" zum Skript-Tag hinzu.

6. Blockiert Ihre CSP den Tracker?

Wenn Ihre Site einen Content-Security-Policy-Header verwendet, müssen beide Direktiven api.zenovay.com zulassen:

script-src ... https://api.zenovay.com;
connect-src ... https://api.zenovay.com;

Achten Sie auf CSP-Fehler in der Browser-Konsole — sie sind explizit darüber, welche Direktive die Anfrage blockiert hat.

7. Hat Ihr Besucher GPC oder DNT signalisiert?

Wenn Global Privacy Control oder Do Not Track in Ihrem Test-Browser aktiviert ist, respektiert der Tracker dies und sendet das Event nicht. Testen Sie in einem Browser ohne Privacy-Erweiterungen oder mit ausgeschaltetem GPC und DNT.

8. Wurde Ihr Tracking-Code rotiert?

Wenn Sie Ihren Tracking-Code im Dashboard neu generiert haben, akzeptiert der alte Code keine Events mehr. Aktualisieren Sie das Skript-Tag und deployen Sie neu.

Immer noch nichts?

  • Lesen Sie Installation überprüfen erneut.
  • Öffnen Sie die Statusseite, um zu bestätigen, dass die Ingest-API gesund ist.
  • Kontaktieren Sie [email protected] mit der URL der Seite, die Sie testen, dem Präfix Ihres Tracking-Codes und einem Screenshot des Network-Tabs.

Weiterführende Lektüre

War dieser Artikel hilfreich?