English Version

Zurück zur Übersicht

Klaro Cookie Consent: Konfiguration

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Plugin-Einstellungen

Navigiere zu Einstellungen > Erweiterungen > Klaro Cookie Consent Manager. Alle Einstellungen lassen sich pro Sales Channel überschreiben, du kannst also für verschiedene Shops unterschiedlich konfigurieren.

Einstellungen

Allgemeine Einstellungen

Consent-Verhalten

Speicher-Einstellungen

Google Consent Mode v2

Darstellung

Die Banner-Position gilt nur, wenn "Consent erforderlich" deaktiviert ist. Bei aktiviertem "Consent erforderlich" wird stattdessen ein zentriertes Modal angezeigt.

Konfigurationsschlüssel

Die Einstellungen liegen in der Systemkonfiguration unter dem Präfix MmdKlaroCookieConsent.config. und werden pro Sales Channel gelesen:

Texte über Snippets anpassen

Die Texte der Consent-Kategorien und des Dialogs werden über Shopware-Textbausteine (Snippets) verwaltet. Das ermöglicht beliebig viele Sprachen, nicht nur Deutsch und Englisch. Die Snippet-Keys findest du unter Einstellungen > Textbausteine mit dem Präfix mmd-klaro.

Kategorie-Texte

Tipp: Um z.B. Französisch hinzuzufügen, lege ein neues Snippet-Set für fr-FR an und übersetze die Texte. Klaro zeigt im Storefront automatisch die Sprache des Shops.

Dialog-Texte

Cookie-Services verwalten (Admin-Modul)

Das Plugin hat ein eigenes Admin-Modul mit nativer Shopware-Bedienung. Die Service-Verwaltung findest du unter Erweiterungen > Cookie Consent Services.

graph LR
    A["Erweiterungen"] --> B["Cookie Consent Services"]
    B --> C["Service-Liste"]
    C --> D["Service-Detail"]
    D --> E["Language Switcher"]
    E --> F["Titel und Beschreibung pro Sprache"]

Service-Liste

Die Liste zeigt alle konfigurierten Services mit technischem Namen, Titel, Kategorie sowie den Status "Erforderlich" und "Aktiv" als Icons. Sortierung und Paginierung sind verfügbar, der Language Switcher oben rechts zeigt die Titel in der gewählten Sprache.

Service erstellen und bearbeiten

Klicke auf "Service erstellen" oder auf einen bestehenden Service. Im Header der Detailseite wechselst du mit dem Language Switcher die Sprache, um Titel und Beschreibung pro Sprache zu pflegen. Das funktioniert wie bei Shopware-Produkten oder Kategorien.

Wichtig: Der technische Name kann nach dem Erstellen nicht mehr geändert werden. Er dient als eindeutiger Bezeichner in der Klaro-Konfiguration.

Felder eines Services

Die Option "Standardmäßig aktiviert" ist nicht DSGVO-konform, weil sie die Einwilligung vorwegnimmt. Nutze sie nur mit Bedacht.

Ist kein Sales Channel ausgewählt, wird der Service in keinem Sales Channel angezeigt.

Cookie-Löschregeln

Für jeden Service kannst du Cookies definieren, die bei Widerruf der Einwilligung automatisch gelöscht werden:

Jede Regel braucht ein Muster. Entferne Zeilen, die du nicht ausfüllst.

Google Consent Mode v2

Seit März 2024 verlangt Google den Consent Mode v2 für Websites, die Google Analytics oder Google Ads im Europäischen Wirtschaftsraum nutzen. Aktiviere ihn unter Einstellungen > Erweiterungen > Klaro Cookie Consent Manager mit der Einstellung Google Consent Mode v2 aktivieren.

graph TD
    A["Seitenaufruf"] --> B["Google Consent Default: denied"]
    B --> C["Klaro initialisiert"]
    C --> D{"Nutzer-Interaktion"}
    D -->|"Akzeptiert"| E["gtag consent update: granted"]
    D -->|"Lehnt ab"| F["Consent bleibt denied"]
    E --> G["Google Tags feuern"]
    F --> H["Keine Datenerfassung"]

Bei aktiviertem Google Consent Mode passiert Folgendes:

1. Default-Zustand: Vor dem Auslösen von Tags werden ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage und personalization_storage auf denied gesetzt, security_storage auf granted. Ist "Auf Consent-Update warten" aktiv, kommt wait_for_update mit 500 Millisekunden dazu.
2. Ads Data Redaction: ads_data_redaction wird beim Laden auf true gesetzt und auf false gestellt, sobald für Marketing eingewilligt ist.
3. Consent-Update: Sobald der Nutzer seine Entscheidung speichert, werden die Google-Schlüssel anhand der Kategorie der Services aktualisiert.

Die Zuordnung hängt an der Kategorie, nicht am technischen Namen eines Services. Eine Kategorie, für die in einem Sales Channel kein Service konfiguriert ist, wird nicht angefasst und überschreibt damit keine Signale anderer Skripte oder des Google Tag Managers.

Praxis-Beispiele

Google Analytics 4 (GA4)

Binde dein GA4-Script mit dem Attribut data-name ein, damit Klaro es kontrollieren kann:

<script data-type="application/javascript"
        data-name="google-analytics"
        data-src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"
        type="text/plain"></script>

YouTube (eingebettete Videos)

Das Klaro-Flag für kontextuellen Consent ist im Admin-Formular nicht einstellbar, siehe Fehlerbehebung.

Facebook Pixel

Shopware Session (technisch notwendig)

Dieser Service wird bei der Installation automatisch angelegt: