Logo Logo
Cookiebot

Nachfolgend finden Sie weiterführende technische Informationen, hauptsächlich für Entwickler. Wenn Sie nach unserem Standardimplementierungsleitfaden für den Einstieg bei Cookiebot suchen, finden Sie diesen hier.

Auf dieser Seite finden Sie unsere SDK-Dokumentation, um benutzerdefinierte Implementierungen von Bannern und Cookie-Kontrollen zu erstellen. Sowie die Optionen für die manuellen Änderungen der automatisierten Mechanismen unseres Cookie-Einwilligungsbanners.

Damit das untenstehende SDK funktioniert, muss das Cookiebot-Skript auf Ihrer Website implementiert sein.

Laden Sie das Cookie-Einwilligungsskript über:

https://consent.cookiebot.com/uc.js?cbid=00000000-0000-0000-0000-000000000000

Oder als:

https://consent.cookiebot.com/uc.js

(mit dem Attribut data-cbid='00000000-0000-0000-0000-000000000000')

Denken Sie daran, 000000000000-0000-0000-0000-0000-000000000000000000 durch Ihre eigene Domaingruppen-ID zu ersetzen, die Sie unter "Ihre Skripte" in Ihrem Cookiebot-Konto finden. 

Das Cookiebot-Skript lädt und erstellt ein clientseitiges JavaScript-Objekt namens 'Cookiebot', das die folgenden öffentlichen Eigenschaften, Methoden, Ereignisse und Callback-Funktionen enthält.

Eigenschaften


Name Typ Standard Beschreibung
consent.necessary bool true Wahr, wenn der aktuelle Benutzer notwendige Cookies akzeptiert hat. Die Eigenschaft ist schreibgeschützt.
consent.preferences bool false Wahr, wenn der aktuelle Benutzer Cookies mit Präferenzfunktion akzeptiert hat. Die Eigenschaft ist schreibgeschützt.
consent.statistics bool false Wahr, wenn der aktuelle Benutzer Cookies mit Statistikfunktion akzeptiert hat. Die Eigenschaft ist schreibgeschützt.
consent.marketing bool false Wahr, wenn der aktuelle Benutzer Cookies mit Marketingfunktion akzeptiert hat. Die Eigenschaft ist schreibgeschützt.
consented bool false Wahr, wenn der Benutzer Cookies akzeptiert hat. Die Eigenschaft ist schreibgeschützt.
declined bool false Wahr, wenn der Benutzer die Verwendung von Cookies abgelehnt hat. Die Eigenschaft ist schreibgeschützt.
hasResponse bool false Wahr, wenn der Benutzer auf den Dialog mit 'annehmen' oder 'ablehnen' reagiert hat. Die Eigenschaft ist schreibgeschützt.
doNotTrack bool false Wahr, wenn der Benutzer 'Nicht verfolgen' (DNT) im Webbrowser aktiviert hat. Wenn DNT aktiviert ist, wird Cookiebot kein Drittanbieter-Cookie CookieConsentBulkTicket setzen, das für Masseneinwilligung verwendet wird. Die Eigenschaft ist schreibgeschützt.

Methoden


Name Parameter Beschreibung
show Keine Führt dazu, dass der Cookie-Einwilligungsdialog angezeigt wird.
hide Keine Bringt den Cookie-Einwilligungsdialog dazu, ausgeblendet zu werden.
renew Keine Zeigt dem Nutzer der Webseite den Cookie-Einwilligungsdialog zur Erneuerung oder Änderung des Einwilligungsstatus des Benutzers an.
getScript string URL,
bool async,
func callback
Lädt eine JavaScript-Datei. URL: Absoluter Pfad zur JavaScript-Datei.
async (Optional): Stellt fest, ob das Skript asynchron geladen werden sollte.
callback (Optional): JavaScript-Funktion zur Ausführung, wenn das Skript fertig geladen ist.
runScripts Keine Bewertet alle geladenen Script-Tags des Typs "text/plain" mit dem Attribut "data-cookieconsent" und führt die Scripts entsprechend dem Einwilligungsstatus des Nutzers aus. Für die Verwendung durch Webseiten, die Inhalte dynamisch laden, z. B. bei Single-Page-Anwendungen. Scripts werden nur einmal ausgeführt, daher ist die Funktion sicher, um mehrmalige Aufrufe durchzuführen, z. B. jedes Mal, wenn neuer Inhalt geladen wird.
withdraw Keine Widerrufen Sie Ihre Einwilligung
submitCustomConsent bool optinPreferences,
bool optinStatistics,
bool optinMarketing
Zustimmung über Javascript einreichen. Dies kann nützlich sein, wenn Sie ein benutzerdefiniertes Banner verwenden möchten.

