Analytics SDK

Ü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.

Analysen anzeigen

Greifen Sie auf Ihre Besucheranalysen im Komerza-Dashboard zu

Funktionen

DSGVO-konform

Automatisches Cookie-Consent-Management mit essenziellen/optionalen Cookies

Keine Konfiguration

Fügen Sie einfach das Skript mit Ihrer Shop-ID ein - keine komplexe Einrichtung erforderlich

Echtzeit-Analysen

Sehen Sie Besucherdaten sofort in Ihrem Komerza-Dashboard

Datenschutzfokussiert

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:

<!DOCTYPE html>
<html lang="de">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Mein Shop</title>
  </head>
  <body>
    <!-- Ihr Website-Inhalt -->
    <h1>Willkommen in meinem Shop</h1>

    <!-- Komerza Analytics - Vor dem schließenden </body>-Tag hinzufügen -->
    <script
      data-store-id="your-store-id"
      src="https://cdn.komerza.com/ka.min.js"
    ></script>
  </body>
</html>

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.

Wenn ein Besucher Ihre Website zum ersten Mal besucht:

Sofortiger Seitenaufruf: Ein IP-only-Seitenaufruf wird sofort erfasst (DSGVO-konform)
Anzeige des Cookie-Hinweises: Ein DSGVO-konformer Hinweis erscheint unten rechts
20-Sekunden-Timer: Ohne Reaktion wird das Tracking „Nur Erforderliche” automatisch aktiviert
Nutzerauswahl: Der Besucher kann jederzeit „Nur Erforderliche” oder „Alle akzeptieren” wählen
Präferenzspeicherung: Die Auswahl wird für zukünftige Besuche gespeichert (Cookie-Ablauf nach 1 Stunde)

Nur Erforderliche
Alle akzeptieren

Zufällige Besucher-ID (kein Fingerprinting)
Gerätetyp und Browsername
Referrer-Informationen
Sitzungsverfolgung (Ablauf nach 1 Stunde)
Kein sitzungsübergreifendes Tracking

Implementierungsbeispiele

React/SPA-Integration

Für Single-Page-Applications fügen Sie das Skript einmal in Ihre Haupt-HTML-Datei ein:

<!-- public/index.html (React) oder Haupt-HTML-Datei -->
<!DOCTYPE html>
<html lang="de">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Mein React-Shop</title>
  </head>
  <body>
    <div id="root"></div>

    <!-- Komerza Analytics -->
    <script
      data-store-id="your-store-id"
      src="https://cdn.komerza.com/ka.min.js"
    ></script>
  </body>
</html>

Wenn Sie den Consent programmatisch steuern möchten (z. B. benutzerdefiniertes Cookie-Banner):

<script
  data-store-id="your-store-id"
  src="https://cdn.komerza.com/ka.min.js"
></script>

<script>
  // Nur erforderliches Tracking akzeptieren
  function acceptRequired() {
    window.KomerzaAnalytics.acceptRequired();
  }

  // Vollständiges Analytics-Tracking akzeptieren
  function acceptAll() {
    window.KomerzaAnalytics.acceptOptional();
  }

  document
    .getElementById("accept-required")
    .addEventListener("click", acceptRequired);
  document.getElementById("accept-all").addEventListener("click", acceptAll);
</script>

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:

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:

Dashboard-Anmeldung: Besuchen Sie dashboard.komerza.com
Zu Besucheranalysen navigieren: Klicken Sie auf den Abschnitt „Besucher”
Einblicke ansehen: Sehen Sie Echtzeit- und historische Besucherdaten
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

Analytics-Dashboard

Greifen Sie auf Ihre Besucheranalysen und Berichte zu

Erste Schritte

Shop-Einrichtung

Integrationsleitfäden

Zahlungseinrichtung

Überblick

Analysen anzeigen

Funktionen

DSGVO-konform

Keine Konfiguration

Echtzeit-Analysen

Datenschutzfokussiert

Schnellstart

Einzelskript-Integration

Implementierungsbeispiele

React/SPA-Integration

Datenschutzfunktionen

Content Security Policy (CSP)

Ihre Analysen anzeigen

Ad-Blocker-Kompatibilität

Support

Analytics-Dashboard

​Überblick

Analysen anzeigen

​Funktionen

DSGVO-konform

Keine Konfiguration

Echtzeit-Analysen

Datenschutzfokussiert

​Schnellstart

​Einzelskript-Integration

​Cookie-Consent-Ablauf

​Implementierungsbeispiele

​React/SPA-Integration

​Manuelles Consent-Management

​Datenschutzfunktionen

​Content Security Policy (CSP)

​Ihre Analysen anzeigen

​Ad-Blocker-Kompatibilität

​Support

Analytics-Dashboard

Überblick

Funktionen

Schnellstart

Einzelskript-Integration

Cookie-Consent-Ablauf

Implementierungsbeispiele

React/SPA-Integration

Manuelles Consent-Management

Datenschutzfunktionen

Content Security Policy (CSP)

Ihre Analysen anzeigen

Ad-Blocker-Kompatibilität

Support