Clientseitiges Cookie-Management

Dies ist eines der effizientesten Verfahren, um zu verhindern, dass durch script-Tags gesteuerte Cookies ohne Einwilligung gesetzt werden. Dieses Verfahren erfordert die am wenigsten aufwendige Änderung an Ihrer Website und erfordert keine Verwendung des Wrappers (unten).

[en] Below are a couple examples in which this method would be applicable.

[en] In-Line Scripting Example:

<script type=’text/javascript’>
document.cookie = “targeting-cookie”+”=”+”1234”
</script>

[en] JavaScript File Example:

<script type=’text/javascript’ src=’/path/cookie.js’></script>

[en] How to Implement

Normale Skript-Tags sehen so aus:

<script type="text/javascript">
code
</script>

Wenn Sie den Skript-Typ umschreiben, müssen Sie die Skripts ändern:

<script type="text/plain" class="optanon-category-C0002">
code
</script>

Die Nummer im Klassenbezeichner entspricht der Cookie-Gruppen-ID für die Cookies, die das Skript lädt. In diesem Fall handelt es sich um Leistungs-Cookies.

[en] How it Works

Wird der obige Code geladen, wird JavaScript innerhalb der Tags nicht ausgeführt, und es werden keine Cookies gesetzt. Wenn dann der Cookie Compliance-Code geladen wird und Cookies die Einwilligung zur zugehörigen Gruppe haben, ändert er das Tag dynamisch in: script type=text/JavaScript – der Code innerhalb der Tags wird dann erkannt und wie gewohnt ausgeführt.

<script type=’text/plain’ class=’optanon-category-C0004’>
document.cookie = “targeting-cookie”+”=”+”1234”
</script>

[en] After re-writing this tag, the script would only fire on the site when a user consents to the C0004 category (Targeting Cookies). The class attribute is responsible for updating the type. When consent is withdrawn/withheld for the assigned category, the type will be text/plain; when consent is given, it will be text/javascript.

[en] In this example, when a user does not consent to Targeting cookies (C0004) , the script tag would appear as follows:

[en] When a user consents to Targeting cookies (C0004), the type will appear as follows:

<script type="text/plain" class="optanon-category-C0002-C0003-C0004">
code
</script>

Der Optanon Wrapper ist im Hauptskript-Tag enthalten und sieht so aus:

<script type="text/javascript">
function OptanonWrapper() {
}
</script>

Er fungiert als Halter für die Hilfsverfahren, mit denen Skripts oder HTML-Tags, die das Setzen von Cookies bewirken, blockiert oder gesteuert werden. Der Wrapper wird bei jedem Seitenaufruf oder immer dann ausgeführt, wenn der Benutzer Änderungen an den Datenschutzeinstellungen im Präferenz-Center speichert.

Werden die Cookie-Gruppen von inaktiv auf aktiv umgeschaltet, so werden die entsprechenden Hilfsverfahren ausgeführt und das zugehörige JavaScript/HTML in die Seite eingefügt.

Die Skripts des Hilfsverfahrens müssen nicht innerhalb der Wrapper-Steuerung platziert werden. Wenn dies jedoch nicht der Fall ist, werden sie nur beim Laden der ersten Seite ausgeführt. Wenn Sie möchten, dass sich eine Opt-in-Aktion (inaktiv zu aktiv) sofort für den Benutzer auf der Seite widerspiegelt, dann sollten Sie den Wrapper verwenden.

Änderungen im Benutzererlebnis als Folge einer Opt-out-Aktion (aktiv zu inaktiv) werden nur beim Aktualisieren der Seite oder beim Navigieren zu einer neuen Seite berücksichtigt.

[en] Below is an example function called through OptanonWrapper():

[en] Example function:

toConsole() {
    console.log(“SUCCESS”)
}
function OptanonWrapper{
  if(OnetrustActiveGroups.includes("C0002")){
    toConsole()
  }
}

[en] OnetrustActiveGroups plays a critical role in the Optanon Wrapper Control method. OnetrustActiveGroups is a data layer variable that gets updated every time a user modifies their choices with the latest category IDs. For more details on this variable, see OnetrustActiveGroups – Verwenden des Datenschichtobjekts.

[en] In the above instance, toConsole() is an example function that is writing a message on the console when the if condition is executed. In this example, the if condition is checking for the OnetrustActiveGroups data layer variable and if it includes the C0002 category, meaning when Performance cookies are active. Whenever this condition is satisfied, the toConsole() function is executed. The toConsole() function will be called every time the OptanonWrapper() fires and when a user consents to Performance cookies (C0002).

[en] When the function is executed based on consent for Performance category, it appears as follows:

[en] Third-party tools often have public methods that can be called to indicate to the tool that a user has granted or revoked consent. These will often result in the technology being set to “strict” or “restricted” mode so that a restricted amount of data is processed to respect a user’s choices. If the technology you want to control has these methods, you can implement them through the OptanonWrapper control. See the following example:

function OptanonWrapper(){
        if(OnetrustActiveGroups.includes(“C0002”)){
                myAnalyticsTool.setUnrestrictedMode () //consent given, operate regularly
        }else{
                myAnalyticsTool.setRestrictedMode() //consent not given, operate in restricted mode
        }
}

[en] Events

[en] The OneTrust JavaScript SDK raises several events that can be used to trigger consent-related actions. The two most relevant events are OneTrustGroupsUpdated, which fires when consent becomes available on page load and whenever consent is changed, and OTConsentApplied, which only fires when an explicit consent action has been taken.

window.addEventListener(“OneTrustGroupsUpdated”, event => {
        if(event.details.includes(“C0002”)){
                myAnalyticsTool.setUnrestrictedMode();
}else{
        myAnalyticsTool.setRestrictedMode();
}
})

