Logo Logo
Cookiebot

Das Programm für Cookiebot wird geladen und erstellt ein Objekt aus JavaScript für die Eingabefläche des Kunden mit der Bezeichnung “Cookiebot“, die die folgenden öffentlichen Eigenschaften, Methoden, Ereignisse und Rückruffunktionen anzeigt. Sie das Tutorial auf, um Informationen über die Implementation des Cookiebot-Skripts in Ihrer Webseitenvorlage zu erhalten.

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

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 The event is triggered if the user accepts the use of cookies. The event is also triggered if the user has consented at an earlier visit to the website.
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: Google Analytics laden, wenn der Benutzer Cookies akzeptiert hat

<script type="text/javascript">

    function CookiebotCallback_OnAccept() {
        if (Cookiebot.consent.statistics)
        {
            enableGoogleAnalytics();
        }
    }

    var _gaq = [];
    function enableGoogleAnalytics() {
        _gaq.push(['_setAccount', 'UA-00000000-0']);
        _gaq.push(['_trackPageview']);
        (function () {
            var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
            ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
            var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
        })();
    }

</script>

Skript-Tag-Daten-Attribute


Name Typ Obligatorisch Beschreibung
data-cbid string Ja Die einmalige ID für Ihr Cookiebot-Abonnement.
data-type string Nein Überschreibt den Standard-Dialog-Typ mit einem der folgenden Werte: <br/> "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

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 "0":
            //Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
            break;

        case "-1":
            //Der Benutzer befindet sich nicht in einer Region, die eine Einwilligung erfordert - alle Cookies werden akzeptiert
            break;

        default: //Der Benutzer hat mindestens eine Art Cookies akzeptiert
            
            //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"])
            {
                //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 "0":
            //Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
            break;

        case "-1":
            //Der Benutzer befindet sich nicht in einer Region, die eine Einwilligung erfordert - alle Cookies werden akzeptiert
            break;

        default: //Der Benutzer hat mindestens eine Art Cookies akzeptiert
            
            //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))
            {
                //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 "0"
            REM Der Benutzer hat keine Cookies akzeptiert - nur die unbedingt notwendigen Cookies einstellen
            Exit Select

        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 mindestens eine Art Cookies akzeptiert
            
            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 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 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