> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics SDK
> Bringen Sie Besucheranalysen zurück in Ihr Komerza-Dashboard mit unserem leichtgewichtigen Analytics-Skript
## Überblick
Das Komerza Analytics SDK ermöglicht es Ihnen, das Besucherverhalten auf Ihrer benutzerdefinierten Website zu verfolgen und die Analysen direkt in Ihrem Komerza-Dashboard anzuzeigen. Mit nur einem einzelnen Script-Tag erhalten Sie umfassende Besuchereinblicke, einschließlich Seitenaufrufe, Benutzersitzungen, Konversionsverfolgung und mehr.
Greifen Sie auf Ihre Besucheranalysen im Komerza-Dashboard zu
## Funktionen
Automatisches Cookie-Consent-Management mit essenziellen/optionalen Cookies
Fügen Sie einfach das Skript mit Ihrer Shop-ID ein – keine komplexe
Einrichtung erforderlich
Sehen Sie Besucherdaten sofort in Ihrem Komerza-Dashboard
Respektiert die Privatsphäre der Nutzer mit transparentem Cookie-Consent und Shadow DOM-Isolierung
## Schnellstart
### Einzelskript-Integration
Fügen Sie das Analytics-Skript mit Ihrer Shop-ID zu Ihren HTML-Seiten hinzu:
```html theme={null}
Mein Shop
Willkommen in meinem Shop
```
Ersetzen Sie `your-store-id` durch Ihre tatsächliche Komerza-Shop-ID aus Ihrem
Dashboard. Das Analytics-Skript verwaltet die DSGVO-Konformität automatisch,
indem es Besuchern einen Cookie-Consent-Hinweis anzeigt.
## Cookie-Consent-Ablauf
Wenn ein Besucher Ihre Website zum ersten Mal besucht:
1. **Sofortiger Seitenaufruf**: Ein IP-only-Seitenaufruf wird sofort erfasst (DSGVO-konform)
2. **Anzeige des Cookie-Hinweises**: Ein DSGVO-konformer Hinweis erscheint unten rechts
3. **20-Sekunden-Timer**: Ohne Reaktion wird das Tracking „Nur Erforderliche" automatisch aktiviert
4. **Nutzerauswahl**: Der Besucher kann jederzeit „Nur Erforderliche" oder „Alle akzeptieren" wählen
5. **Präferenzspeicherung**: Die Auswahl wird für zukünftige Besuche gespeichert (Cookie-Ablauf nach 1 Stunde)
* Zufällige Besucher-ID (kein Fingerprinting)
* Gerätetyp und Browsername
* Referrer-Informationen
* Sitzungsverfolgung (Ablauf nach 1 Stunde)
* Kein sitzungsübergreifendes Tracking
* Browser-Fingerprint für stabile Besucher-ID
* Vollständiges Analytics-Tracking
* Erweiterte Einblicke in das Nutzerverhalten
* Konversions- und Zielverfolgung
* Detaillierte Leistungsmetriken
* Sitzungsübergreifendes Tracking
## Implementierungsbeispiele
### React/SPA-Integration
Für Single-Page-Applications fügen Sie das Skript einmal in Ihre Haupt-HTML-Datei ein:
```html theme={null}
Mein React-Shop
```
## Manuelles Consent-Management
Wenn Sie den Consent programmatisch steuern möchten (z. B. benutzerdefiniertes Cookie-Banner):
```html theme={null}
```
## Datenschutzfunktionen
* **Zufällige Besucher-IDs**: Nur-erforderliches-Tracking verwendet kryptografisch zufällige IDs (kein Fingerprinting)
* **Kurze Ablaufzeit**: Alle Cookies laufen nach 1 Stunde ab
* **Kein domainübergreifendes Tracking**: Cookies sind websitespezifisch
* **IP-Anonymisierung**: Wesentliche Seitenaufrufe sind nur IP, keine Besucher-ID
## Content Security Policy (CSP)
Für Websites mit CSP-Headern fügen Sie Folgendes zu Ihrer CSP-Konfiguration hinzu:
```http theme={null}
Content-Security-Policy:
script-src 'self' https://cdn.komerza.com;
connect-src 'self' https://m-api.komerza.com;
```
Das Analytics-Skript benötigt keine CSP-Nonce-Integration, da es von einem
vertrauenswürdigen CDN geladen wird. Stellen Sie jedoch sicher, dass
`https://cdn.komerza.com` in Ihrer `script-src`-Direktive und
`https://m-api.komerza.com` in Ihrer `connect-src`-Direktive enthalten ist.
## Ihre Analysen anzeigen
Sobald das Skript installiert ist und Besucher auf Ihre Website kommen:
1. **Dashboard-Anmeldung**: Besuchen Sie [dashboard.komerza.com](https://dashboard.komerza.com)
2. **Zu Besucheranalysen navigieren**: Klicken Sie auf den Abschnitt „Besucher"
3. **Einblicke ansehen**: Sehen Sie Echtzeit- und historische Besucherdaten
4. **Leistung verfolgen**: Überwachen Sie Konversionsraten und Nutzerverhalten
## Ad-Blocker-Kompatibilität
Das Analytics-Skript verwendet den Dateinamen `ka.min.js`, der im Vergleich zu Dateinamen mit „analytics" oder „tracking" weniger wahrscheinlich von Ad-Blockern blockiert wird. Einige aggressive Blocker können Analytics-Anfragen jedoch trotzdem blockieren.
## Support
Greifen Sie auf Ihre Besucheranalysen und Berichte zu