Beispiel: Link erstellen, der es dem Benutzer ermöglicht, eine Cookie-Einwilligungg zu ändern oder zu erneuern

<a href="javascript: Cookiebot.renew()">Erneuern oder ändern Sie Ihre Cookie-Einwilligung</a>

Ereignisbehandlung


Name Beschreibung
CookiebotOnLoad Das Ereignis wird ausgelöst, wenn das Cookie-Banner geladen wurde, um die Zustimmung des Benutzers zu erhalten.
CookiebotOnAccept Das Ereignis wird ausgelöst, wenn der Benutzer die Verwendung von Cookies akzeptiert. Das Ereignis wird auch ausgelöst, wenn der Benutzer bei einem früheren Besuch der Website zugestimmt hat.
CookiebotOnDecline Das Ereignis wird ausgelöst, wenn der Benutzer die Verwendung von Cookies, durch Klicken auf den Ablehnungs-Button im Cookie-Zustimmungs-Dialog, ablehnt. Das Ereignis wird auch ausgelöst, wenn der Benutzer bereits bei einem früheren Besuch der Website abgelehnt hat.
CookiebotOnDialogInit Wird ausgelöst, wenn das Cookie-Einwilligungs-Banner initialisiert wird, bevor der Inhalt des Banners kompiliert wird.
CookiebotOnDialogDisplay Wird ausgelöst, wenn das Cookie-Einwilligungs-Banner den Endnutzer angezeigt wird.
CookiebotOnTagsExecuted Wird ausgelöst, wenn zur vorherigen Einwilligung markierte Tags (z. B. das Attribut "data-cookieconsent") ausgelöst wurden.

Beispiel: Marketing Cookies laden, wenn der Benutzer akzeptiert hat

<script type="text/javascript">

      window.addEventListener('CookiebotOnAccept', function (e) {
      if (Cookiebot.consent.marketing)
          {
          //Execute code that sets marketing cookies
          }
      }, false);
</script>

Rückrufe


Name Beschreibung
CookiebotCallback_OnLoad Der asynchrone Callback wird ausgelöst, wenn das Cookie-Banner geladen wurde, um die Einwilligung des Benutzers zu erhalten.
CookiebotCallback_OnAccept Ein asynchroner Rückruf wird ausgelöst, wenn der Benutzer den Bestätigungs-Button des Cookie-Einwilligungsdialogs anklickt und wenn ein Benutzer, der eingewilligt hat, eine Seite lädt.
CookiebotCallback_OnDecline Der asynchrone Rückruf wird ausgelöst, wenn der Benutzer im Cookie-Einwilligungsdialog durch Klicken auf den Ablehnungs-Button die Verwendung von Cookies ablehnt. Der Rückruf wird auch ausgelöst, wenn ein Benutzer, der die Verwendung von Cookies abgelehnt hat, eine Seite lädt.
CookiebotCallback_OnDialogInit Wird ausgelöst, wenn das Cookie-Einwilligungs-Banner initialisiert wird, bevor der Inhalt des Banners kompiliert wird.
CookiebotCallback_OnDialogDisplay Wird ausgelöst, wenn das Cookie-Einwilligungs-Banner den Endnutzer angezeigt wird.
CookiebotCallback_OnTagsExecuted Wird ausgelöst, wenn zur vorherigen Einwilligung markierte Tags (z. B. das Attribut "data-cookieconsent") ausgelöst wurden.

Beispiel: Statistik-Cookies laden, wenn der Benutzer den Statistik-Cookies zugestimmt hat


Bitte beachten Sie, dass dieses Beispiel nur relevant ist, wenn Sie den data-blockingmode nicht auf "auto" gesetzt haben und wenn Sie Ihr Skript nicht zur Kontrolle mit data-cookieconsent versehen haben.

<script type="text/javascript">

    function CookiebotCallback_OnAccept() {

          if (Cookiebot.consent.statistics)            

{      

enableStatisticsCookies();              

}

}

function enableStatisticsCookies() {  

         //Code ausführen, der Statistik-Cookies setzt

       }  

