Skip to main content

Kunden-Reporting

Menü: Analytics & Insights → Kunden-Reporting
Pfad: /dashboard/analytics/client-report

Monatsübersicht für Centermanagement-Gespräche — live aus dem Cockpit plus importierte Historie aus dem alten Reporting-Dashboard. Nach einmaligem Import ist kein monatlicher manueller Upload mehr nötig.

Für wen?​

Marketing, Center-Leitung und Agentur: ein Blick auf die wichtigsten Kennzahlen pro Kanal, plus PDF für Kundentermine.

Center & Zeitraum​

  1. Oben den Center-Filter setzen (wie bei anderen Analytics-Seiten).
  2. Zeitraum wählen: letzte 7 Tage, letzte 30 Tage, Jahresreport, Quartalsreport (Q1–Q4) oder einen Kalendermonat (z. B. „Mai 2026“). Quartale und Jahre sind für alle Center verfügbar.
  3. Aktualisieren lädt die Daten neu.

Bei Kalendermonat nutzt der Website-Kanal exakt den gewählten Monat (1.–letzter Tag) in Umami — nicht die rollierenden letzten 30 Tage.

Abgrenzung zum Website-Dashboard: Unter Analytics & Insights → Website & Insights bedeutet Letzte 30 Tage immer rollierend ab heute. Für denselben Kalendermonat wie im Kunden-Reporting dort Benutzerdefiniert (Von/Bis) wählen oder direkt hier den Kalendermonat aus dem Dropdown.

Kanäle & Datenquellen​

KanalQuelleBadge
WebsiteUmami (live) oder GA-Historie (Import)Live / Historie
Social MediaOutstand (live) oder FB/IG-Historie (Import)Live / Historie
KI-AssistentCockpit-Interaktionen (live) oder ImportLive / Historie
Digital SignageSignage-Analytics (live) oder Stele-Historie (Import)Live / Historie
Meta AdsZernio (live) oder Reporting-Dashboard-ImportLive / Historie
Google AdsZernio (live) oder Reporting-Dashboard-ImportLive / Historie
Google-BewertungenGoogle Business Profile (live) oder Google PlacesLive
LOOP TreueprogrammCockpit (LOOP), nur wenn das Programm des Centers aktiv istLive
SuchbegriffeReporting-Dashboard-ImportHistorie
ZusammenfassungCockpit (Redaktion, pro Monat) oder Reporting-ImportLive / Historie
AnsprechpartnerCockpit KAM (Center/Organisation) plus Teamverwaltung (TeamMember) oder Reporting-ImportLive / Historie

Live hat Vorrang für laufende Zeiträume (letzte 7/30 Tage, aktueller Kalendermonat): Wenn Umami oder Outstand Daten liefern, werden diese angezeigt.

Vergangene Kalendermonate: Für Website, Social, KI-Assistent und Digital Signage wird — falls importiert — die Reporting-Dashboard-Historie bevorzugt (Badge „Historie“). So stimmen die Zahlen mit dem alten Monatsbericht überein, auch wenn Umami/Outstand im Cockpit aktiv sind.

Bei „Letzte 30 Tage“ oder „Letzte 7 Tage“ passen monatliche Import-Snapshots in der Regel nicht zum Zeitraum — dann siehst du Live-Daten aus dem Cockpit. Für importierte Historie einen Kalendermonat wählen (Dropdown: bis zu 18 Monate zurück).

Kanäle ohne Einrichtung und ohne Daten im gewählten Zeitraum erscheinen nicht in der Übersicht. Wenn gar keine Kanal-Daten vorliegen, siehst du einen Hinweis statt leerer Kacheln.

Die Karten nutzen Marken-Logos (Facebook, Instagram, Google, Meta) und für Website das Center-Logo — intern und in der Kunden-Ansicht gleich aufgebaut. Kanäle sind in drei Bereiche gruppiert: Website & Marketing, Social Media, Zusammenfassung & Kontakt. Im Cockpit zeigt die Berichtsvorschau dieselbe Struktur wie der öffentliche Link.

