Installations-Status

Überprüfen Sie, ob Ihr Zenovay-Tracker funktioniert, ohne den Echtzeit-Globus beobachten zu müssen. Der Endpoint Install Health liefert eine strukturierte Momentaufnahme der jüngsten Tracker-Aktivität, der Erreichbarkeit Ihrer Website, der aktuellen Cookieless- und Einwilligungs-Konfiguration sowie eine umsetzbare Liste etwaiger Probleme.

Wo Sie ihn finden

Im Zenovay-Dashboard:

1. Öffnen Sie die Seite Domains und klicken Sie auf Ihre Domain.
2. Öffnen Sie Einstellungen und klicken Sie auf den Tab Install Health.
3. Der Bericht aktualisiert sich automatisch alle 30 Sekunden. Mit Aktualisieren erzwingen Sie eine Neuprüfung.

Antwort lesen

Jeder Aufruf liefert ein JSON-Objekt mit den folgenden Feldern:

Status-Farben im Dashboard

Die vier Kacheln am oberen Rand des Tabs verwenden folgende Schwellenwerte:

• Grün — Ereignisse innerhalb der letzten 5 Minuten empfangen.
• Gelb — Ereignisse innerhalb der letzten Stunde, aber nicht in den letzten 5 Minuten.
• Rot — Mehr als eine Stunde stumm oder noch nie ein Ereignis empfangen.

Häufige Probleme und Lösungen

Das Array issues enthält Diagnose-Codes, die Zenovay zurückgeben kann. Jeder Eintrag hat eine severity, einen stabilen code, eine menschenlesbare message und eine fix_url.

E-Mail-Benachrichtigungen (pro Domain optional)

Wenn die Diagnose einen silent_tracker-Fehler für Ihre Domain auslöst, sendet Zenovay eine einmalige E-Mail an den Eigentümer der Website. Sobald die Ereignisse wieder fließen, erhalten Sie eine einmalige Entwarnung. Maximal eine E-Mail pro Ausfall — fünf Sicherungs-Schichten verhindern Spam:

1. Der Cron läuft alle 6 Stunden, nicht jede Minute.
2. Die silent_tracker-Schwelle selbst erfordert eine Lücke von mindestens 6 Stunden.
3. Sites mit weniger als 5 Ereignissen in den letzten 24 Stunden lösen niemals eine Benachrichtigung aus (ein persönlicher Blog mit einem Besuch pro Tag wird Sie nie per E-Mail benachrichtigen).
4. Eine interne Zustandsmaschine feuert nur bei Übergang (gesund → still oder still → gesund), niemals bei aufeinanderfolgenden Cron-Läufen.
5. Der E-Mail-Log-Idempotenz-Schlüssel ist am Zeitstempel des ersten Schweigens des Ausfalls verankert — selbst ein Fehler in der Zustandsmaschine kann nicht zwei stille E-Mails pro Ausfall senden.

Sandbox-/Entwicklungs-Domains (localhost, *.vercel.app, *.netlify.app, *.pages.dev, *.workers.dev, *.test, *.local) sind vollständig von Benachrichtigungen ausgeschlossen.

Schalten Sie Benachrichtigungen pro Domain unter Domain → Einstellungen → Install Health → E-Mail-Benachrichtigungen ein oder aus. Standardmäßig aktiviert.

API-Referenz

Beispiel-Anfrage

# Beachten Sie: Die URL enthält KEINEN führenden Doppelpunkt — ersetzen
# Sie ZV_IHR_TRACKING_CODE durch Ihren echten Code aus app.zenovay.com →
# Domain → Einstellungen. Das Bearer-JWT ist verpflichtend; kopieren Sie es
# aus einer angemeldeten Dashboard-Sitzung über DevTools → Netzwerk →
# /api/auth/user.
curl https://api.zenovay.com/api/install-health/ZV_IHR_TRACKING_CODE \
-H "Authorization: Bearer $IHR_JWT"

Beispiel-Antwort

{
"last_event_seen_at": "2026-05-02T21:15:42.110Z",
"minutes_since_last_event": 0,
"last_event_count_5m": 12,
"last_event_count_24h": 1843,
"script_reachable": true,
"script_version": "v2.0.1",
"csp_blocking_suspected": false,
"cookieless_enabled": true,
"consent_recording_active": false,
"last_5_event_types": ["pageview", "click", "scroll", "form_submit", "outbound_click"],
"issues": []
}