</script>

Skript-Tag-Daten-Attribute


Name Typ Obligatorisch Beschreibung
data-cbid string Ja Die eindeutige ID für Ihre Cookiebot-Domaingruppe.
data-type string Nein Überschreibt den Standard-Dialog-Typ mit einem der folgenden Werte:
"optin", "Optout", "Optinout", "Leveloptin", "Inlineoptin"
data-level string Nein Überschreibt die Standardmethode für die Einwilligung mit einer der folgenden Werte: "konkludent", "strikt"
data-culture string Nein Um eine spezifische Sprache für den Benutzerdialog der Einverständniserklärung einzustellen, berücksichtigen Sie hierbei den ISO 639-1-Sprachencode (z.B. "EN" – Englisch). Dies überschreibt die automatische Spracherkennung, die im Cookiebot-Manager voreingestellt ist.
data-framework string Nein Ermöglicht Cookiebot, die Einwilligung zu anderen auf einer Website implementierten Einwilligungs-Frameworks zu signalisieren - zusätzlich zu dem in Cookiebot enthaltenen Standard-Einwilligungs-Framework. Der Wert des Attributs muss mit der Abkürzung für das externe Framework übereinstimmen. Derzeit werden die folgenden Einverständnisrahmen von Drittanbietern unterstützt: Abkürzung "IAB": IAB Europe Transparency & Consent Framework
data-blockingmode string nein Legt fest, ob Cookiebot alle Cookies automatisch blockieren soll, bis ein Benutzer zugestimmt hat, Wert: "auto". Wenn nicht, (Wert: "none") sollten Cookie-Setzskripte manuell angepasst werden, wie in unserem Leitfaden zur manuellen Implementierung beschrieben. Wenn Sie dieses Attribut weglassen, ist das Verhalten gleichwertig dem Wert: "none".

Beispiel: Den Einwilligungs-Dialog dazu bringen, in Englisch angezeigt zu werden

<script id="Cookiebot" data-culture="EN" src="https://consent.cookiebot.com/uc.js" data-cbid="00000000-0000-0000-0000-000000000000" type="text/javascript"></script>

Serverseitige Auslastung


Wenn Ihre Webseite serverseitig Cookies einstellt, können Sie durch Prüfen des aktuellen Anwender-Einwilligungsstatus für die Standard-Handhabung von Cookies bestimmen, welche Art von Cookies Sie festlegen dürfen.