Import-Historie (Kalendermonat wählen) wird ähnlich wie im alten Reporting-Dashboard dargestellt:

  • Zusammenfassung: unten im Bereich Redaktion pro Kalendermonat im Cockpit pflegen (Badge „Live“); sonst Legacy-Import
  • Ansprechpartner: zuerst zugewiesene Key Account Manager (inkl. Organisations-Vererbung), ergänzt um aktive Einträge aus der Teamverwaltung; sonst Legacy-Import
  • Social: eigene Kachel pro Plattform (Facebook, Instagram, …) mit Follower, Reichweite und Top-Post; Posts (Periode) zählt Cockpit-Posts und native/Kanal-Inbox-Posts (Zernio/Outstand-Kanal, z. B. Karma); bei Import-Historie zusätzlich Interaktionen
  • Website: KPI-Kacheln plus Balkendiagramm Besuche nach Wochentag
  • PDF-Archiv: importierte Monats-PDFs mit Download über Legacy-Storage (sofern REPORTING_DASHBOARD_EXPORT_URL erreichbar)

Hinweis: Zusammenfassung und Team aus dem Reporting-Import bleiben als Fallback erhalten. Sobald im Cockpit gepflegt, haben Live-Daten Vorrang (Teamverwaltung bzw. gespeicherte Monatszusammenfassung).

Unter dem Bericht: Bereich Redaktion — Werbebudget (Meta/Google, nur Kalendermonat) und Monatszusammenfassung speichern.

LOOP Treueprogramm​

Was: Ist das LOOP-Programm eines Centers aktiv (Marketing Cockpit → Bonus & Loyalität → Programm), erscheint im Bericht die Kachel LOOP Treueprogramm im Bereich Website & Marketing. Dieselben Zahlen wie unter LOOP — Auswertung, aber für den gewählten Berichtszeitraum (Kalendermonat, Quartal, Jahr oder letzte 7/30 Tage) statt „letzte N Tage ab heute“.

Warum: Das Centermanagement sieht Treue-Nutzung im selben Monatsbericht wie Website und Social, ohne zusätzlichen Termin im LOOP-Bereich.

Wer ist betroffen: Redaktion und Marketing (Bericht, PDF, Kunden-Link). Der Zugriff folgt den bestehenden Regeln des Kunden-Reportings; der Kunden-Link zeigt nur Summen, keine einzelnen Karten.

KPIBedeutung
StempelAlle Stempel im Zeitraum (alle Quellen)
EinlösungenAn der Kasse bestätigte Einlösungen im Zeitraum
Karten gesamtBestand am Ende des Zeitraums
Aktive KartenKarten mit mindestens einem Stempel im Zeitraum (mit Anteil am Bestand)
Ausgegebene PunkteCenterweit vergebene Punkte im Zeitraum
Stempel je aktiver KarteDurchschnitt im Zeitraum

Zusätzlich: die drei Shops mit den meisten Stempeln und eine Zeile in der Kurzfassung. Ein Verlauf pro Tag und der Vorperioden-Vergleich bleiben der Seite LOOP — Auswertung vorbehalten.

So testen: Center mit aktivem LOOP-Programm und einigen Stempeln wählen, Zeitraum Kalendermonat setzen, Kunden-Reporting öffnen. Kachel LOOP Treueprogramm prüfen und mit LOOP — Auswertung vergleichen (bei „letzte 30 Tage“ stimmen die Summen überein; „Aktive Karten“ kann abweichen, weil die Auswertung nach letzter Aktivität zählt). Programm deaktivieren: Kachel verschwindet.

Werbebudget (Meta / Google)​

Im Bereich Redaktion (nur bei gewähltem Kalendermonat):

  1. Meta Ads Monatsbudget und/oder Google Ads Monatsbudget in EUR eintragen.
  2. Werbebudget speichern — erscheint in den jeweiligen Werbe-Kacheln und in der Kurzfassung.