[en] For more information on OneTrust JavaScript events, see [en] Cookie Consent Java Script Events Guide.

Hilfsverfahren werden dazu verwendet, Skripts oder HTML-Tags zu blockieren oder zu steuern, die das Setzen von Cookies bewirken.

OneTrust.InsertScript

Bei diesem Verfahren werden die Skripts, die für das Setzen von Cookies verantwortlich sind, in einer externen Datei abgelegt und dynamisch in die Seite eingefügt, wenn die Cookie-Gruppe aktiv ist, der sie zugeordnet sind.

Das Format lautet:

OneTrust.InsertScript(url, selector, callback, options, groupId)

Beispiel 1. OneTrust.InsertScript

OneTrust.InsertScript('/gaCookies.js', 'head', null, null, 'C0002');OneTrust.InsertScript('/performance-cookies-script.js', 'head', null, null, '2');

[en] In the example below, gaCookies.js is an external file that is setting Google Analytics cookies. This JavaScript file will be inserted only when Performance cookies are active. Implementing this using the InsertScript method within the OptanonWrapper() function would appear as follows:

function OptanonWrapper() { 
            OneTrust.InsertScript('path/gaCookies.js','head', null, null, 'C0002');
 }

Das Ergebnis:

[en] In this example, the gaCookies.js file will get injected before the closing head tag of the HTML when Performance cookies (C0002) are active. The following script will be inserted in the source and will be executed as a regular JavaScript file:

<script type="text/javascript" src="path/gaCookies.js"></script>

Wenn die Gruppe Leistungs-Cookies mit der ID 2 auf aktiv oder immer aktiv gesetzt ist, wird das folgende Skript in die Seite unmittelbar vor dem abschließenden head-Tag eingefügt:

Anmerkung

[en] Please note that the gaCookies.js used in the scenario above is strictly an example. This method is applicable to any JavaScript file that is required to be injected in the code based on user consent.

In der folgenden Tabelle finden Sie eine Erläuterung der verschiedenen Parameter.

Parameter	Datentyp	Beschreibung	Wert	Erforderlich
URL	Zeichenfolge	Absolute oder relative URL der JS-Datei		Ja
Selektor	Zeichenfolge	Selektor für übergeordnetes HTML-Element, wo das script-Tag eingefügt wird	Head Body Übergeordnete ID	Ja
Rückruf	Funktion	Eine JavaScript-Funktion, die nach dem Einfügen des Skript-Tags aufgerufen wird	Funktionsname null	Ja
Optionen	Objekt	Eine Liste von Verhaltensweisen, wenn das Skript-Tag eingefügt wird	Siehe Definition der Optionen unten	Ja
groupId	Anzahl	Gruppen-ID, für die das Skript-Tag eingefügt wird	Optanon Gruppen-ID	Ja

OneTrust.InsertHTML

Dieses Verfahren sollte verwendet werden, wenn der Code, der die Einstellung von Cookies steuert, entweder ein Standard- oder ein benutzerdefiniertes HTML-Tag ist.

Das Format lautet:

OneTrust.InsertHtml(element, selector, callback, options, groupId)

Beispiel 2. OneTrust.InsertHTML

OneTrust.InsertHtml('<iframe type="text/html" width="640" height="360" frameborder="no" src="https://www.youtube.com/embed/v=GEH-usLSwqE"></iframe>','123', null, null, 'C0003');OneTrust.InsertHtml('<customElement customAttribute="value">some content</customElement>', 'parent_element_id', null, null, '3');

[en] In this example, the iFrame is the standard HTML element to be injected in a section that has ID 123. The first null value specifies that there is not a callback function and the second null value specifies that there is no options parameter added. The group ID (C0003) will allow the element to be inserted when consent is granted for Functional-category cookies.

Das Ergebnis:

Anmerkung

[en] Please note that this method will automatically add an enclosing div around the element that is getting inserted.

<customElement customAttribute="value">some content</customElement>

Wenn die Gruppe Funktionalitäts-Cookies auf inaktiv gesetzt ist, wird das Skript nicht eingefügt.

In der folgenden Tabelle finden Sie eine Erläuterung der verschiedenen Parameter.

Parameter	Datentyp	Beschreibung	Wert	Erforderlich
Element	Zeichenfolge	Einzufügendes HTML-Tag		Ja
Selektor	Zeichenfolge	ID des übergeordneten HTML-Elements, wo das Element eingefügt wird	Übergeordnete ID	Ja
Rückruf	Funktion	Eine JavaScript-Funktion, die nach dem Einfügen des Elements aufgerufen wird	Funktionsname null	Ja
Optionen	Objekt	Eine Liste von Verhaltensweisen, wenn das Element eingefügt wird	Siehe Definition der Optionen unten null	Ja
groupId	Anzahl	Gruppen-ID, für die das Element eingefügt wird	Optanon Gruppen-ID	Ja

Anmerkung

Einige Komponenten von Drittanbietern, die Cookies setzen, verwenden sowohl JavaScript- als auch HTML-Elemente, die voneinander abhängig sind. In den meisten Fällen müssen Sie dann sowohl das HTML- als auch das JavaScript-Hilfsverfahren gepaart verwenden, um das Problem zu vermeiden, dass ein Element ohne das andere vorhanden ist.

{
deleteSelectorContent: <bool>,
makeSelectorVisible: <bool>,
makeElementsVisible: [‘<id>’, ‘<id>’, ‘<id>’, ...],
deleteElements: [‘<id>’, ‘<id>’, ‘<id>’, ...]
}