Direkt zum Hauptinhalt

Heatmap + Growth Insights

Während das Realtime-Dashboard dir den Moment zeigt (siehe „Realtime-Dashboard nutzen"), sind Heatmap und Growth Insights die rückwärtsgewandte Auswertung: wann feuern deine Automations wirklich, und wächst deine Community überhaupt.

Automation-Heatmap

/dashboard/analytics-heatmap (Komponente , Backend AutomationAnalytics::heatmap(), Route GET /v1/analytics/automation/heatmap).

Was du wirklich siehst

Wichtige Korrektur, falls du das aus Marketing-Text oder älterer Doku kennst: Das ist keine Chat-Aktivitäts- oder Viewer-Heatmap. Es ist eine Wochentag/Stunde-Matrix darüber, wann deine Automation-Regeln ausgelöst haben. Datengrundlage ist die Tabelle automation_debug_trace, gruppiert per SQL nach WEEKDAY(created_at) und HOUR(created_at):

  • 7 Zeilen (Wochentage, Montag=0 bis Sonntag=6) × 24 Spalten (Stunden)
  • Zellwert = Anzahl Regel-Auslösungen in diesem Slot
  • Zeitraum wählbar: 7 / 14 / 30 / 90 Tage

Zusätzlich zur Matrix zeigt die Seite: eine Zusammenfassung deiner Automation-Läufe (Gesamtzahl, Durchschnitts-/Maximal-Dauer, erfolgreiche vs. übersprungene/fehlgeschlagene Läufe), eine Alert-Performance-Tabelle (Auslösungen, Replays, durchschnittliche Sichtdauer, Interaktionen, Interaktionsrate) sowie eine „Top Skipped"-Liste — Regeln der letzten 7 Tage, die am häufigsten übersprungen statt ausgeführt wurden.

Wie du sie liest

  • Feuern deine Regeln zu Zeiten, in denen du gar nicht streamst? Dann reagieren sie vermutlich auf zu allgemeine Trigger oder Cross-Channel-Events.
  • Häufig übersprungene Regeln aus der „Top Skipped"-Liste sind ein direkter Hinweis auf zu enge Bedingungen (Cooldowns, Rollen-Filter, Zeitfenster) — nachschärfen oder deaktivieren.
  • Eine leere Matrix an Stream-Tagen heißt: entweder streamst du zu Zeiten außerhalb des gewählten Zeitraums, oder du hast noch keine aktiven Automations.

Plan-Gate und Limit

Die Heatmap ist als Pro/Studio-Feature markiert, mit Werbung „Pro: 90 Tage History · Studio: 365 Tage". Serverseitig ist der Parameter sinceDays aber unabhängig vom Plan hart auf 1–90 gedeckelt — mehr als 90 Tage Historie bekommst du aktuell auch mit Studio-Plan nicht. Wenn du eine Jahres-Übersicht brauchst, exportiere periodisch selbst über den API-Endpunkt.

Growth Insights

/dashboard/growth-insights (Komponente , Backend , Route GET /v1/analytics/growth).

Was hier passiert

Growth Insights ist eine Sammlung regelbasierter Heuristiken, kein Live-Report. Ergebnisse werden 12 Stunden pro Nutzer gecacht (Tabelle growth_insights_runs) — ein Neuladen der Seite zeigt also nicht zwingend frische Zahlen, sondern denselben Lauf bis zum nächsten Cache-Ablauf.

Konkrete Bausteine:

  • Best Stream Hours — die 3 Stunden mit den meisten relevanten Events (bot.start, subscription.status_change, automation.create), gruppiert nach Tagesstunde aus analytics_events.
  • Viewer Peaks — die 5 Tage mit der höchsten Summe an trigger_count aus alert_performance. Wichtig: Das ist ein Proxy, keine echte Concurrent-Viewer-Aufzeichnung — im Code steht dazu explizit der Kommentar, dass keine Session-Aufzeichnung der Viewer-Zahlen existiert.
  • Retention — events_per_user, also Gesamt-Events geteilt durch Anzahl unterschiedlicher anonymous_id-Werte aus analytics_events. Anonymisiert, keine Klarnamen.
  • Raid Impact — Anzahl Tage mit Raid-Alert-Auslösung plus durchschnittliche Tages-Trigger-Zahl an diesen Tagen (aus alert_performance, alert_type = 'raid').
  • Alert-Performance-Top — die 3 Alert-Typen mit dem besten Verhältnis Interaktionen/Auslösungen.
  • Narrative — ein zusammenfassender Text. Ein KI-Pfad über den OpenAI-Key ist im Code als Architektur-Vorbereitung angelegt, ruft aber aktuell dieselbe regelbasierte Logik auf wie ohne KI — es ist noch kein echter LLM-generierter Text.

Zeitraum wählbar 7 / 30 / 90 Tage, serverseitig auf 7–90 Tage begrenzt.

Was die UI selbst einschränkt

Die Seite weist selbst darauf hin: nicht gezählt werden deaktivierte/Draft-Regeln, nicht verbundene Provider und Demo-Aufrufe. Die „Stream-Reichweite"-Werte sind ausdrücklich heuristisch und kein Ersatz für echte Concurrent-Viewer-Zahlen — nimm sie als Trend-Indikator, nicht als exakte Messung.

RelationshipHealth

/dashboard/relationship-health (Komponente ) betrachtet die Bindungs-Qualität deiner Community, ohne einzelne Viewer offenzulegen. Sie ergänzt Growth Insights um die Frage: kommen die gleichen Leute wieder, oder ist es primär Durchlauf? Nutze sie monatlich statt wöchentlich — die Kennzahlen bewegen sich langsamer als Follows/Subs.

Wie du das praktisch nutzt

  • Heatmap nach jedem Stream oder wöchentlich: passt das Feuer-Muster deiner Automations zu deinen tatsächlichen Streamzeiten?
  • Growth einmal pro Woche: Trend-Check bei Best Hours, Viewer Peaks (Proxy!), Retention und Raid-Impact.
  • RelationshipHealth einmal im Monat: längerfristige Bindungs-Trends, kein Tages-Indikator.

Für den vollständigen Live-Blick während des Streams siehe „Realtime-Dashboard nutzen"; für die Combo-/Persona-Adoptions-Auswertung siehe „Combo Stats".