KPIBedeutung
MonatsbudgetGeplanter Betrag für den Monat (Redaktion)
AusgegebenTatsächliche Kosten aus Zernio oder Import
VerbleibendBudget minus Ausgegeben (Hinweis bei Überschreitung)
AuslastungAusgegeben in Prozent des Budgets

Ohne hinterlegtes Budget bleibt die bisherige Anzeige Kosten gesamt. Mit Budget, aber ohne Kampagnendaten im Monat, erscheint die Kachel trotzdem (nur Budget-KPIs).

Unter der Kurzfassung siehst du den Import-Status des Centers (Anzahl Snapshots, Legacy-ID) — hilfreich vor dem ersten Kundentermin nach dem Import.

  • Oben: „Kurz fürs Centermanagement-Gespräch“ — automatisch aus den Kanal-KPIs erzeugt.
  • PDF für Kundengespräch: öffnet ein Druckfenster; im Browser „Als PDF speichern“ wählen (wie beim Social-Reporting).

Analog zum Social-Freigabe-Link kann die Redaktion den Bericht schreibgeschützt an das Centermanagement weitergeben:

AktionWann nutzenGültigkeit
Link für MonatKalendermonat im Dropdown gewählt90 Tage, fester Monat
Dauer-LinkEin Link pro Center, Centermanagement wählt Monat selbst365 Tage, Monatswahl auf der Seite
Per E-MailÖffnet E-Mail-Entwurf mit Monats-Linkwie Monats-Link

Öffentliche URL: /bericht/{token} — Center-Branding, KPI-Karten, Kurzüberblick, PDF-Druck. Keine Cockpit-Navigation, keine Bearbeitung.

Hinweis: Für Kunden-Links einen Kalendermonat wählen (nicht „Letzte 30 Tage“). Der Dauer-Link zeigt standardmäßig den letzten abgeschlossenen Monat; das Centermanagement kann bis zu 18 Monate zurückblättern.

Pro Kanal mit Cockpit-Detailansicht gibt es intern einen Link „Details im Cockpit“ — in der Kunden-Ansicht ausgeblendet.

Ablösung des Reporting-Dashboards​

WasWerHäufigkeit
Website, Social, Chatbot, Signage, Team, Zusammenfassung (Cockpit)Automatisch im Cockpitlaufend
Meta Ads, Google Ads (live)Zernio + täglicher Synclaufend (nach Mapping)
Meta Ads, Google Ads, Keywords (Historie)Einmaliger Reporting-Import durch IT/SMGeinmalig
Monatsbericht für KundenRedaktion: Zeitraum wählen, Kunden-Link oder PDFnach Bedarf

Das frühere Reporting-Dashboard (manuelle monatliche KPI-Pflege) kann nach erfolgreichem Import und Verifikation abgeschaltet werden.

Was (noch) nicht enthalten ist​

  • Weitere Analytics-Module des Cockpits (zum Beispiel Besucherfrequenz, Energie, Umsatz, Parken, QR-Sessions) fließen noch nicht in den Bericht ein; LOOP ist der erste Baustein der Zusammenführung aller aktiven Auswertungen eines Centers.
  • Search-Console-Keywords live (nur historischer Import, derzeit 0 Center in der DB).

KI-Auswertung: Online ↔ Center-Besuch​

Was: KI-gestützte Empfehlungen, wie Online-Kanäle mit mehr Besuchern im Center zusammenhängen — inkl. konkreter Maßnahmen. Texte sind editierbar und erscheinen im Kunden-Link erst nach Freigabe.

Warum: Die Redaktion prüft und formuliert KI-Vorschläge, bevor das Centermanagement sie im öffentlichen Bericht sieht.

Wer ist betroffen: Redaktion/Marketing (Bearbeitung im Cockpit), Centermanagement (nur freigegebene Version im Link/PDF).

Wo: Kunden-Reporting → Block Online ↔ Center-Besuch (KI) unter der Berichtsvorschau. Status-Badges: Entwurf, Nicht freigegeben, Im Kunden-Link live.

