URL im Shopware Store | http://store.shopware.com/mnd9813405665247/cookie-hinweis.html |
---|---|
Shopware Versionen | 5.0.0 + |
Datum | Änderung |
---|---|
19.11.2019 | Aktualisierung der Dokumentation für Version 2.1.0 Neu in Version 2.1.0:
|
11.12.2019 | Aktualisierung der Dokumentation für Version 2.1.4 Neu in Version 2.1.4
|
27.02.2024 | Aktualisierung der Dokumentation für Version 2.4.0 Neu in Version 2.4.0
|
...
Table of Contents |
---|
Warning |
---|
Hinweis: Wir übernehmen keine Haftung für den rechtskonformen Einsatz der Erweiterung in Ihrem Shopsystem. Bitte lassen Sie die Implementierung im Zweifel durch Ihre Rechtsberatung abnehmen. |
...
Dieses Plugin zeigt dem Shop-Besucher einen Hinweis auf den Einsatz von Cookies an (z.B. aufgrund der DSGVO, EU-Cookie Richtlinie, Privacy Verordnung) und ermöglicht es Besuchern individuelle Privatsphäre-Einstellungen für Opt-In / Opt-Out für beliebige Trackings festzulegen. Vorkonfiguriert ist Google Analytics. Außerdem integriert sich unser Plugin "Facebook Pixel in Shopware einbinden" automatisch in die Privatsphäre-Einstellungen (Ab Version 1.1.3).
Texte und Positionierung können in den Plugineinstellungen konfiguriert werden.
Privatsphäre Einstellungen
Die Privatsphäre-Einstellungen ermöglichen es Ihren Besuchern den Opt-Out bzw. Opt-In von Trackings individuell zu steuern. Durch die Plugin-Konfiguration kann eingestellt werden ob das Tracking standardmäßig für den Besucher aktiviert ist (Opt-Out Verhalten) oder ob es standardmäßig deaktiviert ist (Opt-In Verhalten). Erst durch den Opt-In des Benutzers werden bspw. Daten an Google Analytics gesendet.
...
Falls Sie weitere Trackings verwenden oder spezielle Integrationen von Facebook Pixel oder Analytics verwenden, für die Sie einen Opt-Out bzw. Opt-In anbieten möchten, können Sie dies über die Konfiguration "weitere Trackings definieren" realisieren. Es können im Standard bis zu 5 weitere Trackings definiert werden. Unser Plugin setzt dann ein individuelles zur Steuerung verwendetes "Privacy Cookie" in welchem der Opt-Out oder Opt-In der Privatsphären-Einstellungen gespeichert wird. Sie können dann in Ihrer Tracking Integration selbst das Cookie abfragen und damit das Tracking aktivieren bzw. deaktivieren.
Die Konfiguration erfolgt in drei Schritten:
Bezeichnung des Privacy Cookies festlegen: Name der in den Privatsphären Einstellungen für Besucher erscheint
Name des Privacy Cookies festlegen: Mit diesem Namen wird das Opt-In bzw. Opt-Out Cookie des Plugins gespeichert.
Standard Modus setzen (Opt-In/Opt-Out)
Anpassung der Tracking Integration mit if-Abfrage
Einstellung Backend: am Beispiel "Matomo"
...
Code Block | ||
---|---|---|
| ||
<script> {literal} if(mndGetTrackingCookie('matomo-is-active') == 'true') { /* Hier steht ihr Integrationscode (nur Javascript). var _paq = window._paq || []; _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="//{$PIWIK_URL}/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', {$IDSITE}]); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s); })(); */ } {/literal} </script> |
Beispiel
...
Code Block | ||
---|---|---|
| ||
<script> document.addEventListener("DOMContentLoaded", function(){ {literal} if(mndGetTrackingCookie('googlematomo-is-mapsactive') == 'true') { document.getElementById("google-maps-container").innerHTML= ` <!-- hier steht bpsw. ihr google maps code <iframe .....></iframe> --> `; } }); </script> <div id="google-maps-container"></div> | ||
Info |
Ergebnis
Darstellung Frontend:
Opt-Out-Link für Shop Inhalte (Datenschutzerklärung etc.)
Info |
---|
Sie können die Privatsphäre-Einstellungen auch in Link-Form an beliebiger Stelle im Shop aufrufen: |
Code Block |
---|
<a href="javascript:mndCookieNotice.mndOpenPrivacySettings();">Privatsphäre-Einstellungen</a> |
Links zur Integration des Google Analytics Opt-In/Opt-Out, wie z.B. in der Datenschutzerklärung:
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndGAOptOut();" onclick="alert('Google Analytics deaktiviert.');">Google Analytics deaktivieren</a>
<a href="javascript:mndCookieNotice.mndGAOptIn();" onclick="alert('Google Analytics aktiviert.');">Google Analytics aktivieren</a> |
Links zur Integration des Opt-In/Opt-Out für weitere Trackings in z.B. der Datenschutzerklärung:
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndOptOutCustom('cookie-name');" onclick="alert('Name deaktiviert.');">Name deaktivieren</a>
<a href="javascript:mndCookieNotice.mndOptInCustom('cookie-name');" onclick="alert('Name aktiviert.');">Name aktivieren</a> |
Sie müssen nur "cookie-name" und "Name" durch die in der Plugin-Konfiguration definierten Werte ersetzen.
...
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndOptInAll();" onclick="alert('Alle Cookies aktiviert');">Alle aktiviert</a>
<a href="javascript:mndCookieNotice.mndOptOutAll();" onclick="alert('Alle Cookies deaktiviert');">Alle deaktiviert</a> |
Ausführung individuellem Javascript-Code
Dies Funktion ermöglicht das Ausführen von benutzerdefiniertem Javascript-Code. Der Code wird ausgeführt, wenn der Benutzer auf den "Akzeptieren-Button" klickt.
Info |
---|
Wir empfehlen an dieser Stelle nur vorgefertigte Javascriptfunktionen auszuführen, die Sie separat, bspw. über die Javascript-Konsole des Browsers testen und ausführen können. Also z.B. keine if oder Klassen-Konstrukte einzufügen. Bspw.: |
Code Block |
---|
funktionsAufruf1();
funktionsAufruf2();
funktionsAufruf3(); |
Neuladen der Seite nach Aktion des Besuchers
Nach dem Speichern der vom Benutzer bevorzugten Einstellung gibt es die Möglichkeit die Seite neu zu laden.
Hierzu muss folgende Plugin-Konfiguration auf "ja" geändert werden:
...
Info |
---|
Bitte beachten Sie dass es hierbei zu Problemen bei POST-Requests kommen kann. |
Darstellung der Links "Individuelle Einstellungen" und "Nur technisch notwendige akzeptieren"
...
Hier können Sie wählen wie die Links im Overlay oder Banner dargestellt werden.
Konfiguration der Texte
Um die Texte des Hinweises und des Buttons zu ändern müssen Sie zur Verwaltung der Textbausteine wechseln. Zu finden unter Hauptmenu → Einstellungen → Textbausteine.
Rechts oben befindet sich das Suchfeld. Durch die Eingabe von "MndCookie" erscheinen die Textbausteine:
...
Markieren Sie den zu ändernden Textbaustein. Der Button "Markierte Textbausteine bearbeiten" führt zur Bearbeitungsmaske. Hier kann auch HTML verwendet werden.
Info |
---|
Beachten Sie, dass nach Änderungen an der Konfiguration im Regelfall der Shopware Cache geleert und ggf. das Template neu kompiliert werden muss, damit die Änderungen im Frontend sichtbar werden.
/* Hier steht ihr Integrationscode (nur Javascript).
var _paq = window._paq || [];
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="//{$PIWIK_URL}/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', {$IDSITE}]);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s);
})();
*/
}
{/literal}
</script> |
Beispiel reines HTML und Javascript
Code Block | ||
---|---|---|
| ||
<script>
document.addEventListener("DOMContentLoaded", function(){
if(mndGetTrackingCookie('google-maps') == 'true') {
document.getElementById("google-maps-container").innerHTML= `
<!-- hier steht bpsw. ihr google maps code <iframe .....></iframe> -->
`;
}
});
</script>
<div id="google-maps-container"></div> |
Info |
---|
Shopware Inhaltsseiten unterstützen kein Javascript. Wenn Sie bspw. Google maps in Shopware Inhaltsseiten einfügen wollen, müssen Sie wie folgt vorgehen. Integrieren Sie den oben genannten <div> Block über den HTML Modus der Inhaltseiten Editor (Icon "<>") an der gewünchten Stelle. Der oben genannte <script> Block muss in der Theme Konfiguration eingefügt werden unter: Einstellungen -> Theme Manager -> (aktives Theme auswählen) → unten rechts auf "Theme konfigurieren" -> Reiter "Konfiguration" -> ganz unten "Weitere JavaScript Bibliotheken": Nach Speichern wird das Theme neu kompiliert. Im Zweifel noch mal Caches leeren. |
Ergebnis
Darstellung Frontend:
Opt-Out-Link für Shop Inhalte (Datenschutzerklärung etc.)
Info |
---|
Sie können die Privatsphäre-Einstellungen auch in Link-Form an beliebiger Stelle im Shop aufrufen: |
Code Block |
---|
<a href="javascript:mndCookieNotice.mndOpenPrivacySettings();">Privatsphäre-Einstellungen</a> |
Links zur Integration des Google Analytics Opt-In/Opt-Out, wie z.B. in der Datenschutzerklärung:
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndGAOptOut();" onclick="alert('Google Analytics deaktiviert.');">Google Analytics deaktivieren</a>
<a href="javascript:mndCookieNotice.mndGAOptIn();" onclick="alert('Google Analytics aktiviert.');">Google Analytics aktivieren</a> |
Links zur Integration des Opt-In/Opt-Out für weitere Trackings in z.B. der Datenschutzerklärung:
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndOptOutCustom('cookie-name');" onclick="alert('Name deaktiviert.');">Name deaktivieren</a>
<a href="javascript:mndCookieNotice.mndOptInCustom('cookie-name');" onclick="alert('Name aktiviert.');">Name aktivieren</a> |
Sie müssen nur "cookie-name" und "Name" durch die in der Plugin-Konfiguration definierten Werte ersetzen.
Links zur Integration des Opt-In/Opt-Out für alle Trackings in z.B. der Datenschutzerklärung:
Code Block | ||
---|---|---|
| ||
<a href="javascript:mndCookieNotice.mndOptInAll();" onclick="alert('Alle Cookies aktiviert');">Alle aktiviert</a>
<a href="javascript:mndCookieNotice.mndOptOutAll();" onclick="alert('Alle Cookies deaktiviert');">Alle deaktiviert</a> |
Ausführung individuellem Javascript-Code
Dies Funktion ermöglicht das Ausführen von benutzerdefiniertem Javascript-Code. Der Code wird ausgeführt, wenn der Benutzer auf den "Akzeptieren-Button" klickt.
Info |
---|
Wir empfehlen an dieser Stelle nur vorgefertigte Javascriptfunktionen auszuführen, die Sie separat, bspw. über die Javascript-Konsole des Browsers testen und ausführen können. Also z.B. keine if oder Klassen-Konstrukte einzufügen. Bspw.: |
Code Block |
---|
funktionsAufruf1();
funktionsAufruf2();
funktionsAufruf3(); |
Neuladen der Seite nach Aktion des Besuchers
Nach dem Speichern der vom Benutzer bevorzugten Einstellung gibt es die Möglichkeit die Seite neu zu laden.
Hierzu muss folgende Plugin-Konfiguration auf "ja" geändert werden:
...
Info |
---|
Bitte beachten Sie dass es hierbei zu Problemen bei POST-Requests kommen kann. |
Darstellung der Links "Individuelle Einstellungen" und "Nur technisch notwendige akzeptieren"
...
Hier können Sie wählen wie die Links im Overlay oder Banner dargestellt werden.
Konfiguration der Texte
Um die Texte des Hinweises und des Buttons zu ändern müssen Sie zur Verwaltung der Textbausteine wechseln. Zu finden unter Hauptmenu → Einstellungen → Textbausteine.
Rechts oben befindet sich das Suchfeld. Durch die Eingabe von "MndCookie" erscheinen die Textbausteine:
...
Markieren Sie den zu ändernden Textbaustein. Der Button "Markierte Textbausteine bearbeiten" führt zur Bearbeitungsmaske. Hier kann auch HTML verwendet werden.
Info |
---|
Beachten Sie, dass nach Änderungen an der Konfiguration im Regelfall der Shopware Cache geleert und ggf. das Template neu kompiliert werden muss, damit die Änderungen im Frontend sichtbar werden. |
Unterstützung Google Consent Mode v2
Ab der Version 2.4.0 unterstützt das Plugin den Google Consent Mode v2. Dieser muss in der Plugin-Konfiguration aktiviert werden:
...
Ohne Zustimmung des Besuchers wird der Standard-Wert wie folgt ausgeliefert:
Code Block |
---|
gtag('consent', 'default', {
'analytics_storage': 'denied',
'ad_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied',
'wait_for_update': 500
}); |
Sobald der Besucher das Setzen aller Cookies erlaubt wird ein entsprechendes Update gesendet:
Code Block |
---|
gtag('consent', 'update', {
'analytics_storage': 'granted',
'ad_storage': 'granted',
'ad_user_data': 'granted',
'ad_personalization': 'granted',
'wait_for_update': 500
}); |
Die Cookie-Typen werden ebenfalls berücksichtigt. Einzeln gesteuert wird:
Cookie-Typ: Tracking und Analyse → setzt den Wert für analytics_storage
je nach Status
Cookie-Typ: Retargeting oder Remarketing → setzt die Werte für ad_storage
, ad_user_data
, ad_personalization
je nach Status
Vom Plugin gesetzte Cookies
Cookie Name | Zweck | Kommentar |
---|---|---|
mnd-ga-opted-in | Google Analytics Opt-In | Laufzeit 100 Jahre |
ga-disable-UA-XXXXXXX-XX | Google Analytics Opt-Out | Laufzeit 100 Jahre. |
<individueller Name> | Opt-In / Opt-Out für individuelle Trackings | Laufzeit 100 Jahre. |
mnd-cookie-accepted- + (Shop-URL ohne Sonderzeichen und Leerzeichen, z.B. wwwgooglede) + Cookie Version (Feld in Plugin-Konfiguration) | Hinweis wird nicht mehr angezeigt wenn bereits eine Aktion erfolgt ist | Laufzeit kann in Plugin konfiguriert werden, Standard 31 Tage |
Info |
---|
Bezüglich des Facebook Pixels finden Sie weitere Informationen in der Plugin-Dokumentation unseres Plugins "Facebook Pixel in Shopware einbinden" unter: v1.x.x Facebook Pixel in Shopware einbinden (MndFacebookPixel) Das Plugin muss mindestens in Version 1.1.3 installiert sein, damit die automatische Integration in die Privatsphäre-Einstellungen erfolgreich ist. |
...