Zum Hauptinhalt springen

Website-Analytics & KI-Insights

Ein Menüpunkt in der Sidebar: Analytics & Insights → Website & Insights
Pfad: /dashboard/analytics

Der frühere zweite Link „Website-Analytics“ (/dashboard/analytics/dashboard) leitet automatisch hierher um.

Center wählen​

Oben: Center-Filter (wie in anderen Cockpit-Listen) – alle KPIs und Insights beziehen sich auf dieses Center.

Tracking aktivieren (Redaktion)​

Unter Center → Webseiten-Tab → Analytics (oder Center → Analytics):

  1. Schalter Analytics aktiviert einschalten.
  2. Speichern — cockpitOS richtet Umami standardmäßig ein (Website-ID wird automatisch angelegt oder verknüpft).
  3. Erfolg oder Hinweis „IT prüfen“ erscheint als Meldung im Dashboard; die übrigen Einstellungen werden in jedem Fall gespeichert.

Details: Onboarding Tutorial.

Zeitraum​

In der Kopfzeile: Presets 24h, 7 Tage, Letzte 30 Tage, 90 Tage, 12 Monate oder Benutzerdefiniert mit Von/Bis (Kalenderdatum, UTC-Tagesgrenzen wie in der API). Gilt für Website-Tab, CSV-Export und KI-Insights.

Wichtig: Letzte 30 Tage ist ein rollierendes Fenster ab heute — kein Kalendermonat (z. B. nicht automatisch 1.–31. Oktober). Für einen exakten Kalendermonat Benutzerdefiniert (Von/Bis) nutzen oder Kunden-Reporting mit Monatsauswahl — siehe Kunden-Reporting.

Historische Umami-Daten sind auf die Retention begrenzt (standardmäßig 365 Tage, konfigurierbar über PRIVACY_RETENTION_DAYS auf dem Server). Längere oder ungültige Bereiche zeigt das Cockpit mit Hinweis — es werden keine still abgeschnittenen Charts geladen.

Umami Tracker-Tag (Kanäle / Subdomains)​

Unter dem Center-Filter: Umami Tracker-Tag mit Tag ist oder Tag ist nicht.

Damit filterst du KPIs nach dem Umami-Attribut data-tag am Tracking-Script — z. B. Events-Subdomain (events) unter derselben Umami-Website-ID wie die Hauptseite, ohne zweite Instanz.

  • Vorschläge: bekannte Tags aus Umami im gewählten Zeitraum (Autocomplete)
  • Teilen/Bookmark: URL-Parameter umamiTag=events und optional umamiTagMode=exclude
  • CSV-Export übernimmt den aktiven Tag-Filter

v0 / externe Frontends: V0AnalyticsSnippet mit Prop umamiTag="events" (setzt data-tag am Script). Siehe Developer-Doku Analytics-Integration.

Reiter​

ReiterInhalt
WebsiteKPIs, Besuchertrend, Top-Seiten, Referrer, Geräte (Umami)
KI-InsightsEmpfehlungen + Formulierung fürs Centermanagement-Gespräch (clientMessage, kopierbar)

Gespräch mit dem Centermanagement (Website-Tab)​

Oben im Tab Website erscheint die Box „Gespräch mit dem Centermanagement“: 2 KI-Kernpunkte in Sprache fürs Centermanagement (Fokus stakeholder). Button „Alle KI-Insights“ öffnet den vollständigen Tab inkl. Schnellfilter „Für Centermanagement zusammenfassen“.

KI-Insights – Voraussetzungen​

  1. Center: Analytics aktiv, Umami-Website-ID (Reiter Analytics)
  2. Server: UMAMI_PASSWORD und OPENAI_API_KEY
  3. Ausreichend Traffic/Events im gewählten Zeitraum

API: GET /api/analytics/insights?centerId=…&timeframe=day|week|month|90d|365d oder startDate=YYYY-MM-DD&endDate=YYYY-MM-DD (gleiche Parameter wie /api/analytics/website-stats).

Ohne Konfiguration: „Nicht verfügbar“ bzw. Hinweis mit CTA Umami einrichten – keine Demo-Charts, kein Chatbot, kein Export-Button.

Qualitäts-Checkliste (Website-Tab)​

PrioritätThemaStatus
P0Seiten/Geräte nur echte Umami-Daten oder „Nicht verfügbar“ + Setup-CTA✅
P0Vergleichs-% ohne Division-by-zero (formatPercentChange)✅
P1Umami Metrics: URL, Referrer, Device (getUmamiMetrics)✅
P2Keine Center-Liste mehr; ein Trend-Chart; Vergleichstext an Zeitraum✅
P3/api/analytics: centerId Pflicht, day = 24h, Trends nicht random✅
P4CSV-Export; KI-Schnellfragen statt Demo-Chatbot✅

Zusätzlich umgesetzt​

  • Cockpit-Zusatzkennzahlen: Spitzenzeit, stärkster Tag, Wiederkehrend-%, Feedback (aus /api/analytics)
  • Auto-Refresh: optional alle 60s (nur sichtbarer Tab)
  • Tab Kanäle: Website / Signage / Companion ohne Fake-Zahlen
  • Footfall-Simulator: Wenn aktiv, erscheint oben ein Hinweis mit Link zu Besucherströme

Weitere Analytics-Menüpunkte​

  • Kunden-Reporting – kanalübergreifende Monatsübersicht für das Centermanagement (Website, Social, KI-Assistent, Signage) inkl. PDF; Details: client-reporting
  • SEO & AI-Sichtbarkeit – GEO/SEO-Übersicht
  • Besucherströme – Footfall (Live oder Simulator; Toggle „Daten-Simulator“ auf der Seite)
  • Bewertungen – Feedback-Analytics

Besucherströme (Footfall)​

Pfad: /dashboard/analytics/footfall

  • Badge Live, Simulator oder Keine Daten an den KPI-Karten
  • Daten-Simulator (rechts): globaler Schalter — nur Super Admin kann speichern
  • Live-Partner-API hat Vorrang, wenn FOOTFALL_API_BASE_URL + Key konfiguriert sind

Reiter auf der Seite:

ReiterInhalt
ÜbersichtTagesverlauf (Stunden-Chart) und Wochenverlauf (7 Tage)
CenterFootfall je Center im Portfolio bzw. gewähltes Center
TrendsWochen- und Monatsverlauf (12 Monate)
HeatmapZonen-Auslastung (Bereiche) und Frequenz nach Wochentag × Stunde

Mit aktivem Simulator oder Live-Partner mit Zonen-/Trend-Daten werden Charts und Heatmaps befüllt; ohne Daten zeigen die Reiter einen leeren Zustand mit Hinweis.

Entwickler​

  • Website-Daten: /api/analytics/website-stats
  • KI: apps/dashboard/src/lib/analytics-insights.ts
  • UI: website-analytics-view.tsx, analytics-insights-panel.tsx

Siehe Analytics-Integration (Developer).

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /dashboard/analytics-dashboard