> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# statistics - Statistikdaten

Der Abschnitt `statistics` bündelt die Einstellungen rund um die Statistikdaten Ihres Shops. Aktuell steuert er die **Datenhaltung**: Über den Unterknoten `dataRetention` legen Sie fest, wie lange die erfassten Statistikwerte je Zeitebene aufbewahrt werden. Damit bestimmen Sie, wie weit Auswertungen zeitlich zurückreichen und wie viel Speicher die Statistik belegt.

## `statistics*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens `statistics`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "statistics": {
      "dataRetention": {...}
    }
}
```

#### Parameterübersicht

| **Parameter**   | **Beschreibung**                                                                  |
| --------------- | --------------------------------------------------------------------------------- |
| `dataRetention` | Aufbewahrungsdauer der Statistikdaten je Zeitebene (Stunden-/Tages-/Monatswerte). |

## `statistics.dataRetention` - Aufbewahrung von Statistikdaten

Dieser Abschnitt legt fest, wie lange Statistikdaten je Zeitebene aufbewahrt werden. WEBSALE hält die Werte in drei Granularitäten vor: **Stundenwerte**, **Tageswerte** und **Monatswerte**. Jede Ebene wird über einen eigenen Parameter gesteuert.

Das Leitprinzip lautet: je älter die Daten, desto gröber dürfen sie sein. Die feinste Ebene (Stundenwerte) ist am speicherintensivsten und nur kurzfristig relevant, daher läuft sie früh aus. Die gröbste Ebene (Monatswerte) ist sehr klein und langfristig wertvoll, daher bleibt sie lange erhalten. So bleibt die Datenmenge beherrschbar, ohne den langfristigen Trend zu verlieren.

`dataRetention` ist ein Singleton und wird einmal pro Shop konfiguriert.

#### Beispielkonfiguration `statistics.dataRetention`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "retainHourlyInMonths": 3,
  "retainDailyInMonths": 24,
  "retainMonthlyInMonths": 60,
  "monthlyUnlimitedRetention": false
}
```

#### Parameterübersicht

| **Parameter**               | **Typ** | **Beschreibung**                                                                                                                                                                                                 |
| --------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `retainHourlyInMonths`      | uint    | Aufbewahrungsdauer der Stundenwerte in Monaten. Stundenwerte sind die feinste und speicherintensivste Ebene; das Maximum begrenzt sie auf höchstens ein Jahr.<br />Mögliche Werte: `0` - `12`<br />Default: `3`  |
| `retainDailyInMonths`       | uint    | Aufbewahrungsdauer der Tageswerte in Monaten.<br />Default: `24`                                                                                                                                                 |
| `retainMonthlyInMonths`     | uint    | Aufbewahrungsdauer der Monatswerte in Monaten.<br />Default: `60`                                                                                                                                                |
| `monthlyUnlimitedRetention` | bool    | Aktiviert die unbegrenzte Aufbewahrung der Monatswerte.<br />`true` - Monatswerte werden dauerhaft aufbewahrt.<br />`false` - Monatswerte werden gemäß `retainMonthlyInMonths` aufbewahrt.<br />Default: `false` |

<Info>
  **Auslieferungsstandard und Begründung**

  Mit neuen Shops werden die oben gezeigten Werte ausgeliefert. Sie sind je Zeitebene bewusst gewählt:

  * **Stundenwerte - 3 Monate:** feinste, speicherintensivste Ebene (24 Punkte/Tag). Nur kurzfristig relevant (Stoßzeiten, Kampagne von gestern); deckt ein Quartal ab.
  * **Tageswerte - 24 Monate:** Arbeitsebene des Händlers. Zwei Jahre ermöglichen den Vorjahresvergleich auf Tagesbasis und decken saisonale Effekte ab.
  * **Monatswerte - 60 Monate (5 Jahre):** strategische Ebene, sehr klein im Speicher (12 Punkte/Jahr). Liefert Mehrjahres-Trends wie Umsatzentwicklung und Kundengewinnung.
  * **`monthlyUnlimitedRetention` - `false`:** Unbegrenztes Datenwachstum soll eine bewusste Entscheidung des Händlers sein, kein stiller Default.
