Skip to main content

Chatbot-Analytics — Mall Pilot

Was: Auswertung der KI-Chat-Anfragen pro Center (Website, Kiosk, Companion) — anonymisiert, ohne Roh-Chatlogs in der Tabelle.

Warum: Center-Betrieb und Redaktion sehen, welche Themen häufig sind, wie gut der Bot antwortet und ob Nutzungszahlen steigen oder fallen.

Wer ist betroffen: Redaktion, Center-Betrieb, IT (v0/Mall Pilot Host).

Wo: Dashboard → Chatbot → Tab Analytics (Center im Switcher wählen).

Kennzahlen (Phase 1 + 2)​

AnzeigeBedeutung
Fragen gesamtAnzahl erfasster Bot-Turns im gewählten Zeitraum
Vorperioden-VergleichProzentuell vs. gleich langer Zeitraum davor
Anteil informativAnteil der Turns mit Qualität „informativ“ (wenn Mall Pilot answerQuality sendet)
AntwortzeitDurchschnitt und P90 in Sekunden (responseTimeMs)
ThemenverteilungAus Feld topic (Öffnungszeiten, Parken, Shops, …)
Top-Fragen je ThemaGruppierung nach topic + normalisierter Frage (queryNormalized)
Besondere FragenNegatives Feedback, schwache Antworten, Wissenslücken
LearningsKurztext aus Kennzahlen (optional KI, wenn OPENAI_API_KEY auf dem Server)

Zeitraum oben rechts: 7, 14, 30 oder 90 Tage.

Was Mall Pilot senden muss​

Nach jeder Antwort (fire-and-forget) an
POST /api/centers/{centerId}/chatbot-interactions
(siehe apiHints.chatInteractionsPost in der Visitor Surface).

Pflicht wie bisher: userQuery, aiResponse. Optional u. a.:

  • responseTimeMs, answerQuality (informative | weak | none)
  • topic (z. B. parking, shops, opening_hours, …)
  • sessionId (anonym), locale, feedback (up | down)
  • createdAt (ISO)

Schwache Antworten weiterhin über POST …/chat-gaps — unverändert.

Technische Details: Analytics-Integration.

Export & Kunden-Reporting​

  • CSV: Karte „Kunden-Export“ im Analytics-Tab.
  • PDF: Button „PDF speichern“ in den Mall-Pilot-Kennzahlen (System-Druckdialog → Als PDF speichern).
  • Monatsbericht / E-Mail: Kanal KI-Assistent im Kunden-Reporting — monatlicher Versand an hinterlegte Empfänger wie bei anderen Kanälen.

Datenschutz für Center-Texte​

Für die Datenschutzerklärung auf der Center-Website (Reiter Legal oder externes CMS) können Sie u. a. folgendes aufnehmen:

Der KI-Assistent wertet Fragen in anonymisierter Form aus (gekürzte Textvorschau, Thema, Antwortqualität, Kanal). Personenbezogene Muster (z. B. Namen, E-Mail, Telefon) werden vor der Speicherung entfernt. Es werden keine vollständigen Chatverläufe für Marketingprofile gespeichert. Auswertungsdaten werden nach spätestens sechs Monaten gelöscht (betrieblich konfigurierbar).

Plattform-Cron: CHATBOT_RETENTION_DAYS (Standard 180). Mehr: Datenschutz & Einwilligung.

So testen​

  1. Center wählen, Tab Analytics öffnen.
  2. Nach Test-Anfragen über Website-Bot prüfen, ob „Fragen gesamt“ steigt.
  3. Optional Metadaten per API senden und Karte „Mall Pilot Kennzahlen“ prüfen.
  4. GET /api/analytics/reporting?centerId=&days=30 → chatbotPilotMetrics.topQuestionsByTopic, specialQuestions, learningsSummary.

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