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)
| Anzeige | Bedeutung |
|---|---|
| Fragen gesamt | Anzahl erfasster Bot-Turns im gewählten Zeitraum |
| Vorperioden-Vergleich | Prozentuell vs. gleich langer Zeitraum davor |
| Anteil informativ | Anteil der Turns mit Qualität „informativ“ (wenn Mall Pilot answerQuality sendet) |
| Antwortzeit | Durchschnitt und P90 in Sekunden (responseTimeMs) |
| Themenverteilung | Aus Feld topic (Öffnungszeiten, Parken, Shops, …) |
| Top-Fragen je Thema | Gruppierung nach topic + normalisierter Frage (queryNormalized) |
| Besondere Fragen | Negatives Feedback, schwache Antworten, Wissenslücken |
| Learnings | Kurztext 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
- Center wählen, Tab Analytics öffnen.
- Nach Test-Anfragen über Website-Bot prüfen, ob „Fragen gesamt“ steigt.
- Optional Metadaten per API senden und Karte „Mall Pilot Kennzahlen“ prüfen.
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