</Info>

Der Abschnitt `statistics` bündelt die Einstellungen rund um die Statistikdaten Ihres Shops. Aktuell steuert er die **Datenhaltung**: Über den Unterknoten `dataRetention` legen Sie fest, wie lange die erfassten Statistikwerte je Zeitebene aufbewahrt werden. Damit bestimmen Sie, wie weit Auswertungen zeitlich zurückreichen und wie viel Speicher die Statistik belegt.

## `statistics*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens `statistics`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "statistics": {
      "dataRetention": {...}
    }
}
```

| **Parameter**   | **Beschreibung**                                                                  |
| --------------- | --------------------------------------------------------------------------------- |
| `dataRetention` | Aufbewahrungsdauer der Statistikdaten je Zeitebene (Stunden-/Tages-/Monatswerte). |

## `statistics.dataRetention` - Aufbewahrung von Statistikdaten

Dieser Abschnitt legt fest, wie lange Statistikdaten je Zeitebene aufbewahrt werden. WEBSALE hält die Werte in drei Granularitäten vor: **Stundenwerte**, **Tageswerte** und **Monatswerte**. Jede Ebene wird über einen eigenen Parameter gesteuert.

Das Leitprinzip lautet: je älter die Daten, desto gröber dürfen sie sein. Die feinste Ebene (Stundenwerte) ist am speicherintensivsten und nur kurzfristig relevant, daher läuft sie früh aus. Die gröbste Ebene (Monatswerte) ist sehr klein und langfristig wertvoll, daher bleibt sie lange erhalten. So bleibt die Datenmenge beherrschbar, ohne den langfristigen Trend zu verlieren.

`dataRetention` ist ein Singleton und wird einmal pro Shop konfiguriert.

#### Beispielkonfiguration `statistics.dataRetention`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "retainHourlyInMonths": 3,
  "retainDailyInMonths": 24,
  "retainMonthlyInMonths": 60,
  "monthlyUnlimitedRetention": false
}
```

| **Parameter**               | **Typ** | **Beschreibung**                                                                                                                                                                                                 |
| --------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `retainHourlyInMonths`      | uint    | Aufbewahrungsdauer der Stundenwerte in Monaten. Stundenwerte sind die feinste und speicherintensivste Ebene; das Maximum begrenzt sie auf höchstens ein Jahr.<br />Mögliche Werte: `0` - `12`<br />Default: `3`  |
| `retainDailyInMonths`       | uint    | Aufbewahrungsdauer der Tageswerte in Monaten.<br />Default: `24`                                                                                                                                                 |
| `retainMonthlyInMonths`     | uint    | Aufbewahrungsdauer der Monatswerte in Monaten.<br />Default: `60`                                                                                                                                                |
| `monthlyUnlimitedRetention` | bool    | Aktiviert die unbegrenzte Aufbewahrung der Monatswerte.<br />`true` - Monatswerte werden dauerhaft aufbewahrt.<br />`false` - Monatswerte werden gemäß `retainMonthlyInMonths` aufbewahrt.<br />Default: `false` |

<Info>
  **Auslieferungsstandard und Begründung**

  Mit neuen Shops werden die oben gezeigten Werte ausgeliefert. Sie sind je Zeitebene bewusst gewählt:

  * **Stundenwerte - 3 Monate:** feinste, speicherintensivste Ebene (24 Punkte/Tag). Nur kurzfristig relevant (Stoßzeiten, Kampagne von gestern); deckt ein Quartal ab.
  * **Tageswerte - 24 Monate:** Arbeitsebene des Händlers. Zwei Jahre ermöglichen den Vorjahresvergleich auf Tagesbasis und decken saisonale Effekte ab.
  * **Monatswerte - 60 Monate (5 Jahre):** strategische Ebene, sehr klein im Speicher (12 Punkte/Jahr). Liefert Mehrjahres-Trends wie Umsatzentwicklung und Kundengewinnung.
  * **`monthlyUnlimitedRetention` - `false`:** Unbegrenztes Datenwachstum soll eine bewusste Entscheidung des Händlers sein, kein stiller Default.
</Info>