Zum Inhalt springen
Dokumentation
Jetzt starten

Anbindung an externe Consent Manager

Inhalt
Nutzung des hybriden Trackings Anbindung an Usercentrics Einsatz der aktuellen CMP Version 2 Einsatz der veralteten CMP Version 1 Für CMP Version 1 & 2 Anbindung an Cookiebot Anbindung an Consentmanager.net Anbindung an OneTrust CookiePro Anbindung an Borlabs Cookie Anbindung an CCM19 Cookie Consent Manager Anbindung an sonstige und eigene Lösungen

In Hinblick auf Cookie-Banner gibt es drei Möglichkeiten für den Einsatz von etracker analytics

  1. Du verzichtest auf ein Cookie-Banner und setzt etracker analytics standardmäßig im Cookie-losen Modus ein. Warum dies 100% rechtskonform in Harmonie mit den Anforderungen der DSGVO und dem TTDSG ist, wird hier erklärt.
  2. Du nutzt den integrierten etracker consent manager.
  3. Du bindest etracker analytics an eine externe Consent Management Plattform (CMP) an.

Im Folgenden erklären wir, was bei der Anbindung an externe Consent Management Plattformen zu tun ist.

Nutzung des hybriden Trackings

Wir empfehlen die Nutzung des Consent-unabhängigen hybriden Trackings mit der Kombination aus Consent-freiem Tracking ohne Cookies und Cookie-Aktivierung nach Einwilligung des Nutzers. Dies hat den großen Vorteil, dass über den Consent nicht das Tracking ein- oder ausgeschaltet, sondern nur der Modus für das Tracking gesteuert wird.

Schaubild Hybrides Tracking

Um etracker analytics mit dem hybriden Tracking an die CMP anzubinden, sind diese zwei Punkte wichtig:

1. Die CMP darf die etracker Skripte nicht blockieren! Der Tracking Code und die Event Codes müssen ausführbar bleiben, damit das Cookie-lose Tracking nicht unterbunden wird.

Für CookiebotConsentmanager.net und OneTrust muss ein Parameter im Tracking & Event Code (eCommerce u. allg.) hinzugefügt werden, um das Blockieren zu verhindern, falls Auto Blocking in der CMP aktiviert ist.

Achtung

Da dies bei Integration via Plugins in Content Management- und Shopsysteme nicht möglich ist, sollte in diesen Fällen das Auto Blocking nicht verwendet werden.

2. Die Cookie-Aktivierung sollte verknüpft werden! Dies ist optional, wird jedoch für bestmögliche Datenqualität empfohlen.

Wir stellen folgende Anleitungen zu Verfügung:

Anbindung an Usercentrics

Falls du noch kein Usercentrics-Konto besitzt, findest du hier Informationen zu den angebotenen Leistungspaketen.

Hinweis

Im Gegensatz zur allgemeinen Usercentrics-Anleitung nimm bitte keinerlei Änderungen am etracker Code oder den etracker <script>-Tags vor und belasse insbesondere den type bei text/javascript, um sicherzustellen, dass ohne Zustimmung die Cookie-lose Tracking-Variante weiterläuft!

In der Benutzeroberfläche von Usercentrics unter Service Settings → Data Processing Services fügst du etracker als weiteren Service hinzu.

Einsatz der aktuellen CMP Version 2

Unter Implementation Data Layer and Events fügst du einen neuen Data Layer vom Typ Window Event hinzu. Als Name für das Window Event wählst du onConsentStatusChange:

Window Event in Usercentrics definieren bei Einsatz der aktuellen CMP

Einsatz der veralteten CMP Version 1

Unter Service Settings → Advanced Data Processing Settings fügst du einen neuen Data Layer vom Typ Window Event hinzu. Als Name für das Window Event wählst du onConsentStatusChange. Aktiviere consents_changed für das Event:

Window Event in Usercentrics definieren bei Einsatz der alten CMP

Für CMP Version 1 & 2

Um die Erlaubnis für das Setzen von etracker Cookies mit dem etracker API Call enableCookies bzw. disableCookies zu verknüpfen, füge noch folgenden Code unterhalb des Tracking Codes oder im Plugin in deine Seiten ein:

etracker API Call enableCookies bzw. disableCookies verknüpfen javascript
<script>
  var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
  function etrackerSetCookieConsent(e) {
    var data = e.data || e.detail;
    if(data && (data.event === 'consent_changed' || data.event === 'consent_status')) {
      if(data['etracker'] === true)
        _etrackerOnReady.push(function(){ _etracker.enableCookies('mydomain.com') });
      else if (data['etracker'] === false)
        _etrackerOnReady.push(function(){ _etracker.disableCookies('mydomain.com') });
    }
  };
  window.addEventListener('onConsentStatusChange', etrackerSetCookieConsent, false);
