Google Analytics — Integrationslücken (GA4 vs. Umami)
Stand: Oktober 2026 (0.1.636)
Ziel: Priorisierte Gap-Liste zwischen Umami (Cockpit-first, Dashboard-tief integriert) und Google Analytics 4 (Measurement ID im Center, Public Surface).
Ist-Umami (Referenz)
| Bereich | Umami |
|---|---|
| Center-Config | umamiWebsiteId, umamiUrl, analyticsProvider umami/both |
| Dashboard | /dashboard/analytics — KPIs, Charts, KI-Insights, Client-Reporting |
| APIs | website-stats, umami-events, umami-export, Content-Performance |
| Signage/Companion | Companion-Umami-Snapshot, URL-Matching pro Center |
| Public/v0 | public-visitor-surface → tracking.umamiWebsiteId; center-website Script |
| Export | Center-Datenexport ZIP (umami-analytics.json) |
| MCP/AgencyOS | Vollständige Tool-Parität (cockpit_analytics_website_stats, …) |
Ist-GA4 (kurz)
| Bereich | GA4 |
|---|---|
| Center-Config | googleAnalyticsId (Measurement ID), Provider google / both |
| Public/v0 | public-visitor-surface.tracking.googleAnalyticsId — ausgeliefert |
| Dashboard Website-Tab | Provider-Hinweis + Empty-State wenn nur GA4 (0.1.636); keine Live-KPIs/Charts aus GA4 Data API |
| Kanäle-Tab | Signage/Companion Live (0.1.635); kein separater GA4-Kanal |
| Content-Performance | Nur Umami-Pfade |
| Client-Reporting | Kein GA4-Block |
| MCP/AgencyOS | Schema-Hints für analyticsConfig.google.measurementId (0.1.636); kein GA4-Metriken-Tool |
Erledigt (Quick Wins)
| # | Lieferung | Version |
|---|---|---|
| Public Surface | tracking.googleAnalyticsId + analyticsProvider | vor 0.1.634 |
| Kanäle-Tab | Signage/Companion als Live mit Deep-Links | 0.1.635 |
| P0.2 Provider-UI | GA4-Badge, Hinweis-Banner, Link GA4-Konsole + Center-Config | 0.1.636 |
| MCP-Hints | analyticsConfig.provider, google.measurementId in website-config Schema | 0.1.636 |
Priorisierte Lücken (offen)
P0 — Dashboard-Daten
- GA4 Data API Anbindung —
website-statsliefert beianalyticsProvider=google|bothkeine Sessions/Pageviews aus GA4; Tab bleibt ohne Charts. - Provider
bothohne kombinierte Ansicht — Umami-Charts ODER GA-Hinweis, nicht beides in einer KPI-Zeile.
P1 — Reporting & Automatisierung
- Client-Reporting (
build-client-report) — nur Umami + Importe; GA4-Sessions/Pageviews fehlen in Monats-PDF/Share-Link. - Content-Performance / Hot-Pick-Attribution — ausschließlich Umami-Events; GA4-Conversion-Pfade nicht angebunden.
- MCP/AgencyOS Metriken-Tool —
cockpit_analytics_website_statsist Umami-only; dediziertes GA4-Read-Tool fehlt.
P2 — Signage & Multi-Channel
- Signage/Companion-Analytics — Cockpit-DB + Companion-Umami; GA4 für Companion-Webviews nicht ausgewertet.
- Dedizierter GA4-Kanal im Analytics-Kanäle-Tab (optional, niedrige Priorität — GA4-Konsole reicht interim).
P3 — Betrieb & Compliance
- GA4 Data API / Service Account — kein Env-Muster dokumentiert (
GOOGLE_ANALYTICS_CREDENTIALS, Property-ID vs. Measurement ID). - Cookie-Consent-Brücke — Umami +
cookieConsentin Surface; GA4 gtag-Laden in v0-Templates nicht zentral aus Cockpit gesteuert (Center-by-Center). - Matomo-Pfad — gleiche Lücken wie GA; Provider
bothohne kombinierte Dashboard-Ansicht.
Empfohlene Reihenfolge
- P0.1 — GA4 Data API für
website-statswennanalyticsProvidergoogle/both (Read-only, Service Account Env). - P1.3 — Client-Reporting optional GA4-Zeile neben Umami.
- P1.5 — MCP-Tool
cockpit_analytics_ga4_stats(Read-only, gleiche Parameter wie website-stats). - P3.8 — Env-Doku + Render-Secret-Setup für GA4 Service Account.
So testen
Bereits lieferbar
- Center → Analytics: Provider
google, Measurement ID setzen, speichern. GET …/public-visitor-surface—tracking.googleAnalyticsIdundanalyticsProvidervorhanden./dashboard/analytics?centerId=…— Banner „Google Analytics 4 · Measurement ID aktiv“, Link GA4-Konsole.
Nach GA4-Dashboard-Lieferung (P0.1)
- KPIs und Charts im Website-Tab aus GA4 Data API (nicht leer).
- Client-Reporting — GA4-Block in Summary sichtbar.
Verweise
- Analytics-Integration
- Analytics Dashboard (Nutzer)
- Center-Analytics:
GET/POST /api/centers/[centerId]/analytics·website-config→analyticsConfig - Umami-Loader:
apps/dashboard/src/lib/analytics/load-center-umami-website-analytics.ts
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/google-analytics-integration-gaps