du bis expert in shopware 5. Implementiere consentmode mit klaro für shopware 5.7.18 so…
- User
du bis expert in shopware 5. Implementiere consentmode mit klaro für shopware 5.7.18 so , dass es funktioneirt.
- Assistant
Absolut! Hier ist eine detaillierte Anleitung, wie du Consent Mode mit Klaro für Shopware 5.7.18 implementierst. Ich gehe davon aus, dass du bereits Klaro installiert und konfiguriert hast.
1. Voraussetzungen
- Shopware 5.7.18: Diese Anleitung ist speziell auf diese Version zugeschnitten.
- Klaro: Eine funktionierende Klaro-Installation und -Konfiguration in deinem Shopware-System.
- Consent Mode Plugin: Ein Plugin, das die Kommunikation zwischen Klaro und Google Consent Mode ermöglicht. Da es kein offizielles Plugin von Google oder Shopware gibt, müssen wir hierfür entweder ein bestehendes Plugin anpassen oder selbst entwickeln.
- Google Tag Manager (GTM): Ein GTM-Konto, das mit deinem Shopware-Shop verknüpft ist.
- Grundlegendes Verständnis: HTML, JavaScript, Smarty (Shopware Template Engine) und Google Tag Manager.
2. Consent Mode Plugin erstellen/anpassen
Da es kein Standard-Plugin gibt, müssen wir uns behelfen. Ich zeige dir zwei Optionen:
Option A: Eigenes Plugin entwickeln
-
Plugin-Ordner erstellen: Erstelle im Shopware-Plugin-Verzeichnis (
/engine/Shopware/Plugins/Local/Frontend/) einen Ordner für dein Plugin, z.B.ConsentModeKlaro. -
plugin.xmlerstellen: Erstelle in diesem Ordner eineplugin.xml-Datei mit folgendem Inhalt:<?xml version="1.0" encoding="utf-8"?> <plugin xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://developers.shopware.com/developers-guide/plugin-system/plugin-xml/"> <label lang="de">Consent Mode Klaro Integration</label> <label lang="en">Consent Mode Klaro Integration</label> <version>1.0.0</version> <copyright>Dein Name/Firma</copyright> <license>MIT</license> <description lang="de">Integration von Google Consent Mode mit Klaro.</description> <description lang="en">Integration of Google Consent Mode with Klaro.</description> <frontend> <controller name="ConsentModeKlaro" controllerPath="ConsentModeKlaro"/> <template> <templatePath>Resources/views/frontend/</templatePath> </template> <javascript file="Resources/views/frontend/_public/src/js/consent-mode.js"/> </frontend> </plugin> -
Controller erstellen: Erstelle einen Controller unter
/engine/Shopware/Plugins/Local/Frontend/ConsentModeKlaro/Controllers/Frontend/ConsentModeKlaro.php(der Inhalt kann leer sein, er dient primär dazu, dass die JavaScript-Datei geladen wird).<?php class Shopware_Controllers_Frontend_ConsentModeKlaro extends Shopware_Controllers_Frontend_Application { public function indexAction() { // Nichts zu tun, da wir nur das JavaScript laden } } -
JavaScript-Datei erstellen: Erstelle eine JavaScript-Datei unter
/engine/Shopware/Plugins/Local/Frontend/ConsentModeKlaro/Resources/views/frontend/_public/src/js/consent-mode.js. Dies ist der Kern unserer Consent Mode-Logik.(function() { window.klaroConfig = window.klaroConfig || {}; // Funktion, um den Consent Mode zu aktualisieren function updateConsentMode(klaroConsent) { //Standardwerte setzen let analytics_storage = 'denied'; let ad_storage = 'denied'; let ad_user_data = 'denied'; let ad_personalization = 'denied'; let functionality_storage = 'denied'; let personalization_storage = 'denied'; let security_storage = 'granted'; //immer aktiviert, da nötig für Basisfunktionalität let advertisement = 'denied'; if (typeof klaroConsent !== 'undefined') { for (const key in klaroConsent) { if (klaroConsent.hasOwnProperty(key)) { const consent = klaroConsent[key]; if (consent.name === 'googleAnalytics') { analytics_storage = consent.consented ? 'granted' : 'denied'; } else if (consent.name === 'googleAdwords') { ad_storage = consent.consented ? 'granted' : 'denied'; ad_user_data = consent.consented ? 'granted' : 'denied'; ad_personalization = consent.consented ? 'granted' : 'denied'; advertisement = consent.consented ? 'granted' : 'denied'; } else if (consent.name === 'funktionaleCookies') { functionality_storage = consent.consented ? 'granted' : 'denied'; } else if (consent.name === 'personalisierung') { personalization_storage = consent.consented ? 'granted' : 'denied'; } } } } // Consent Mode aktualisieren window.dataLayer = window.dataLayer || []; window.dataLayer.push({ 'event': 'default_consent', 'ad_storage': ad_storage, 'ad_user_data': ad_user_data, 'ad_personalization': ad_personalization, 'analytics_storage': analytics_storage, 'functionality_storage': functionality_storage, 'personalization_storage': personalization_storage, 'security_storage': security_storage, 'advertisement': advertisement }); console.log("Consent Mode updated:", { 'ad_storage': ad_storage, 'ad_user_data': ad_user_data, 'ad_personalization': ad_personalization, 'analytics_storage': analytics_storage, 'functionality_storage': functionality_storage, 'personalization_storage': personalization_storage, 'security_storage': security_storage, 'advertisement': advertisement }); } // Initialen Consent Mode setzen (vor Klaro Initialisierung) updateConsentMode(); // Auf Klaro-Events reagieren document.addEventListener('klaroStatus', function(e) { updateConsentMode(e.detail); }); })(); -
Plugin installieren und aktivieren: Installiere und aktiviere das Plugin im Shopware-Backend.
Option B: Bestehendes Plugin anpassen
- Falls du bereits ein Plugin verwendest, das Klaro-Events abfängt, kannst du die obige JavaScript-Logik dort integrieren.
3. Klaro Konfiguration anpassen
Stelle sicher, dass deine Klaro-Konfiguration (in der
config.jsoder direkt im Backend) die Dienste enthält, die du mit Google Consent Mode steuern möchtest. Wichtig sind dienameAttribute. Die Namen müssen mit denen im Javascript übereinstimmen! Beispiel:klaroConfig = { // ... services: [ { name: 'googleAnalytics', title: 'Google Analytics', purposes: ['analytics'], }, { name: 'googleAdwords', title: 'Google AdWords', purposes: ['marketing'], }, { name: 'funktionaleCookies', title: 'Funktionale Cookies', purposes: ['functional'] }, { name: 'personalisierung', title: 'Personalisierung', purposes: ['personalization'] }, ], // ... };4. Google Tag Manager Konfiguration
- Consent Mode aktivieren: Gehe in deinem Google Tag Manager-Container zu "Verwaltung" -> "Containereinstellungen" und aktiviere "Consent-Übersicht aktivieren".
- Consent Mode Variablen:
GTM verwendet integrierte Variablen, um den Consent Mode Status abzurufen (z.B.
ad_storage,analytics_storage). Diese musst du nicht manuell erstellen. - Tags anpassen:
Passe deine Google Analytics, Google Ads und andere Tags an, um den Consent Mode zu berücksichtigen.
- Google Analytics (GA4): GA4 erkennt den Consent Mode automatisch. Stelle sicher, dass "Consent-Einstellungen überschreiben" in den erweiterten Einstellungen des GA4-Konfigurations-Tags nicht aktiviert ist (es sei denn, du hast einen speziellen Grund dafür).
- Google Ads Conversion Tracking: Aktiviere im Google Ads Conversion Tracking Tag unter "Consent-Einstellungen" die Option "Consent-Einstellungen erforderlich". Definiere, welche Consent-Typen für die Auslösung des Tags erforderlich sind (z.B.
ad_storage). - Andere Tags: Überprüfe die Dokumentation der anderen Tags, die du verwendest, um sicherzustellen, dass sie Consent Mode unterstützen und korrekt konfiguriert sind.
- Initialisierung Consent Du musst einen Tag erstellen, der den Initialen Consent sendet. Dieser Tag muss vor allen anderen Tags feuern!
- Tag Typ: Custom HTML
- HTML:
<script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('consent', 'default', { 'ad_storage': 'denied', 'analytics_storage': 'denied', 'functionality_storage': 'denied', 'personalization_storage': 'denied', 'security_storage': 'granted', 'advertisement': 'denied', 'ad_user_data': 'denied', 'ad_personalization': 'denied', 'region': ['DE'] //Optional, Region anpassen }); </script>- Trigger: Initialization - All Pages
- Consent Initialisierung: muss vor allen anderen Triggern ausgelöst werden
5. Testen
- Entwickler-Tools: Öffne die Entwickler-Tools deines Browsers und überprüfe die Konsole. Du solltest Meldungen von deinem JavaScript-Code sehen, die den Consent Mode Status anzeigen.
- Google Tag Assistant: Verwende den Google Tag Assistant, um zu überprüfen, ob deine Tags korrekt feuern und den Consent Mode berücksichtigen.
- Consent-Banner: Teste verschiedene Consent-Einstellungen im Klaro-Banner und beobachte, wie sich der Consent Mode Status ändert.
Wichtige Hinweise
- DSGVO-Konformität: Consent Mode ist ein wichtiges Werkzeug, um die DSGVO-Konformität zu verbessern, aber es ist kein Allheilmittel. Stelle sicher, dass du alle relevanten Datenschutzbestimmungen einhältst.
- Dokumentation: Lies die offizielle Google Consent Mode Dokumentation für weitere Informationen: https://developers.google.com/tag-platform/security/concepts/consent-mode
- Asynchrone Skripte: Achte darauf, dass alle Skripte, die du verwendest, asynchron geladen werden, um die Performance deines Shops nicht zu beeinträchtigen.
- Caching: Leere nach Änderungen am Plugin oder an der Konfiguration den Shopware-Cache.
Zusammenfassung
Diese Anleitung zeigt dir, wie du Consent Mode mit Klaro in Shopware 5.7.18 implementierst. Die Anpassung eines eigenen Plugins oder eines bestehenden Plugins ist notwendig, um die Kommunikation zwischen Klaro und Google Consent Mode zu ermöglichen. Die korrekte Konfiguration des Google Tag Managers ist entscheidend, um den Consent Mode effektiv zu nutzen. Denke daran, gründlich zu testen und die DSGVO-Bestimmungen einzuhalten.
Ich hoffe, diese detaillierte Anleitung hilft dir weiter! Lass mich wissen, wenn du weitere Fragen hast.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.