</script>

Anbindung an Cookiebot

Falls das Auto-Blocking verwendet wird:

Füge data-cookieconsent="ignore" allen etracker <script>-Tags (Tracking Code, Event Tracker und ecommerce Tracking Skripte) als weiteres Attribut hinzu, damit das einwilligungsfreie Tracking nicht unterbunden wird. Bitte keine weiteren Änderungen am etracker Code vornehmen und insbesondere den type bei text/javascript belassen, um sicherzustellen, dass ohne Zustimmung die Cookie-lose Tracking-Variante weiterläuft!

javascript
<script data-cookieconsent="ignore" type="text/javascript">
  // var et_pagename = "";
  // var et_areas = "";
  // var et_tval = 0;
  // var et_tsale = 0;
  // var et_tonr = "";
  // var et_basket = "";
</script>
<script data-cookieconsent="ignore" id="_etLoader" type="text/javascript" charset="UTF-8" data-block-cookies="true" data-secure-code="ABCDE" src="//code.etracker.com/code/e.js" async></script>

Der data-secure-code “ABCDE” ist durch den persönlichen Account-Schlüssel zu ersetzen!

Achtung

Da die Anpassung der etracker Skripte bei Integration via Plugins nur teilweise möglich ist, sollte bei Integration via Plugin das Auto Blocking nicht verwendet werden.

Um die Cookiebot Statistics-Kategorie mit dem etracker API Call enableCookies bzw. disableCookies zu verbinden, fügst du nun die folgenden Zeilen unterhalb des Tracking Tracking Codes ein:

etracker API Call enableCookies bzw. disableCookies verbinden javascript
<script data-cookieconsent="ignore" type="text/javascript">
  var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
  function etrackerSetCookieConsent(e) {
    if (Cookiebot.consent.statistics)
      _etrackerOnReady.push(function(){ _etracker.enableCookies('mydomain.com') });
    else
      _etrackerOnReady.push(function(){ _etracker.disableCookies('mydomain.com') });
  };
  window.addEventListener('CookiebotOnConsentReady', etrackerSetCookieConsent, false); 
</script> 

Als letzten Schritt ergänzt du in Cookiebot die von etracker nach erfolgter Einwilligung gesetzten Cookies gemäß dieser Liste:

Cookiebot Cookies hinzufügen

Anbindung an Consentmanager.net

Falls das Auto-Blocking verwendet wird:

Füge data-cmp-ab="1″ allen etracker <script>-Tags (Tracking Code, Event Tracker und eCommerce Tracking Skripte) als weiteres Attribut hinzu, damit das einwilligungsfreie Tracking nicht unterbunden wird.

Bitte keine weiteren Änderungen am etracker Code vornehmen und insbesondere den type bei text/javascript belassen, um sicherzustellen, dass ohne Zustimmung die Cookie-lose Tracking-Variante weiterläuft!

javascript
<script data-cmp-ab="1" type="text/javascript">
  // var et_pagename = "";
  // var et_areas = "";
  // var et_tval = 0;
  // var et_tsale = 0;
  // var et_tonr = "";
  // var et_basket = "";
</script>
<script data-cmp-ab="1" id="_etLoader" type="text/javascript" charset="UTF-8" data-block-cookies="true" data-secure-code="ABCDE" src="//code.etracker.com/code/e.js" async></script>

Der data-secure-code „ABCDE“ ist durch den persönlichen Account-Schlüssel zu ersetzen!

Achtung

Da die Anpassung der etracker Skripte bei Integration via Plugins nicht möglich ist, sollte bei Integration via Plugin das Auto Blocking nicht verwendet werden.

Um die etracker Domains vom automatischen Blockieren der Skripte auszuschließen, nimmst du in der ConsentManager-Oberfläche unter CMP bearbeiten → Andere Einstellungen folgende Einstellungen vor:

Hier schließt du die etracker Domains vom automatischen Blockieren aus

In der ConsentManager-Oberfläche trägst du unter CMPs → Anbieter den Eintrag etracker GmbH mit dem Zweck Messung ein:

Anbieter in ConsentManager-Oberfläche eintragen

Aktiviere anschließend unter CMP hinzufügen/bearbeiten → Andere Einstellungen den etracker Consent Mode, um bei Einwilligung etracker Cookies zu aktivieren:

etracker Consent Mode aktivieren
Bitte beachte

