> ## 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

> Statistik-Konfiguration im WEBSALE-Shop: Tracking-Anbieter einbinden, Conversion-Events steuern und Statistikdaten für Auswertungen bereitstellen.

export const KonfigDeeplink = ({node}) => <>
    Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden:{" "}
    <code>{`https://<shop-domain>/admin/config/${node}`}</code>{" "}
    (<a href="/konfiguration/konfigurations-deeplinks">Deeplink-Übersicht</a>)
  </>;

Der Abschnitt `statistics` bündelt die Einstellungen rund um die Statistikdaten Ihres Shops.

***

## `statistics*` - Grundstruktur

Nachfolgend der Grundaufbau des Knotens `statistics`

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

#### Parameterbeschreibung

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

***

## `statistics.dataRetention` - Aufbewahrung von Statistikdaten

In diesem Konfigurationsknoten wird festgelegt, wie lange Statistikdaten je Zeitebene aufbewahrt werden. In der Statistik fallen laufend Zahlen zu Besuchen, Bestellungen und Umsätzen an. Diese können auf folgenden Zeitebenen gespeichert werden:

* Stundenwerte - ein Datenpunkt je Stunde (beispielsweise zur Auswertung von Stoßzeiten oder Kampagnen),
* Tageswerte - ein Datenpunkt je Tag (beispielsweise zum Vergleich zwischen Black Friday 2025 und 2024),
* Monatswerte - ein Datenpunkt je Monat (beispielsweise zum Vergleich von Umsatzwachstum und Kundengewinnung).

Für jede dieser Ebenen legen Sie die Aufbewahrungsfrist getrennt fest. Die Ebenen unterscheiden sich in Bezug auf Detailgrad und Speicherbedarf.

Stundenwerte sind sehr detailliert, benötigen aber viel Speicherplatz (24 Datenpunkte pro Tag) und sind vor allem für kurzfristige Analysen interessant.

Monatswerte hingegen sind grob, benötigen kaum Speicherplatz (12 Datenpunkte pro Jahr) und eignen sich für die Auswertung von Trends über mehrere Jahre.

Die Standardwerte sind so gewählt, dass die feinen Stundenwerte am kürzesten und die groben Monatswerte am längsten gespeichert werden. So bleibt die gespeicherte Datenmenge klein, ohne dass der langfristige Trend verloren geht.

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

<KonfigDeeplink node="statistics.dataRetention" />

#### 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. <br />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`      |