Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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:

  • Layoutoptimierungen: die Buttons für "Individuelle Einstellungen" und "Nur technisch notwendige akzeptieren" werden nun als Textlinks dargestellt

  • Standard-Texte aktualisiert

  • Neue Pluginkonfiguration für das Neuladen der Seite

  • Fehlende Übersetzungen wurden ergänzt

  • Fehlerbehebungen

11.12.2019

Aktualisierung der Dokumentation für Version 2.1.4

Neu in Version 2.1.4

  • Neue Konfiguration um die Darstellung der Links für "Individuelle Einstellungen" und "Nur technisch notwendige akzeptieren" als Text oder Button zu wählen

  • Integration Link zum Impressum

  • Fehlerbehebungen

27.02.2024

Aktualisierung der Dokumentation für Version 2.4.0

Neu in Version 2.4.0

  • Unterstützung Google Consent Mode v2


...


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:

  1. Bezeichnung des Privacy Cookies festlegen: Name der in den Privatsphären Einstellungen für Besucher erscheint

  2. Name des Privacy Cookies festlegen: Mit diesem Namen wird das Opt-In bzw. Opt-Out Cookie des Plugins gespeichert.

  3. Standard Modus setzen (Opt-In/Opt-Out)

  4. Anpassung der Tracking Integration mit if-Abfrage


  • Einstellung Backend: am Beispiel "Matomo"

...

Code Block
languagejs
 <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

...

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":

Image Removed

Nach Speichern wird das Theme neu kompiliert. Im Zweifel noch mal Caches leeren.

Code Block
languagejs
 <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:

 Image Removed

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
languagexml
<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
languagexml
<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
languagexml
<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
languagejs
<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":

Image Added

Nach Speichern wird das Theme neu kompiliert. Im Zweifel noch mal Caches leeren.





Ergebnis

  • Darstellung Frontend:

 Image Added

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
languagexml
<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
languagexml
<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
languagexml
<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.
Wird für jede konfigurierte Google Analtyics Property ID gesetzt.

<individueller Name>

Opt-In / Opt-Out für individuelle Trackings

Laufzeit 100 Jahre.
Wird für jedes individuell konfigurierte Tracking gesetzt.

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.

...