# Modul: Statistik

<span style="white-space: pre-wrap;">Das </span>**Statistik-Modul**<span style="white-space: pre-wrap;"> bündelt alle Messwerte rund um deine Spiele – vom Spielverlauf (Starts/Abschlüsse/Abbrüche) über Besucherzahlen bis zu Commerce-Daten (Bestellungen/Umsatz) und Standort-Insights. Du kannst Zeiträume filtern, nach „day/week/month“ gruppieren, mehrere Spiele vergleichen und die Daten exportieren.</span>

---

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/kjBgrafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/kjBgrafik.png)

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/KR4grafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/KR4grafik.png)

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/7jFgrafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/7jFgrafik.png)

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/nZmgrafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/nZmgrafik.png)

---

## Oberfläche &amp; Funktionen

**Spiele (Org)**

- Wähle 1…n Spiele aus deiner Organisation.
- **Tipp:**<span style="white-space: pre-wrap;"> Ohne Auswahl nutzt das Modul automatisch das </span>**aktuell geladene Spiel**.

**Zeitraum &amp; Gruppierung**

- **Start/Ende**<span style="white-space: pre-wrap;"> wählen (Schnellfilter: </span>**heute, diese Woche, letzte 7 Tage, …**).
- **group by:**<span style="white-space: pre-wrap;"> </span>`<span class="editor-theme-code">day | week | month</span>`<span style="white-space: pre-wrap;"> (verdichtet Daten für lange Zeiträume).</span>
- **Skalierung:**<span style="white-space: pre-wrap;"> </span>**auto**<span style="white-space: pre-wrap;"> (achsenabhängig) oder feste Skalen.</span>

**Aktionen**

- **Aktualisieren**<span style="white-space: pre-wrap;"> – neuen Query ausführen.</span>
- **CSV / PDF**<span style="white-space: pre-wrap;"> – Export der aktuell gefilterten Ansicht.</span>

**Übersicht (KPI-Kacheln)**

- **Gestartet**<span style="white-space: pre-wrap;"> · </span>**Abgeschlossen**<span style="white-space: pre-wrap;"> · </span>**Abgebrochen**<span style="white-space: pre-wrap;"> · </span>**Ø-Zeit**<span style="white-space: pre-wrap;"> (Sek.)</span>
- **Besucher (App)**<span style="white-space: pre-wrap;"> · </span>**Besucher (Browser)**
- **Bestellungen**<span style="white-space: pre-wrap;"> · </span>**Umsatz (€)**<span style="white-space: pre-wrap;"> · </span>**Unlocks**
- **Gebucht**<span style="white-space: pre-wrap;"> · </span>**Terminiert**  
    Farblegende unterhalb der Kacheln entspricht den Farben in den Charts.

**Charts &amp; Tabellen**

- Balkendiagramm je Periode (entspr. group by).
- <span style="white-space: pre-wrap;">Tabellen </span>**Playlog je Periode**<span style="white-space: pre-wrap;"> und </span>**Commerce &amp; Termine je Periode**<span style="white-space: pre-wrap;"> mit denselben Kennzahlen.</span>

**Top-Listen &amp; Heatmap**

- **Top Locations**<span style="white-space: pre-wrap;"> (Geostandorte, anonymisiert/aggregiert).</span>
- **Top Browser / User-Agents**<span style="white-space: pre-wrap;"> (Technik-Profil deiner Nutzer:innen).</span>
- **Heatmap (Top-Standorte)**<span style="white-space: pre-wrap;"> auf OSM-Karte – Dichteverteilung deiner Reichweite.</span>

**Rechtehinweis**

- <span style="white-space: pre-wrap;">Im Footer siehst du dein </span>**Lizenz-Level**<span style="white-space: pre-wrap;"> und ob du </span>**Admin**<span style="white-space: pre-wrap;"> bist (Admin = voller Zugriff innerhalb deiner Org).</span>

---

## Metriken – Definition (Kurz)

- **Gestartet**: Spielstarts (Sessions).
- **Abgeschlossen**<span style="white-space: pre-wrap;">: Erreichtes </span>`<span class="editor-theme-code">[[End]]</span>`.
- **Abgebrochen**: Verlassene Sessions, die nicht im Endknoten landen.
- **Ø-Zeit**: Durchschnittliche Spieldauer (Start → Ende/Abbruch) in Sekunden.
- **Besucher (App/Browser)**: Reichweite nach Plattform.
- **Bestellungen / Umsatz (€)**: Commerce-Events aus verbundenem Shop/Checkout.
- **Unlocks**: Freischaltungen (z. B. Paid Unlocks, Codes).
- **Gebucht / Terminiert**: Terminbuchungen / angesetzte Termine (falls Modul aktiv).

> **Datenlatenz:**<span style="white-space: pre-wrap;"> Aggregationen können je nach Volumen einige Minuten verzögert sein.</span>

---

## Lizenz-Matrix (vorläufig)