Einstellungen in der ConsentManager Oberfläche werden erst nach ca. 10 Minuten wirksam.

Anbindung an OneTrust CookiePro

Falls das Auto-Blocking verwendet wird:

Füge data-ot-ignore allen etracker <script>-Tags (Tracking Code, Event Tracker und eCommerce Tracking Skripte) als weiteres Attribut hinzu, damit das einwilligungsfreie Tracking nicht unterbunden wird.

Bitte keine weiteren Änderungen am etracker Code vornehmen und insbesondere den type bei text/javascript belassen, um sicherzustellen, dass ohne Zustimmung die Cookie-lose Tracking-Variante weiterläuft!

javascript
 <script data-ot-ignore type="text/javascript">
  // var et_pagename = "";
  // var et_areas = "";
  // var et_tval = 0;
  // var et_tsale = 0;
  // var et_tonr = "";
  // var et_basket = "";
</script>
<script data-ot-ignore id="_etLoader" type="text/javascript" charset="UTF-8" data-block-cookies="true" data-secure-code="ABCDE" src="//code.etracker.com/code/e.js" async></script>

Der data-secure-code „ABCDE“ ist durch den persönlichen Account-Schlüssel zu ersetzen!

Achtung

Da die Anpassung der etracker Skripte bei Integration via Plugins nicht möglich ist, sollte bei Integration via Plugin das Auto Blocking nicht verwendet werden.

Um die Erlaubnis für das Setzen von etracker Cookies mit dem etracker API Call enableCookies bzw. disableCookies zu verknüpfen, füge noch folgenden Code unterhalb des Tracking Codes in deine Seiten oder im Plugin ein. Ggf. muss der Name der Gruppe (hier „C0002“ für Statistik-Cookies, siehe auch Cookiepedia → Categorizations → Categories in CookiePro) noch angepasst werden:

etracker API Call enableCookies bzw. disableCookies verknüpfen javascript
<script data-ot-ignore type="text/javascript">
  var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
  function etrackerSetCookieConsent(e) {
    var groups = OnetrustActiveGroups.split(',');
    if (groups.includes('C0002'))
      _etrackerOnReady.push(function(){ _etracker.enableCookies('mydomain.com') });
    else
      _etrackerOnReady.push(function(){ _etracker.disableCookies('mydomain.com') });
  };
  function initOneTrustCallback() {
    if(typeof OneTrust !== 'undefined')
      OneTrust.OnConsentChanged(etrackerSetCookieConsent);
    else
      window.setTimeout(initOneTrustCallback, 100);
  };
  initOneTrustCallback();
</script>

Anbindung an Borlabs Cookie

Für Borlabs muss der etracker Code nicht angepasst werden, um das Blockieren zu verhindern.

Lege in Borlabs Cookie in der grafischen Benutzeroberfläche unter Cookies einen neuen Eintrag für etracker an:

Name: etracker
Provider: etracker GmbH
Purpose: Statistics
Cookie Name: Die aktuellen etracker Cookies findest du hier.

Als Opt-In Code trägst du in der Borlabs Cookie Benutzeroberfläche Folgendes ein:

Opt-In Code javascript
 <script type="text/javascript">
    var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
    _etrackerOnReady.push(function(){ _etracker.enableCookies() });
  </script>

Als Opt-Out Code trägst du dies ein:

Opt-Out Code javascript
 <script type="text/javascript">
    var _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;
    _etrackerOnReady.push(function() { if(_etracker.areCookiesEnabled()) { _etracker.disableCookies(); } });
  </script>

Borlabs spielt dann den entsprechenden Code beim Ändern der Settings sowie beim Laden der Seiten aus und aktiviert bzw. deaktiviert das Setzen von Cookies.

Anbindung an CCM19 Cookie Consent Manager

Die Einrichtung des hybriden Trackings im Zusammenspiel mit CCM19 erfordert lediglich das Kopieren und Einfügen eines Codes wie in der Anleitung von CCM19 beschrieben.

Anbindung an sonstige und eigene Lösungen

Achte bei der Einbindung des etracker Codes darauf, dass er als type="text/javascript" ausführbar ist.

Du kannst über Einbindung des folgenden API Calls das Setzen von etracker Cookies aktivieren:

_etracker.enableCookies('mydomain.com');

Der Status, ob Cookies gesetzt werden oder nicht, lässt sich abfragen mit:

_etracker.areCookiesEnabled();

Hier wird true oder false zurückgegeben.

Über diesen Aufruf kann eine bereits erteilte Zustimmung widerrufen werden:

_etracker.disableCookies('mydomain.com');