Live Check - schnelle GA4-API-Diagnose
Der Live Check ist der schnellste Weg, um den Gesundheitszustand einer GA4-Property einzuschätzen. Er fragt die offiziellen Google-APIs ab, ohne dass ein BigQuery-Export nötig ist - und liefert in Sekunden ein Bild über Setup-Konfiguration und tagesaktuelle Datenqualität.
<!-- SCREENSHOT: Live-Check-Übersicht im Dashboard mit Ampel-Reihe -->
Was prüft die App?
Der Live Check kombiniert zwei Datenquellen:
- GA4 Admin API für die Konfigurations-Sicht: Streams, Enhanced Measurement, Key Events, Google-Ads-Verknüpfung, BigQuery-Linking, Custom Definitions, Privacy Signals.
- GA4 Data API für Plausibilitäts-Sicht: Realtime-Nutzer,
session_startundpage_view, Channel-Verteilung,(not set)-Anteile, E-Commerce-Plausibilität, Site-Search.
Die Checks landen in der Ampel-Reihe oben im Dashboard und nutzen den Standard-Status (Pass / Warning / Fail), wie er auch im Features & Testkatalog beschrieben ist.
Wann wird ein Check ausgelöst?
Konkrete Schwellenwerte aus dem Code:
| Check | Schwelle |
|---|---|
| Realtime-Nutzer | 0 aktive Nutzer = kritisch |
| Data Streams | mindestens 1 Web-Stream Pflicht |
| Enhanced Measurement | deaktiviert = Info |
| Key Events | optimal 3-10; ≥ 25 = Info („zu viele") |
| Data Retention | < 14 Monate = Warnung |
| BigQuery Export | reachable=false = kritisch |
Die Logik liegt in app/services/ga4_live_check_rules.py:build_live_check_findings()
und wird im Dashboard von app/services/ga4_api_check_service.py:get_overview()
aufgerufen.
<!-- SCREENSHOT: Einzelne Check-Karte mit Status-Hinweis und Lösungs-Accordion -->
Typische Ursachen
- 0 Realtime-Nutzer → Tracking-Code fehlt oder wird blockiert, Consent Mode falsch konfiguriert, Production-URL stimmt nicht mit dem GA4-Stream überein.
- Keine Web-Streams → Property ist unvollständig angelegt, es existieren nur App-Streams.
- BigQuery unerreichbar → GCP-Projekt-Zugriff fehlt, Dataset-Permissions sind nicht korrekt gesetzt, Region zwischen GA4 und BigQuery passt nicht zusammen.
So gehst du vor
- Im Dashboard die obere Ampel-Reihe durchsehen - jede Karte ist klickbar und öffnet Hint- und Lösungstexte direkt unter dem Status.
- Bei Realtime-
0-Befunden zuerst den Tracking-Debugger öffnen - der zeigt eingehende Events pro Stream und Sekunde. - Bei
(not set)-Auffälligkeiten parallel den BigQuery-Tab nutzen - die Ampel-Checks aus BigQuery zeigen die gleiche Frage mit deutlich mehr Detail. - Falls eine Konfigurationswarnung (z. B. fehlende Custom Dimensions) auftaucht: über die GA4-Admin-UI ändern und nach 24 h erneut prüfen - die Data-API spiegelt Änderungen mit Verzögerung.
Wann reicht der Live Check, wann braucht es BigQuery?
- Live Check reicht für Tages-Monitoring, Setup-Audits und das schnelle Erkennen von Tracking-Ausfällen.
- BigQuery (Ampel-Tab) ergänzt, sobald es um Event-Detail, Funnel-Konsistenz, Duplikate, PII-Hinweise oder Attribution-Tiefenanalyse geht - siehe Ampel-Checks aus BigQuery.