Workflow:

  1. Kalendermonat wählen → KI-Auswertung generieren (oder KI neu generieren).
  2. Einleitung, Überschriften, Kundentexte und Empfohlene Maßnahmen anpassen → Entwurf speichern.
  3. Für Kunden-Link freigeben — ab dann erscheint der Block in Berichtsvorschau, Kunden-Link und PDF.
  4. Optional: Freigabe zurückziehen (Entwurf bleibt im Cockpit erhalten).

Bestehende KI-Daten aus früheren Versionen wurden bei der Migration einmalig als freigegeben übernommen — laufende Kunden-Links bleiben unverändert.

Datenbasis: Kanäle des Monatsberichts, aktuelle Events/Angebote, Footfall (Live oder Simulator — wird gekennzeichnet).

API: GET/PATCH/POST /api/analytics/client-report/bridge-insights · Freigabe: POST/DELETE …/bridge-insights/publish

MCP: cockpit_analytics_client_report (Monatsbericht), cockpit_analytics_client_report_bridge_insights (KI-Entwurf; regenerate: true zum Neu-Generieren). Öffentlicher Link nutzt nur freigegebene Insights.

So testen: Kalendermonat → KI generieren → Text ändern → speichern → Vorschau zeigt Hinweis „nicht freigegeben“ → freigeben → Vorschau und /bericht/{token} zeigen Block. Ohne aktiven Chatbot (Community → Bots & Assistenten → Website & v0) erscheinen keine Chatbot-Empfehlungen; die Kachel KI-Assistent wird ausgeblendet.

Google-Bewertungen im Bericht​

Daten aus Analytics → Bewertungen (/dashboard/analytics/reviews):

KPIBedeutung
Bewertung gesamtØ-Sterne und Gesamtzahl auf Google
Neu im ZeitraumBewertungen im gewählten Monat/Zeitraum
Ø im Zeitraum / Ø aktuellDurchschnitt der neuen Bewertungen; ohne neue im Monat Fallback auf aktuelle Google-Bewertungen (wie Cockpit)
StimmungPositiv / neutral / kritisch (Zeitraum oder aktuelle Bewertungen)
Antwort nötigKritische Bewertungen ohne Antwort (wie Analytics → Bewertungen)

Unter den KPIs: bis zu vier Zitate. Liegen im Berichtsmonat keine neuen Bewertungen vor, zeigt die Kachel trotzdem Ø, Stimmung und aktuelle Zitate aus Google Places bzw. GBP — analog zur Cockpit-Ansicht. GBP verbunden = volle Historie; nur Place ID = maximal 5 aktuelle Bewertungen (Google-Places-Limit).

So testen: Center mit googlePlaceId oder GBP-Verbindung → Kunden-Reporting → Kalendermonat → Kachel Google-Bewertungen prüfen.

Zernio Ads (Meta / Google live)​

Werbekonten werden in der Agentur-BM bzw. Google-MCC geschaltet; Cockpit liest Metriken über Zernio (Managed API, analog Outstand für Social).

Einrichtung — alles unter Kunden-Reporting​

Auf /dashboard/analytics/client-report den Bereich Datenquellen aufklappen (ein Ort für Website, Social, Werbung und Import-Status):

AktionWo
Live-Daten holen (Outstand + Zernio)Live-Daten abrufen
Meta/Google diesem Center zuordnenWerbekonten (Zernio) — nur Super Admin
Social-Kanäle verknüpfenSocial Cockpit → Kanäle verknüpfen (Migrationsübersicht für Super Admin)
Historie importierenLink zu Reporting-Import (Super Admin)

Voraussetzung: ZERNIO_API_KEY auf Render + Werbekonten in Zernio verbunden.

