CMP-Veranstaltungen

Um Benachrichtigungen zu erhalten, wenn bestimmte Ereignisse eintreten, können Sie die folgenden JavaScript-Methoden verwenden:

  • __cmp("addEventListener",["eventname",callableFunction,capture],null)
  • __cmp("removeEventListener",["eventname",callableFunction,capture],null)
  • __tcfapi("addEventListener",2, callableFunction)
  • __tcfapi("removeEventListener",2, callableFunction, listenerId)

Das CMP kann die folgenden Ereignisse auslösen:

Veranstaltung

Beschreibung

init

Der CMP-Code wurde geladen und der Platzhaltercode wurde entfernt. Zu diesem Zeitpunkt verfügt die CMP noch über keine Informationen zur Einwilligung.

settings

Das CMP hat das Laden seiner Einstellungen abgeschlossen. Falls bereits eine Einwilligungszeichenfolge vorhanden war, können die Einwilligungsdaten nun aus dem CMP ausgelesen werden.

consentscreen

CMP zeigt den Einwilligungsbildschirm an

consentscreenoff

CMP entfernt den Einwilligungsbildschirm

consentscreencustom

CMP zeigt die Seite mit den benutzerdefinierten Auswahlmöglichkeiten an

consent

Das CMP hat eine Einwilligung erfasst oder es wurde ein bereits vorhandenes Cookie gefunden. Die Einwilligungsdaten können nun aus dem CMP ausgelesen werden.

consentapproved

Der Besucher hat allen Anbietern/Zwecken seine Zustimmung erteilt

consentrejected

Der Besucher hat alle Anbieter und Zwecke abgelehnt

consentcustom

Der Besucher hat eine benutzerdefinierte Einwilligung erteilt (Zustimmungen und Ablehnungen)

liestablished

Der Einwilligungsbildschirm wird angezeigt, ein berechtigtes Interesse wurde für diesen Besucher festgestellt.

vendorconsent

Der Besucher hat ein dynamisches Inhaltselement akzeptiert. Die Anbieter-ID des akzeptierten Elements ist in der Subtyp-Variablen zu finden.

gpp

Verschiedene Ereignisse für den IAB-GPP-Standard

tcfv2

Verschiedene Ereignisse für den IAB-TCF-Standard

loadShowing

Sobald der Ladevorgang abgeschlossen ist (siehe Ereignis settings) und das System hat entschieden, die Einwilligungsschicht anzuzeigen.

loadNotShowing

Sobald der Ladevorgang abgeschlossen ist (siehe Ereignis settings) und das System hat entschieden, die Content-Ebene nicht anzuzeigen.

Ereignisbehandler sind definiert als:

var handler = function (eventname, cmpobject, subtype){…} 

Warnung: Verwenden Sie cmpobject nicht mehr verwenden. Die Funktion ist veraltet. Verwenden Sie stattdessen API-Aufrufe.

Beispiel:

<script>
  function getInfos(e,o)
  {     
    var result = __cmp('getCMPData');
    /*... do something with result ...*/
  }
  __cmp("addEventListener",["consent",getInfos,false],null);
</script>

Bitte beachten Sie, dass der Befehl „addEventListener“ von IAB TCF v2 nur auf eine Teilmenge von Ereignissen reagiert.

Beispiele

Weiterleitung des Besuchers auf eine andere Website, wenn keine Einwilligung erteilt wird

Bitte beachten Sie, dass dieses Vorgehen nicht empfohlen wird und rechtliche Probleme verursachen kann!

<script>
  function getInfos(e,o)
  { 
    location.href = "https://www.mywebsite.com/alternative-content.html";
  }
  __cmp("addEventListener",["consentrejected",getInfos,false],null);
</script>

Anzeige einer Meldung, wenn der Besucher abgelehnt hat

<div id="mymessage" style="display:none; position:fixed; left:calc(50% - 300px); top:calc(50% - 200px); width:600px; height:400px; background-color: #fff0c7; padding: 20px; box-shadow: 0px 0px 5px 0px rgba(0, 0, 0, 0.25);"><b>Please consider</b><br>Our website is mainly financed by online advertising. Without consent we will not be able to show you tailored ads and our ad revenue will be much lower. As we respect your choice we like to ask you, if you maybe like to donate 1 EUR instead? This will help us keep the quality of our service up.<br>
<br>
  <a href="donate.html"><b>Donate 1 EUR now!</b></a><br>
<br>
  <a href="#" onclick="document.getElementById('mymessage').style.display = 'none';">No, thanks!</a>
</div>
<script>
  function getInfos(e,o){ document.getElementById('mymessage').style.display = 'block';}
  __cmp("addEventListener",["consentrejected",getInfos,false],null);
</script>

Den Seiteninhalt nach unten verschieben, wenn sich das Einwilligungsfenster öffnet

<script>
 var iscmpopen = false;

 function handleSize()
 {
  if(iscmpopen)
  {
   document.body.style.paddingTop = document.getElementById('cmpbox').offsetHeight + 'px';
  }
  else
  {
   document.body.style.paddingTop = 'inherit';
  }
 }

 function pushDown(e, o)
 {
  iscmpopen = true;
  handleSize();
 }

 function pushUp(e, o)
 {
  iscmpopen = false;
  handleSize();
 }

 window.addEventListener('resize', handleSize, false);
 window.addEventListener('load', handleSize, false);

 __cmp('addEventListener', ['consentscreen', pushDown, false], null);
 __cmp('addEventListener', ['consentscreenoff', pushUp, false], null);
</script>

We do our best to keep this purely informative documentation up to date. However, if you notice that any of these guides need a little touch-up, let us know!