using System.Web.Script.Serialization;
...
HttpCookie CurrentUserConsent = Request.Cookies["CookieConsent"];
if (CurrentUserConsent != null)
{
       switch (CurrentUserConsent.Value)
       {
              case "-1":
                    //Der Benutzer befindet sich nicht in einer Region, die eine Einwilligung erfordert - alle Cookies werden akzeptiert
                    break;
              default: //Der Benutzer hat zugestimmt
                    //Lesen Sie die aktuelle Einwilligung des Benutzers im codierten JavaScript-Format
                     JavaScriptSerializer CookieConsentSerializer = new JavaScriptSerializer();
                     dynamic CookieConsent = CookieConsentSerializer.Deserialize<object>(HttpUtility.UrlDecode(CurrentUserConsent.Value));
if (!CookieConsent["preferences"] && !CookieConsent["statistics"] && !CookieConsent["marketing"])
                     {
                         //Der Benutzer hat Cookies deaktiviert; setze nur unbedingt notwendige Cookies.
                     }
                     else
                     {
                     if (CookieConsent["preferences"])
                     {
                            //Der aktuelle Benutzer akzeptiert Cookies mit Präferenzfunktion
                     }
                     else
                     {
                          //Der aktuelle Benutzer akzeptiert KEINE Cookies mit Präferenzfunktion
                     }
                     if (CookieConsent["statistics"]) 
                     {
                          //Der aktuelle Benutzer akzeptiert Cookies mit Statistikfunktion                      }
                     else
                     {
                          //Aktueller Benutzer akzeptiert KEINE Cookies mit Statistikfunktion
                     }
                     if (CookieConsent["marketing"])
                     {
                          //Der aktuelle Benutzer akzeptiert Cookies mit Marketingfunktion
                     }
                     else
                     {
                          //Der aktuelle Benutzer akzeptiert KEINE Cookies mit Marketingfunktion
                     }
                }
       }
}
else
{
      //Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
}
if (isset($_COOKIE["CookieConsent"])) 
{
      switch ($_COOKIE["CookieConsent"])
      {
            case "-1":
                  //Der Benutzer befindet sich nicht in einer Region, die eine Einwilligung erfordert - alle Cookies werden akzeptiert
                  break;
            default: //Der Benutzer hat zugestimmt
                  //Lesen Sie die aktuelle Einwilligung des Benutzers im codierten JavaScript-Format
                  $valid_php_json = preg_replace('/\s*:\s*([a-zA-Z0-9_]+?)([}\[,])/', ':"$1"$2', preg_replace('/([{\[,])\s*([a-zA-Z0-9_]+?):/', '$1"$2":', str_replace("'", '"',stripslashes($_COOKIE["CookieConsent"]))));
                  $CookieConsent = json_decode($valid_php_json);
if (!filter_var($CookieConsent->preferences, FILTER_VALIDATE_BOOLEAN)
&& !filter_var($CookieConsent->statistics, FILTER_VALIDATE_BOOLEAN) && !
filter_var($CookieConsent->marketing, FILTER_VALIDATE_BOOLEAN))
                  {
                         //Der Benutzer hat Cookies deaktiviert; setze nur unbedingt notwendige Cookies.
                  }
                  else
                  {
                  if (filter_var($CookieConsent->preferences, FILTER_VALIDATE_BOOLEAN))
                  {
                        //Der aktuelle Benutzer akzeptiert Cookies mit Präferenzfunktion
                  }
                  else
                  {
                        //Der aktuelle Benutzer akzeptiert KEINE Cookies mit Präferenzfunktion
                  }
                  if (filter_var($CookieConsent->statistics, FILTER_VALIDATE_BOOLEAN))
                  {
                        //Der aktuelle Benutzer akzeptiert Cookies mit Statistikfunktion
                  }
                  else
                  {
                        //Aktueller Benutzer akzeptiert KEINE Cookies mit Statistikfunktion
                  }
                  if (filter_var($CookieConsent->marketing, FILTER_VALIDATE_BOOLEAN))
                  {
                        //Der aktuelle Benutzer akzeptiert Cookies mit Marketingfunktion
                  }
                  else
                  {
                        //Der aktuelle Benutzer akzeptiert KEINE Cookies mit Marketingfunktion
                  }
              }
       }
}
else
{
      //Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
}
Imports System.Web.Script.Serialization
 ...
Dim CurrentUserConsent As HttpCookie = Request.Cookies("CookieConsent")
If CurrentUserConsent IsNot Nothing Then
      Select Case CurrentUserConsent.Value
           
            Case "-1"
                  REM Der Benutzer befindet sich nicht in einer Region, die eine Einwilligung erfordert - alle Cookies werden akzeptiert
                  Exit Select
            Case Else REM Der Benutzer hat zugestimmt
                  REM Lesen Sie die aktuelle Einwilligung des Benutzers im codierten JavaScript-Format
                  Dim CookieConsentSerializer As New JavaScriptSerializer()
                  Dim CookieConsent As dynamic = CookieConsentSerializer.Deserialize(Of Object)(HttpUtility.UrlDecode(CurrentUserConsent.Value))
                  If Not CookieConsent("preferences") And Not
CookieConsent("statistics") And Not CookieConsent("marketing") Then
                  REM Der Benutzer hat Cookies deaktiviert; setze nur unbedingt notwendige Cookies.
                  Else
                  If CookieConsent("preferences") Then
                      REM Der aktuelle Benutzer akzeptiert Cookies mit Präferenzfunktion
                  Else
                      REM Der aktuelle Benutzer akzeptiert KEINE Cookies mit Präferenzfunktion
                  End If
                  If CookieConsent("statistics") Then
                      REM Der aktuelle Benutzer akzeptiert Cookies mit Statistikfunktion
                  Else
                      REM Aktueller Benutzer akzeptiert KEINE Cookies mit Statistikfunktion
                  End If
                  If CookieConsent("marketing") Then
                      REM Der aktuelle Benutzer akzeptiert Cookies mit Marketingfunktion
                  Else
                      REM Der aktuelle Benutzer akzeptiert KEINE Cookies mit Marketingfunktion
                  End If
             End If
      End Select
Else
      REM Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
End If

Machen Sie heute die Verwendung von Cookies und Online-Tracking auf Ihrer Website DSGVO-/ePR-konform

Jetzt kostenlos testen