> **Alle unten genannten Statistik-Funktionen sind grundsätzlich in allen Lizenzmodellen nutzbar.**  
> <span style="white-space: pre-wrap;">Unterschiede (z. B. Limits, Export-Optionen, Vergleich über mehrere Spiele) staffeln wir hier schon vor – </span>**konkrete Kontingente/Größen tragen wir im Lizenz-Kapitel nach**.

<table id="bkmrk-statistik-funktionfr"><colgroup><col></col><col></col><col></col><col></col><col></col><col></col></colgroup><tbody><tr><th>Statistik-Funktion

</th><th>Free

</th><th>Basic

</th><th>Pro

</th><th>Enterprise

</th><th>Notizen

</th></tr><tr><td>Dashboard/KPIs, Charts, Tabellen

</td><td>-

</td><td>✓

</td><td>✓

</td><td>✓

</td><td>Zeitraum + group by

</td></tr><tr><td>Mehrere Spiele auswählen/vergleich

</td><td>–

</td><td>◐

</td><td>✓

</td><td>✓

</td><td>Vergleich/Benchmark

</td></tr><tr><td>CSV-Export

</td><td>-

</td><td>-

</td><td>-

</td><td>✓

</td><td>Umfang/Limits je Lizenz

</td></tr><tr><td>PDF-Export

</td><td>–

</td><td>-

</td><td>-

</td><td>✓

</td><td>Branding/Logo ab Pro

</td></tr><tr><td>Top-Locations &amp; Top-Browser

</td><td>-

</td><td>-

</td><td>-

</td><td>✓

</td><td>Abh. von Datenlage

</td></tr><tr><td>Heatmap (Top-Standorte)

</td><td>-

</td><td>-

</td><td>-

</td><td>✓

</td><td>Bei geringer Datenmenge ggf. ausgeblendet

</td></tr><tr><td>Commerce-Metriken (Bestellungen/Umsatz)

</td><td>–

</td><td>-

</td><td>✓

</td><td>✓

</td><td>Wenn Commerce integriert

</td></tr><tr><td>Termine (Gebucht/Terminiert)

</td><td>–

</td><td>✓

</td><td>✓

</td><td>✓

</td><td>Wenn Terminmodul aktiv

</td></tr><tr><td>API-Zugriff auf Statistikdaten

</td><td>–

</td><td>–

</td><td>–

</td><td>**✓**

</td><td>**Enterprise:**

<span style="white-space: pre-wrap;"> direkter API-Endpoint</span>

</td></tr></tbody></table>

**Legende:**<span style="white-space: pre-wrap;"> ✓ = enthalten · ◐ = enthalten mit Limit (Details im Lizenz-Kapitel) · – = nicht enthalten.</span>

> **Enterprise:**<span style="white-space: pre-wrap;"> Zusätzlich zu UI/Export ist der </span>**direkte Zugriff per API**<span style="white-space: pre-wrap;"> möglich (Authentifizierung via JWT-Token; Endpunkte für aggregierte Zeitreihen, Top-Listen und Roh-Events). Damit kannst du BI-Tools (z. B. Power BI, Looker, Grafana) oder interne Dashboards anbinden.</span>

---

## Best Practices

- **Kurze Reviews**: Für laufende Kampagnen „letzte 7 Tage, group by day“.
- **Monatsreports**<span style="white-space: pre-wrap;">: „dieser/letzter Monat, group by day/week“, Export als </span>**PDF**<span style="white-space: pre-wrap;"> für Stakeholder.</span>
- **A/B-Vergleich**<span style="white-space: pre-wrap;">: Zwei Spiele/Varianten markieren → </span>**Vergleich**<span style="white-space: pre-wrap;"> aktivieren (ab Stufe, siehe Matrix).</span>
- **Qualität messen**<span style="white-space: pre-wrap;">: </span>**Abgeschlossen/gestartet**<span style="white-space: pre-wrap;"> (Completion-Rate) und </span>**Ø-Zeit**<span style="white-space: pre-wrap;"> im Blick behalten.</span>
- **Reichweite verstehen**: Top-Locations &amp; Browser helfen bei Sprach- und Geräte-Optimierung.
- **Daten sauber halten**: Test-Sessions in getrenntem Spiel/Zeitraum laufen lassen, damit Produktionszahlen sauber bleiben.

---

## Datenschutz &amp; Compliance

- <span style="white-space: pre-wrap;">IP-basierte Standortdaten werden </span>**anonymisiert/aggregiert**.
- <span style="white-space: pre-wrap;">Personendaten aus Commerce/Terminen unterliegen der </span>**DSGVO**<span style="white-space: pre-wrap;"> und erscheinen nur </span>**aggregiert**<span style="white-space: pre-wrap;"> im Statistik-Modul.</span>
- <span style="white-space: pre-wrap;">API-Zugriff (Enterprise) erfolgt über </span>**rollenbasierte Tokens**; Logs sind revisionsfähig.