Portfolio-Werbekonto (z. B. ILG): Mehrere Center teilen sich ein Meta-Konto in Zernio. Pro Center wird dasselbe zernioAccountId gemappt, aber ein Kampagnen-Filter (campaignFilter: Kürzel wie BPJ, RCO oder Namensfragmente wie Fuchsbezirk) begrenzt die Auswertung auf die Center-Kampagnen. Cockpit wendet den Filter bei Live-Daten, DB-Snapshots und Reporting-Import an (bekannte Center-Slugs wie burgaupark-jena → BPJ auch ohne manuelles Mapping). In Datenquellen erscheint der Filter neben dem Kontonamen.

Auto-Link (Super Admin): Im Dashboard unter Kunden-Reporting → Datenquellen (Abschnitt „Zernio-Verknüpfung“) oder in Community & Antworten beim gelben Hinweis (Zernio verknüpfen). API: POST /api/integrations/zernio/auto-link — verknüpft Werbekonten (Kampagnen-Kürzel) und organische Social-Kanäle (Username + Plattform) mit Cockpit-Centern. Optional Body { "organizationNameContains": "ILG", "centerId": "…", "dryRun": true }. Lokal: cd apps/dashboard && pnpm exec tsx scripts/auto-link-zernio-ads.ts (optional --dry-run, --org Goldbeck). Antwort enthält socialAccounts (gescannt/verknüpft).

Logik: Meta/Google mit Zernio-Live-Kampagnen → Badge „Live“ (auch in vergangenen Monaten). Import-Historie nur, wenn keine Live-Kampagnen für den Zeitraum geladen werden konnten. Center-exklusive Werbekonten (platformAdAccountId) brauchen keinen Kampagnen-Filter — alle Kampagnen des Kontos zählen.

Siehe auch Cron-Setup.

Bericht per E-Mail an das Centermanagement​

Unter dem Bericht: E-Mails speichern + Jetzt senden — mehrere Centermanagement-Adressen möglich (eine pro Zeile oder kommagetrennt). Nur manuell, kein automatischer Versand. Alternativ: Link für Monat, Dauer-Link oder Per E-Mail (mailto).

API (Entwickler)​

Intern (Session / AgencyOS-Key):

GET /api/analytics/client-report?centerId={id}&timeframe=month|week|day
oder &month=YYYY-MM (Kalendermonat), &quarter=YYYY-Q1..Q4 (Quartalsreport), &year=year-YYYY (Jahresreport).

POST /api/analytics/client-report/share-link — Body { centerId, scope: "month"|"persistent", month?: "YYYY-MM" }
GET /api/analytics/client-report/share-link?centerId=&scope=&month= — bestehenden gültigen Link abfragen.

Öffentlich (Token):

GET /api/analytics/client-report/public/{token}?month=YYYY-MM — nur mit gültigem Freigabe-Token; bei scope=persistent Monat per Query wählbar.

GET/PATCH /api/analytics/client-report/summary?centerId=&month=YYYY-MM — Monatszusammenfassung (intern).

GET /api/analytics/client-report/legacy-pdf?centerId=&type=social_media|chatbot&month=YYYY-MM — signed PDF-URL vom Reporting-Dashboard (intern, Analytics-Auth).

GET /api/analytics/client-report/public/{token}/legacy-pdf?type=&month= — PDF-Download in der öffentlichen Kundenansicht.

GET /api/integrations/zernio/accounts — Zernio-Konten (SUPER_ADMIN).

GET|PUT /api/centers/{centerId}/ads-accounts — Werbekonto-Mapping (SUPER_ADMIN); campaignFilter optional im Body.

POST /api/integrations/zernio/auto-link — Zernio-Kampagnen gegen Center matchen (SUPER_ADMIN).

POST /api/analytics/client-report/sync-sources — Outstand + Zernio für ein Center (Session).

GET /api/analytics/client-report/sources?centerId= — Datenquellen-Status fürs UI-Panel.

Antwort intern: aggregierte KPIs pro Kanal, dataKind (live | imported), usedImportedData, Executive Summary, Metadaten zum Zeitraum.
Zugriff intern: gleiche Rollen wie Analytics (analytics-cockpit).

Siehe auch Reporting-Dashboard Import und Analytics-Integration (Developer).

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