Iubenda logo
Generator starten

Anleitungen

INHALTSÜBERSICHT

Wie Sie Ihre Cookie Solution an Ihre Bedürfnisse anpassen können (Erweiterte Anleitung)

💡 Brauchen Sie eine Einführung? In unserer Cookie Solution-Anleitung für Anfänger erfahren Sie mehr über Konfigurator-Optionen, das Ändern des Bannerstils, der Bannerposition und vieles mehr.

Unser Banner hat folgende Eigenschaften:

  • Er kann eingebaut werden, indem Sie einfach einen Code (auf allen Seiten) Ihrer Webseite einfügen
  • Er enthält einen Standardtext, der vollständig anpassbar ist, sowie einen Link zur Cookie-Richtlinie
  • Er hat ein gänzlich responsives Design — optimiert für verschiedene Auflösungen und Gerätegrößen
  • Wir stellen sicher, dass die Cookie-Richtlinien vor der Einwilligung des Nutzers eingesehen werden können
  • Wir stellen hiermit sicher, dass das Blockieren von Skripten ordnungsgemäß funktioniert – weitere Informationen zu diesem Thema finden Sie in der Einleitung zum Blockieren von Cookies
  • Er ist in der Lage, Einwilligung durch Fortsetzung der Navigation, z. B. durch eine Scroll-Aktion, zu registrieren
  • Wenn die Einwilligung eingeholt wurde, werden asynchron (also ohne erneutes Laden der Seite) alle zuvor geblockten Skripte aktiviert.
  • Falls die Einwilligung bereits erteilt wurde, erscheint das Banner nicht und die Skripte werden automatisch ausgeführt
  • Es ermöglicht eine einfache Anpassung mit unserem Konfigurator. Bearbeiten Sie das Aussehen, die Details, sowie die Funktionen der Cookie Solution, alles mit wenigen Klicks..

Installation

Allgemeine Installation

Um die iubenda Cookie Solution zu aktivieren, müssen Sie nur den folgenden Code in alle Seiten Ihrer Webseite kopieren und einfügen, bevor Sie das HEAD-Tag schliessen.

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>
Wichtig

Der obige Code ist ein Beispiel! Um Ihren eigenen Code zu generieren, klicken Sie einfach auf Aktivieren / Cookie Solution bearbeiten auf der Bearbeitungsseite jeder Website in Ihrem iubenda Dashboard.

WordPress Integration

Wenn Sie ein WordPress-Benutzer sind, können Sie die iubenda Cookie Solution konfigurieren, indem Sie den Code in der Datei header.php des von Ihnen verwendeten Themes vor dem Schließen des HEAD-Tags verwenden.

Alternativ bieten wir auch ein spezielles Plugin an. Weitere Informationen dazu finden Sie in der entsprechenden WordPress Anleitung.

Joomla! Integration

Um die iubenda Cookie Solution auf einer Joomla! Webseite einzurichten, können Sie entweder ein Modul wie das Custom HTML Advanced-Modul oder unser Joomla!-Plugin verwenden, das unten verlinkt ist. Hier ist ein Artikel, der erklärt, wie man das HTML-Modul verwendet, um die mit iubenda generierte Datenschutzerklärung zu integrieren. Wir weisen Sie darauf hin, dass der Code der iubenda Cookie Solution wie immer vor dem Schließen des HEAD-Tags eingegeben werden muss.

Joomla! Plugin

Die Cookie Solution kann auch auf einer Joomla!-Website mit dem speziellen Joomla!-Plugin konfiguriert werden. Für weitere Informationen lesen Sie bitte die umfassende Anleitung zum iubenda-Plugin für Joomla!

Einrichtung

Verfügbare Werte _iub.csConfiguration {}:

Erforderliche Werte

siteId: – ID-Code Ihrer Webseite (Hinweis: Diese ID wird verwendet, um die Einstellungen zwischen mehreren Cookie-Richtlinien in verschiedenen Sprachen zuzuordnen, die derselben Website/App zugeordnet werden können).

cookiePolicyId: – ID-Code Ihrer Cookie-Richtlinie

lang: – Dieser Parameter definiert die Sprache, in der der Inhalt des Cookie-Banners angezeigt werden soll (z.B. “it” für das Italienische, “en” für Englisch, “es” für Spanisch usw.). Alle im Generator verfügbaren Sprachlokalisierungen sind auch für den Inhalt des Banners verfügbar.


IAB Transparency and Consent Framework

Große Werbenetzwerke verlangen nun von den Publishern eine Einwilligung, bevor sie personalisierte Anzeigen zeigen. In dieser Anleitung erfahren Sie, wie Sie diese Anforderung mit dem IAB Transparency and Consent Framework und unserer Cookie Solution erfüllen können.

enableCMP oder enableTcf (boolean, Default ist false) – Wenn true, können Nutzer ihre Präferenzen für das Werbetracking gemäß dem IAB Transparency and Consent Framework verwalten.

googleAdditionalConsentMode (boolean, Default ist false) – Wenn dieser Wert auf true gesetzt wird, können Sie die Einwilligung für Google-Anzeigenpartner einholen, die noch nicht Teil des Transparency and Consent Framework sind, aber sich auf der Liste der Anzeigentechnologie-Anbieter (Ad Tech Providers – ATP) befinden. Diese Funktion ist derzeit über den aktuellen Kanal (auf Englisch) verfügbar.

tcfVersion (number, Default ist 1) – Wenn es auf 2 gesetzt wird, ermöglicht es die Unterstützung der neuesten Version des Transparency and Consent Framework. Lesen Sie unsere Anleitung für den Übergangsprozess (auf Englisch), um alle neuen Funktionen und Vorteile zu verstehen, die mit TCF V2.0 verbunden sind.

tcfPurposes:(object) – TCF v2.0 hat 10 Zwecke, die jeweils eine ID haben:

  1. Informationen auf einem Gerät speichern und/oder darauf zugreifen
  2. Grundanzeigen auswählen
  3. Erstellen Sie ein personalisiertes Anzeigenprofil
  4. Personalisierte Anzeigen auswählen
  5. Erstellen Sie ein personalisiertes Inhaltsprofil
  6. Individuell angepasste Inhalte auswählen
  7. Anzeigenleistung messen
  8. Inhaltsleistung messen
  9. Marktforschung anwenden, um Erkenntnisse über das Publikum zu gewinnen
  10. Produkte entwickeln und verbessern

Mit TCF V2.0 können Sie folgendes tun:

  • die rechtliche Grundlage nur auf Einwilligung oder nur auf ein berechtigtes Interesse beschränken, oder auf beides; und
  • wählen, welche TCF-Zwecke gefördert werden sollen

Und so geht’s. Dank tcfPurposes, werden wir im folgenden Beispiel:

  • Zweck Nummer 1 deaktivieren (“Informationen auf einem Gerät speichern und/oder darauf zugreifen”, auf consent_not_neededgesetzt, nur möglich, wenn unsere Gesetzgebung für diesen Zweck keine Einwilligung verlangt) *,
  • Zweck Nummer 2 deaktivieren (“Grundanzeigen auswählen”, auf false gesetzt),
  • die rechtliche Grundlage nur auf das legitime Interesse (li_only) für den Zweck Nummer 4 (“personalisierte Anzeigen auswählen”) zu beschränken, und
  • die rechtliche Grundlage nur auf die Einwilligung (consent_only) für Zweck Nummer 7 (“Messung der Anzeigenleistung”) beschränken
_iub.csConfiguration = {
    "lang": "en",
    "siteId": xxxxxx, //use your siteId
    "cookiePolicyId": yyyyyy, //use your cookiePolicyId
    "enableTcf": true,
    "tcfVersion": 2,
    ...
    "tcfPurposes": {
        "1": "consent_not_needed",
        "2": false,
        "4": "li_only",
        "7": "consent_only"
    },
    "tcfPublisherCC": "DE",
    "banner": {
        ...
    }
}

* Hinweis zu PurposeOneTreatment: Früher war es in einigen Ländern nicht erforderlich, eine Einwilligung des Nutzers für Zweck Nummer 1 („Informationen auf einem Gerät speichern und/oder darauf zugreifen“) einzuholen. In diesen Fällen konnte die Einholung der Einwilligung für einen Zweck durch die Verwendung von "1": "consent_not_needed". Da diese Option jedoch nur dann aktiviert werden sollte, wenn diese durch die für Sie geltende Gesetzgebung rechtlich unterstützt wird, und zum Zeitpunkt der Erstellung dieses Artikels derzeit kein EU-Land dies gesetzlich unterstützt, raten wir dringend davon ab, diese Option zu verwenden.

askConsentIfCMPNotFound (boolean, Default ist true) – Wenn auf true gesetzt und die Einstellung des IAB-Frameworks nicht gefunden wird, fordert die Cookie Solution standardmäßig eine neue Einwilligung von Nutzern an, die vor der Aktivierung des Frameworks ihre Einwilligung gegeben haben. Setzen Sie diese Option auf false, um dieses Standardverhalten zu deaktivieren.

newConsentAtVendorListUpdate (number, Default ist undefined) – Anzahl der Tage, die gewartet werden muss, um nach der Aktualisierung von vendorlist.json eine neue Einwilligungsanfrage auszulösen. Wenn auf undefined gesetzt, wird Nutzern, die bereits ihre Einwilligung gegeben haben, das Cookie-Banner nicht mehr angezeigt, und die Einwilligung für neue Anbieter wird auf aus gesetzt. Wenn dieser Wert auf 0 gesetzt ist, werden Nutzer bei jeder Aktualisierung der Anbieterliste mit einer neuen Einwilligungsanfrage aufgefordert, ihre Einwilligung zu erteilen.

Klassen

iubenda-advertising-preferences-link – Wenn diese Klasse zu einem beliebigen Element der Seite hinzugefügt wird, löst der Klick auf das Element das Öffnen der modalen Werbetracking-Einstellungen aus (so dass Nutzer ihre TCF-Einstellungen auch nach dem Schließen des Cookie-Banners aktualisieren können).

Bitte beachten Sie, dass Sie alternativ zu dieser spezifischen TCF-Klasse auch den „Allgemeinen“ iubenda-cs-preferences-link, verwenden können – das Ergebnis ist dasselbe.


Optionale Werte

whitelabel: (boolean, Default ist true) – Setzen Sie diesen Wert auf false, um das Branding von iubenda auf der zweiten Ebene anzuzeigen.

floatingPreferencesButtonDisplay: (string, Default ist false) – Dieser definiert die Position des Datenschutz-Widgets (eine Funktion, die es Ihren Nutzern erlaubt, jederzeit auf die Tracking-Einstellungen zuzugreifen und diese zu bearbeiten, nachdem sie ihre anfänglichen Einstellungen vorgenommen haben). Verfügbare Werte: false, true, top-left, top-right, bottom-left, bottom-right (Standardwert, wenn auf true gesetzt), anchored-center-left, anchored-center-right, anchored-top-left, anchored-top-right, anchored-bottom-left, anchored-bottom-right.

floatingPreferencesButtonCaption:(string, Default ist false) – Text des Privacy-Widget Buttons.

floatingPreferencesButtonIcon: (boolean, Default ist true) – Icon of the privacy widget button.

floatingPreferencesButtonHover: (boolean, Default ist false) – Zeigt den Text des Datenschutzwidgets beim Überfahren an.

floatingPreferencesButtonRound: (boolean, Default ist false) – Fügt das iubenda-tp-circle-Attribut zum Datenschutz-Widget-Buttons hinzu.

floatingPreferencesButtonColor: (string, Default ist “#fff”) – Hintergrundfarbe des Datenschutz-Widget-Buttons.

floatingPreferencesButtonCaptionColor: (string, Default ist “#000”) – Textfarbe des Datenschutz-Widget-Buttons.

consentOnScroll: (boolean, Default ist true) – Sie können diesen Wert auf false setzen, um die Erfassung der Einwilligung des Nutzers zu vermeiden, wenn die Seite gescrollt wird.

consentOnLinkAndButton: (boolean, Default ist true) – Die Einwilligung des Nutzers wird normalerweise auch nach dem Anklicken eines Buttons (button) auf der Seite sowie der Links (a) festgehalten. Wird der Wert consentOnLinkAndButton (früherconsentOnButton)auf false gesetzt, ändert sich das Standardverhalten, indem sichergestellt wird, dass die Einwilligung in diesen Fällen als „nicht erteilt“ gilt.

consentOnElement: (string|DOMElement, Default ist “input, textarea, form”) – Die Einwilligung des Nutzers wird durch Klicken auf eines der im Parameter aufgeführten html-Elemente (einschließlich Selektoren wie Klassen und IDs) festgehalten. Im Gegensatz zu consentOnLinkAndButton (siehe oben) verwaltet die Option nicht die Tags a und button. Wichtig: Wenn neue html-Elemente hinzugefügt werden und Sie die Standardelemente noch aktiv haben wollen, müssen Sie diese erneut angeben.

consentOnDocument: (boolean, Default ist false) – Wenn auf true gesetzt, wird die Einwilligung des Nutzers registriert, wenn Sie irgendwo auf die Seite klicken (mit Ausnahme des Bannerbereichs).

consentOnContinuedBrowsing: (boolean, Default ist true) – Wenn auf false gesetzt, werdenconsentOnScroll, consentOnDocument und consentOnLinkAndButton auf false gesetzt und consentOnElement auf kein Element. Auf diese Weise akzeptieren Sie nur die explizite Einwilligung, während die Einwilligung für das Scrollen und die Seiteninteraktion nicht erteilt wird.

consentOnHorizontalScroll: (boolean, Default ist false) – Wenn Sie diesen Wert auf true setzen, wird die Einwilligung auch in Fällen von horizontalem Scrollen erteilt.

consentOnScrollOnElement: (string|DOMElement, Default ist null) – Das Scroll-Ereignis wird auf dem als Parameter übergebenen Element (einschließlich Selektoren wie Klassen und IDs) überwacht. Das DOM-Element ist möglicherweise noch nicht verfügbar, wenn die Cookie Solution initialisiert wird. In diesem Fall können Sie die API-Methode setConsentOnScrollOnElement verwenden.

localConsentDomain: (string, Default ist null) – die Domain, auf der Sie die von den Nutzern eingeholte Einwilligung speichern möchten. Wenn nicht festgelegt, wird die Einwilligung in einem Cookie auf der Domain der aktuellen Seite gespeichert (z.B. beim Besuch von www.example.com wird die Einwilligung in einem Cookie auf der Domain example.com gespeichert). Wenn das Standardverhalten nicht geeignet ist, z.B. wenn sich die Website auf der Domain www.paesaggiurbani.italia.it befindet, muss die Einwilligung für paesaggiurbani.italia.it (und nicht für italia.it) gegeben werden. In diesem Fall müssen Sie die localConsentDomain auf den Wert “paesaggiurbani.italia.it” setzen.

Hinweis: In einem ähnlichen Szenario könnte das Banner, wenn der Wert nicht angegeben wird, dem gleichen Nutzer bei jedem nachfolgenden Besuch/Seitenaufruf weiterhin erscheinen.

localConsentPath: (string, Default ist ‘/’) – Der Pfad, in dem Sie in der lokalen Domain die vom Nutzer erteilte Einwilligung speichern möchten. Standardmässig wird die vom Nutzer erteilte Einwilligung in der lokalen Domain im Cookie im Pfad ‘/’ gespeichert. Auf diese Weise ist das Cookie unabhängig von der aufgerufenen Seite der Domain verfügbar. Wenn Sie zum Beispiel wollen, dass das für www.example.com/percorso1 gesetzte Präferenz-Cookie beim Browsen auf www.example.com/percorso2 nicht verfügbar ist und umgekehrt, ist es notwendig, diesem Parameter den Wert ‘/percorso1’ im ersten Fall und den Wert ‘/percorso2’ im zweiten Fall zuzuweisen.

Beispiele

MANUELLES TAGGEN UND „Per-Kategorie“ Einwilligung

Wenn Sie die Funktion zur „Per-Kategorie“ Einwilligung aktiviert haben, müssen Sie die Kategorien von Skripten, die Cookies vor der Einwilligung installieren, mit einem speziellen, durch Komma getrennten data-iub-purposes attribute. Lesen Sie diese Anleitung für weitere Anweisungen und Beispiele zur Verwendung des manuellen Taggen und der „Per-Kategorie“ Einwilligung.

purposes: (string, Default ist null) – Die Zwecke sind in 5 Kategorien gruppiert (notwendige, einfache Interaktionen & Funktionalitäten, verbesserte Nutzererfahrung, Bewertung, Targeting & Werbung), die jeweils eine ID haben (1, 2, 3, 4, 5). Standardmäßig verwenden wir die Zwecke aus der iubenda Cookie-Richtlinie, die mit Ihrer Konfigurierung verbunden ist, aber Sie können anpassen, welche Kategorien mit purposes (for example, angezeigt werden sollen (zum Beispiel, wenn Sie Ihre eigene Cookie-Richtlinie verwenden).

Hier sind die in jeder Kategorie enthaltenen Zwecke aufgeführt:

  1. Notwendig (ID 1). Enthalten sind folgende Zwecke:
    • Erstellen und Verwalten von Sicherungskopien
    • Hosting und Backend-Infrastruktur
    • Verwaltung von Landingpages und Einladungsseiten
    • Plattform-Dienste und Hosting
    • SPAM-Schutz
    • Optimierung und Verbreitung des Datenverkehrs
    • Überwachung der Infrastruktur
    • Umgang mit Zahlungen
  2. Einfache Interaktionen & Funktionalitäten (ID 2). Enthalten sind folgende Zwecke:
    • Kontaktieren des Nutzers
    • Interaktion mit Live-Chat-Plattformen
    • Verwaltung von Webkonferenzen und Online-Telefonie
    • Verwaltung von Support- und Kontaktanfragen
    • Interaktion mit Support- und Bewertungs-Plattformen
    • Tag-Verwaltung
    • Registrierung und Anmeldung unmittelbar über diese Anwendung
    • Verwaltung von Nutzer-Datenbanken
  3. Verbesserte Nutzererfahrung (ID 3). Enthalten sind folgende Zwecke:
    • Kommentarfunktion
    • Interaktion mit Datensammelplattformen und anderen Dritten
    • Anzeigen von Inhalten externer Plattformen
    • Interaktion mit externen sozialen Netzwerken und Plattformen
    • Interaktion mit Plattformen für Online-Umfragen
    • Verwalten von RSS-Feeds
    • Soziale Funktionen
  4. Bewertung (ID 4). Enthalten sind folgende Zwecke:
    • Analytik
    • Beta-Tests
    • Testen der Performance von Inhalten und Funktionen (A/B-Test)
    • Heat Mapping und Session Recording (Sitzungsaufzeichnung)
    • Verwaltung von Datenerfassung und Online-Umfragen
  5. Targeting & Werbung (ID 5). Enthalten sind folgende Zwecke:
    • Werbung
    • Infrastruktur zur Handhabe von Werbung
    • Kommerzielle Bindung
    • Verwalten von Kontakten und Versenden von Nachrichten
    • Remarketing und Behavioural-Targeting

Wenn Sie z.B. alle 5 Kategorien verwenden und keine iubenda Cookie-Richtlinie verwenden, müssen Sie "purposes": "1, 2, 3, 4, 5" angeben, wenn Sie nicht Bewertung (ID 4) verwenden, können Sie einfach "purposes": "1, 2, 3, 5" angeben und so weiter.

Hinweis: Um wirksam zu sein, muss für diesen Parameter der Wert perPurposeConsent auf true gesetzt werden (siehe oben für weitere Einzelheiten).

skipSaveConsent: (boolean, Default ist false) – Wenn Sie diesen Parameter auf true setzen, wird die Einwilligung nicht in einem Präferenz-Cookie gespeichert.

invalidateConsentBefore: (“TT-MM-JJJJ”, Millisekunden seit Epoch-Zeit, Default ist null) – Alle vor diesem Datum gesammelten Einwilligungen werden für ungültig erklärt. Einwilligungen, die an diesem Datum und in der Zukunft eingeholt werden, werden nicht ungültig gemacht.

maxCookieSize: (number, Default ist 4096) – Um zu vermeiden, dass Browser Cookies mit mehr als 4096 Zeichen ablehnen, erlaubt die Cookie Solution die Aufteilung von Cookies in mehrere Teile. MitmaxCookieSize können Sie die maximale Länge jedes Teils konfigurieren (siehe auch maxCookieChunks).

maxCookieChunks:(number, Default ist 5) – Mit diesem Parameter können Sie die maximale Anzahl von Teilen konfigurieren, in die Cookies aufgeteilt werden können (siehe auch maxCookieSize).

Hinweis: Wenn das zu speichernde Cookie länger als maxCookieSize * maxCookieChunks (20480 Zeichen mit Standardwerten) ist, wird das Cookie nicht gespeichert.

Einstellungen für die Einwilligungseinholung

reloadOnConsent: (boolean, Default ist false) – Sie können diesen Parameter auf true setzen, wenn Sie möchten, dass die Seite nach dem Einholen der Einwilligung neu geladen wird.

enableRemoteConsent: (boolean, Default ist false) – Sie können diesen Parameter auf true setzen, um eine Website-übergreifende Registrierung der Einwilligung zu ermöglichen (dies kann nützlich sein, wenn das Skript in mehr als einer Website desselben Netzwerks implementiert ist). Wenn Sie diesen Parameter auf true setzen, erzeugt unsere Lösung insbesondere ein technisches Cookie auf iubenda.com (Domain), das verwendet wird, wenn das Cookie auf der lokalen Domain nicht gefunden wird.

askConsentAtCookiePolicyUpdate:(boolean, Default ist false) – Sie können diesen Parameter auf true setzen, wenn Sie bei einer Aktualisierung der Cookie-Richtlinie eine neue Einwilligung anfordern möchten.

priorConsent: (boolean, Default ist true) – Ermöglicht die Sperrung von Skripten und ihre Reaktivierung erst nach Einholung der Einwilligung des Nutzers. Wenn false, werden die gesperrten Skripte immer reaktiviert, unabhängig davon, ob eine Einwilligung erteilt wurde oder nicht (nützlich zu Testzwecken oder wenn Sie lokal an Ihrem Projekt arbeiten und nicht wollen, dass die Seitenaufrufe (auf Englisch) gezählt werden).

Wir raten dringend davon ab, "priorConsent":false zu setzen, wenn Sie die Anforderungen der EU einhalten müssen. Bitte beachten Sie, dass, wenn die vorherige Blockierungseinstellung serverseitig deaktiviert wurde (über das Kontrollkästchen auf der Flow-Seite), dieser Parameter unwirksam ist, egal ob er auf true oder false false gesetzt ist.

countryDetection: (boolean, Default ist false) – Erlaubt es Ihnen, vorherige Blockierungs- und Einwilligungsanfragen für Cookies automatisch zu erkennen und einzuschränken, und zwar nur für Nutzer aus der EU – wo dies gesetzlich gefordert ist – während Cookie-Skripte normalerweise in Regionen ausgeführt werden, in denen Ihnen dies rechtlich noch erlaubt ist. Setzen Sie diesen Parameter auf true, wenn gdprAppliesGlobally auf false gesetzt ist und Sie das Land des Nutzers automatisch erkennen wollen. Wenn Sie diese Option deaktivieren, denken Sie daran,gdprApplies:false auf allen Seitenaufrufen zu setzen, bei denen die Einwilligung nicht verlangt wird.

Sie können das erkannte Land auch aufheben, indem die Variable_iub.cc bei iubenda_cs.js onload weitergegeben wird. Im Moment akzeptieren wir nur _iub.cc = 'EU'; (Europäische Union) und delete _iub.cc; (andere Länder) als _iub.cc mögliche Variabel-Werte. Zum Beispiel, wenn Sie EU forcieren wollen:

<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" onload="_iub.cc = 'EU';" async></script>

Sie können diese Funktion auf CodePen (auf Englisch) testen.

enableGdpr: (boolean, Default ist true) – Wenn true, werden Sie die DSGVO-Funktionalität in der Cookie Solution aktivieren/verfügbar machen (ohne sie tatsächlich anzuwenden).

gdprAppliesGlobally: (boolean, Default ist true) – Wenn true, wenden Sie den DSGVO-Schutz auf alle Nutzer an. Setzen Sie diesen Parameter auf false und countryDetection:true , um eine Einwilligung nur für Nutzer aus der EU zu beantragen. Denken Sie daran, dass Sie, wenn Sie in der EU ansässig sind, den DSGVO auch auf Nutzer aus Ländern außerhalb der EU anwenden müssen.

gdprApplies: (boolean, Default ist true) – Wenn false, wenden Sie den DSGVO-Schutz nicht auf den aktuellen Nutzer an und ihm wird das Cookie-Banner nicht angezeigt. Wenn Sie countryDetection:false gesetzt haben, sollten Sie gdprApplies:false auf allen Seitenaufrufen setzen, bei denen die Einwilligung nicht angefordert wird.

Unterstützung für den CCPA

enableCcpa: (boolean, Default ist false) – Wenn true, werden Sie die CCPA-Funktionalität in der Cookie Solution aktivieren/verfügbar machen (ohne sie tatsächlich anzuwenden).

ccpaApplies: (boolean, Default ist undefined) – Wenn true, gilt der CCPA-Schutz für den aktuellen Nutzer.

ccpaNoticeDisplay: (boolean, Default ist true) – Wenn false, werden Sie kein Banner anzeigen, um Nutzer über den CCPA zu informieren (nur wirksam, wenn der DSGVO nicht anwendbar ist).

ccpaAcknowledgeOnDisplay: (boolean, Default ist false) – Bei ccpaNoticeDisplay: true, können Sie angeben, was eine Kenntnisnahme des Hinweises darstellt: das einfache Laden des Hinweises (true) oder die eindeutige Interaktion nach dem Laden des Hinweises (false).

ccpaLspa: (boolean, Default ist undefined) – Hier können Sie angeben, ob die Transaktion im Rahmen des Limited Service Provider Agreement (LSPA) von IAB durchgeführt werden soll.

Klassen:

  • iubenda-ccpa-opt-out – Durch Hinzufügen dieser Klasse zu einem beliebigen Element der Seite löst der Klick auf das Element die Öffnung eines Dialogs aus, in dem der Nutzer seine Absicht bestätigen kann, den Verkauf seiner personenbezogenen Daten abzulehnen (Link: “Meine personenbezogenen Daten nicht verkaufen”).

Weitere optionale Parameter

Hier sind weitere optionale Parameter, die die Definition eines oder mehrerer Objekte erfordern:

footer {} (object)

  • btnCaption (string) – Text des Buttons (im unteren Teil des Fensters „Tracking-Einstellungen“, siehe „Per-Kategorie“ Einwilligung) , der zum Speichern der Einwilligungseinstellungen verwendet wird. Der Standardwert ist „Speichern und weiter“.

i18n {} (object) – Sie können die Texte jeder Cookie Solution-Komponente über die i18n JavaScript-Bibliothek übersetzen/bearbeiten. In dieser Demo auf CodePen (auf Englisch) finden Sie eine Liste aller Komponenten/Strings, die Sie bearbeiten und/oder lokalisieren können.

Wichtig: Falls Sie das Transparency and Consent Framework aktiviert haben, ist es notwendig die offiziellen Übersetzungen zu verwenden (siehe ” Definitionsliste der Verwendungszweck-Beschreibungen V2.0″), um die Mindestanforderungen an die Konfiguration des IAB zu erfüllen.

callback {} (object) – Dies ist der Parameter, mit dem Sie den Rückruf definieren können, den iubenda Cookie Solution für den Fall eines Events durchführen kann. Dazu gehören:

  • onReady (function) – Wenn die Einwilligung des Nutzers noch nicht verarbeitet wurde (z.B. weil es sich um den ersten Besuch handelt), wird der onReady-Rückruf aufgerufen, sobald das Banner-Cookie angezeigt wird. Im Gegensatz, wird falls der Nutzer bereits seine Einwilligung zur Installation von Cookies gegeben hat, dieser Rückruf ausgeführt. Dies geschieht, sobald die iubenda Cookie Solution initialisiert wird. Ob die Einwilligung vorliegt oder nicht, wird als Argument weitergegeben, das true oder false sein kann.

  • onBannerShown (function) – Mit dieser Funktion können Sie ein Skript ausführen, wenn das Banner angezeigt wird.

  • onBannerClosed (function) –Mit dieser Funktion können Sie ein Skript ausführen, wenn das Banner geschlossen ist.

  • onCookiePolicyShown (function) – Wird ausgeführt, wenn die Cookie-Richtlinie angezeigt wird (entweder in einem modalen Fenster oder auf einer separaten Seite).

  • onConsentGiven (function) – Dieser Rückruf wird ausgeführt, wenn der Nutzer die Einwilligung zur Cookie-Installation gegeben hat, sowohl bei der ersten Einwilligung als auch bei allen nachfolgenden Besuchen.

  • onConsentFirstGiven (function) – Es wird nur wenn der Nutzer zum ersten Mal seine Einwilligung gibt, ausgeführt. Als Argument wird eine der folgenden Strings weitergegeben: documentScroll, documentMoved, bannerXClose, documentClicked oder cookiePolicyClosed.

  • onConsentRejected (function) – Dieser Rückruf wird ausgeführt, wenn der Nutzer die Einwilligung zur Installation von Cookies abgelehnt hat.

  • onConsentFirstRejected (function) – Wird ausgeführt, sobald die Einwilligung abgelehnt wurde und der Nutzer seine Präferenz angibt (nicht bei jedem Seitenaufruf, wegen onConsentRejected).

  • onPreferenceExpressed (function) – Wird immer dann aufgerufen, wenn eine Präferenz angegeben wird, egal ob sie „Zustimmen“ oder „Ablehnen“ ist.

  • onPreferenceFirstExpressed (function) – Wird ausgeführt, sobald der Nutzer seine Präferenz angibt (nicht bei jedem Seitenaufruf, wie onPreferenceExpressed).

  • onPreferenceExpressedOrNotNeeded (function) – Sie wird immer dann aufgerufen, wenn eine Präferenz angegeben oder nicht benötigt wird, z.B. wenn:

    • gdprApplies:true und der Nutzer seine Präferenz angegeben hat, oder
    • gdprApplies:false, oder
    • gdprAppliesGlobally:false, countryDetection:true und der Nutzer seinen Sitz außerhalb der EU hat

  • onPreferenceNotNeeded (function) – Wird immer dann ausgeführt, wenn eine Präferenz nicht benötigt wird, zum Beispiel wenn:

    • gdprApplies:false, oder
    • gdprAppliesGlobally:false, countryDetection:true und der Nutzer seinen Sitz außerhalb der EU hat

  • onConsentRead (function) – Wird bei der ersten Einwilligung des Nutzers und bei jedem weiteren Laden ausgeführt, wenn die Einwilligung erkannt wird. Der Callback onConsentGiven wird zu einem Alias für onConsentRead, und er wird nicht ausgeführt, wenn letzteres definiert ist.

  • onStartupFailed (function) – Wird ausgeführt, wenn die iubenda Cookie Solution in der Startphase fehlschlägt. Eine Fehlermeldung wird als Argument weitergegeben.

  • onError (function) – Wird ausgeführt, wenn bei der iubenda Cookie Solution ein Fehler auftritt. Eine Fehlermeldung wird als Argument weitergegeben.

  • onFatalError (function) – Wird ausgeführt, wenn bei der iubenda Cookie Solution ein Fehler auftritt, der eine Weiterbearbeitung nicht zulässt. Eine Fehlermeldung wird als Argument weitergegeben.

  • onActivationDone (function) – Wird ausgeführt, wenn die Aktivierung des Snippets abgeschlossen ist.

  • onBeforePreload (function) – Wird ausgeführt, wenn die Cookie Solution vorher geladen wird, d.h. bevor die Cookies geladen werden.

  • onCcpaAcknowledged (function) – Wird ausgeführt, wenn der CCPA-Hinweis bestätigt wurde.

  • onCcpaFirstAcknowledged (function) – Wird bei der ersten Bestätigung des CCPA-Hinweises ausgeführt.

  • onCcpaOptOut (function) – Wird ausgeführt, wenn der Nutzer sich für den Opt-out vom Verkauf entschieden hat.

  • onCcpaFirstOptOut (function) – Wird ausgeführt, wenn der Nutzer sich zum ersten Mal für den Opt-out vom Verkauf entschieden hat.

Sehen Sie sich eine Beispielkonfiguration an ↓

preferenceCookie {} (object) – Dies ist der Parameter, mit dem Sie die Dauer des Präferenz-Cookies anpassen können, das iubenda im Browser des Nutzers installiert, um seine Einwilligung aufzuzeichnen. Insbesondere ist das zu definierende Objekt:

  • expireAfter (number, default 365) – expireAfter (Zahl, Voreinstellung 365) – Sie stellt die Anzahl der Tage dar, die die Einwilligung des Nutzers auf einer bestimmten Website gültig ist. Hinweis: Dieser Wert wird bei jedem nachfolgenden Besuch des Nutzers aktualisiert.

Beispiel-Konfiguration ansehen ↓

ccpaCookie {} (object) – ccpaCookie {} (Objekt) – Ermöglicht es Ihnen, das Verfallsdatum des Cookies anzupassen, das die Bestätigung der Benachrichtigung speichert. Insbesondere ist das zu definierende Objekt:

  • expireAfter (number, default 365) – Anzahl der Geltungstage.

Weitere Parameter für Entwickler

privacyPolicyUrl (string) –Ermöglicht es Ihnen, den Link zur Datenschutzerklärung anzupassen.

cookiePolicyUrl (string) – Dies ist die URL der Cookie-Richtlinie, die im Banner verlinkt ist. Sie finden sie auf der Bearbeitungsseite Ihrer Datenschutzerklärung auf der Registerkarte „Integration“. Wenn Sie diesen Parameter nicht definieren, bezieht er sich auf die Cookie-Richtlinie, die von iubenda generiert und auf unseren Servern gehostet wird. Sie können sich alternativ dazu entscheiden, die Cookie-Richtlinie auf einer Seite Ihrer Website zu hosten und so dieses Feld mit der entsprechenden URL auszufüllen. Denken Sie daran, dass, wenn Sie sich dafür entscheiden, die Cookie-Richtlinie auf Ihrer eigenen Seite zu hosten, diese Seite keine Cookies verwenden sollte, abgesehen von den technischen. Hinweis: Dieser Parameter ist unwirksam, wenn Sie ein benutzerdefiniertes HTML für das Banner verwenden (siehe die Konfiguration banner.html unten).

cookiePolicyInOtherWindow (boolean, Default ist false) – Wenn Sie diesen Parameter auf true setzen, öffnen sich die Datenschutzerklärung und die Cookie-Richtlinie in einem anderen Fenster anstelle des modalen iubenda-Fensters.

rebuildIframe (boolean, Default ist true) – Sobald die Einwilligung des Nutzers erfasst wurde, besteht das Standardverhalten der Cookie Solution darin, die zuvor modifizierten Iframes vollständig neu zu generieren (oder zu reintegrieren). Wenn dieser Parameter auf false gesetzt wird, werden die zuvor blockierten Iframes nach der Erfassung der Einwilligung wiederhergestellt.

inlineDelay (integer, Millisekunden, Default ist 500) – Die maximale Zeit zwischen den Aktivierungen von Snippets, die mit der Klasse _iub_cs_activate-inline getaggt sind (diese Snippets werden nacheinander aktiviert). Wenn Sie diesen Wert verringern, reduzieren Sie die Gesamtzeit der Aktivierung. Vorsicht: Der Standardwert ist so eingestellt, dass die Snippets einwandfrei funktionieren; eine Verringerung dieses Wertes kann die erfolgreiche Aktivierung einiger Snippets verhindern. Es wird dringend empfohlen, die Aktivierung des auf Ihrer Seite angezeigten Snippets zu überprüfen, wenn diese Einstellung geändert wird.

startOnDomReady (boolean, Default ist true) – Wenn das Banner-Rendering true ist und/oder die Aktivierung blockierter Snippets erfolgt, sobald der Dokumentstatus ‘geladen’ist (d.h. wenn das DOM den Status ‘geladen’ erreicht). Wenn die Option auf false, gesetzt ist, dann wird die Cookie Solution ausgeführt, sobald die Seite vollständig geladen ist (d.h. wenn der DOM-Status ‘abgeschlossen’ ist und alle auf der Seite enthaltenen Ressourcen geladen wurden).

timeoutLoadConfiguration (integer, Millisekunden, Default ist 30000) – Die Zeitspanne, die bei einer Fernkonfiguration gewartet werden muss, bevor eine Zeitüberschreitung gemeldet wird. Im Falle eines langsamen Netzwerks stellen Sie durch Erhöhen dieses Wertes sicher, dass die Cookie Solution die benötigten Ressourcen rechtzeitig erhält.

logLevel (string) – Definiert die Ausführlichkeit des Loggers (verfügbare Werte: ‘debug’, ‘info’, ‘warn’, ‘error’, ‘fatal’. Der Standardwert ist ‘nolog’).

logViaAlert (boolean, Default ist false) – Wenn Sie diesen Parameter auf true setzen, wird die Protokollierung per Alarm angezeigt.

Klassen

  • iubenda-cs-close-btn – Durch das Hinzufügen dieser Klasse zu einem beliebigen Element der Seite, schließt der Klick auf das Element dieses Banner und setzt voraus, dass die Einwilligung gegeben ist (vergleichbar mit dem Klick auf den X-Button des Banners).
  • iub-prevent-consent – Fügen Sie diese Klasse zu bestimmten Links/Buttons hinzu, um zu verhindern, dass beim Betätigen automatisch eine Einwilligung erteilt wird. Um effektiv zu sein, muss der Parameter consentOnLinkAndButton auf true gesetzt werden.
  • iubenda-cs-cookie-policy-lnk – Durch das Hinzufügen dieser Klasse zu einem beliebigen Element der Seite ermöglicht der Klick auf dieses Element die Anzeige der Cookie-Richtlinie (entspricht dem Klick auf den Link zur Cookie-Richtlinie). Hinweis: Um die korrekte Anzeige der Cookie-Richtlinie zu gewährleisten, darf die Klasse iubenda-cs-cookie-policy-lnk (die dem Link zur Cookie-Richtlinie im Banner zugeordnet ist) nicht an anderer Stelle auf der Seite verwendet werden.
  • iubenda-cs-preferences-link – Fügen Sie diese Klasse zu jedem Element der Seite hinzu, damit Nutzer ihre Cookie-Einstellungen auch nach dem Schließen des Cookie-Banners aktualisieren können.

Beispiele

Hier ist ein Beispiel für eine Konfiguration mit optionalen Parametern:

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "siteId": 896537, //use your siteId
        "cookiePolicyId": 8207462, //use your cookiePolicyId
        "enableRemoteConsent": "false",
        "consentOnScroll": "false",
        "banner": {
            "position": "top",
            "slideDown": "false",
            "content": "This website or its third-party tools use cookies. Please refer to the %{cookie_policy_link} if you want to learn more or withdraw your consent.",
            "cookiePolicyLinkCaption": "cookie policy",
            "backgroundColor": "#CCC",
            "textColor": "#000",
            "fontSize": "14px",
            "innerHtmlCloseBtn": "OK"
        },
        "callback": {
            "onPreferenceExpressed": function(preference) {
                console.log('onPreferenceExpressed', preference);
            }
        },
        "preferenceCookie": {
            "expireAfter": 180
        }
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Weitere Beispiele für mögliche Konfigurationen (auf Englisch):


Inline Aktivator

Es ist möglich, den Teil des Codes, der sich auf die Skripte bezieht, direkt auf der Seite einzufügen (inline); dieser Code wird als Inline-Aktivator bezeichnet. Skripte können durch den Inline-Aktivator aktiviert werden, auch wenn die Primärressource iubenda_cs.js generell nicht verfügbar oder fehlerhaft ist.

Der Inline-Aktivator garantiert nur die Skriptaktivierung, kann aber auch eine vorgegebene Berechtigung übernehmen (siehe folgende forceSafeActivation-Option). Er kann nicht verwendet werden, um das Banner oder die Cookie-Richtlinie anzuzeigen oder die Einholung der Einwilligung zu verwalten.

Sie dient lediglich als weitere Schutzebene im Falle von Fehlern und ist keinesfalls ein Ersatz für den eigentlichen Code der iubenda Cookie Solution.

Beachten Sie, dass der Inline-Aktivator nur onActivationDone ausführt, während andere ignoriert werden.

Für den Inline-Aktivator sind zwei zusätzliche Einstellungsmöglichkeiten verfügbar:

  • safeTimeout: (Millisekunden, Default ist 0) – Die Zeit, die der Inline-Aktivator wartet, bevor er anfängt zu laufen.
  • forceSafeActivation: (boolean, Default ist false) – Wenn auf true gesetzt, werden Skripte unabhängig von der erteilten Einwilligung aktiviert. Wenn auf false gesetzt, aktiviert der Inline-Aktivator die Skripte nur, wenn eine Einwilligung gegeben wurde (wie im Einstellungs-Cookie der Host-Domain gespeichert).

Der Inline-Aktivator ist erhältlich unter

IAB Transparency and Consent Framework

Wenn Sie die Kompatibilität mit dem IAB Transparency and Consent Framework (TCF) für die Anpassung der Werbetrackingeinstellungen aktiviert haben, können Sie den Inline-Aktivator sowohl für safe.js und safe-tcf-v2.js verwenden.

safe-tcf-v2.js ist verfügbar auf::

Beispiele

Der Inhalt von safe.js (und safe-tcf-v2.js) muss auf der Seite nach den ursprünglichen Konfigurationen und vor dem Code, der iubenda_cs.js lädt, eingefügt werden.

Aktuell

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
    _iub.csConfiguration.safeTimeout = 500; //custom option
    _iub.csConfiguration.forceSafeActivation = false; //custom option
</script>

<!-- inline activator - safe.js (current channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/safe.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Beispielkonfiguration mit aktiviertem IAB TCF v2.0:

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "enableCMP": true,
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/stub-v2.js"></script>

<!-- inline activator - safe.js (current channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/safe.js and paste here
    //]]>
</script>

<!-- inline activator - safe-tcf-v2.js (current channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/tcf/safe-tcf-v2.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

Beta

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
    _iub.csConfiguration.safeTimeout = 500; //custom option
    _iub.csConfiguration.forceSafeActivation = false; //custom option
</script>

<!-- inline activator - safe.js (beta channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/beta/safe.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script>

Beispielkonfiguration mit aktiviertem IAB TCF V2.0:

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "enableCMP": true,
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/beta/stub-v2.js"></script>

<!-- inline activator - safe.js (beta channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/beta/safe.js and paste here
    //]]>
</script>

<!-- inline activator - safe-tcf-v2.js (beta channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/tcf/beta/safe-tcf-v2.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script>

Stabil

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
    _iub.csConfiguration.safeTimeout = 500; //custom option
    _iub.csConfiguration.forceSafeActivation = false; //custom option
</script>

<!-- inline activator - safe.js (stable channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/stable/safe.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/stable/iubenda_cs.js" charset="UTF-8" async></script>

Beispielkonfiguration mit aktiviertem IAB TCF V2.0:

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "lang": "en",
        "enableCMP": true,
        "siteId": XXXXXX, //use your siteId
        "cookiePolicyId": YYYYYY, //use your cookiePolicyId
        "banner": {
            "position": "float-top-center",
            "acceptButtonDisplay": true,
            "customizeButtonDisplay": true
        }
    };
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/tcf/stable/stub-v2.js"></script>

<!-- inline activator - safe.js (stable channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/stable/safe.js and paste here
    //]]>
</script>

<!-- inline activator - safe-tcf-v2.js (stable channel) -->
<script type="text/javascript">
    //<![CDATA[
    //copy content from cdn.iubenda.com/cs/tcf/stable/safe-tcf-v2.js and paste here
    //]]>
</script>

<script type="text/javascript" src="//cdn.iubenda.com/cs/stable/iubenda_cs.js" charset="UTF-8" async></script>

Der Aktivierungscode ist ein integraler Bestandteil der iubenda Cookie Solution und kann als solcher modifiziert werden, um neue Funktionen, Upgrades und Korrekturen einzubauen.

Um die Verwaltung der Version des Aktivators auf Ihrer Seite zu erleichtern, gibt es die Variable _iub.csSafeActivatorVersion die die Version iubenda_cs.js aufruft, aus der der Aktivator stammt.


API

Die iubenda Cookie Solution verfügt über eine JS API für die einfache Handhabung einiger ihrer Hauptfunktionen.

Syntax: _iub.cs.api.METHOD_NAME

Die verfügbaren Methoden sind:

  • printErrors(): Druckt alle Fehler in der iubenda Cookie Solution auf der Browserkonsole aus

  • showCP(): Zeigt die Cookie-Richtlinie an (ähnlich wie wenn Sie auf den Link zur Cookie-Richtlinie im Banner oder wie hier beschrieben, auf einen anderen Link mit der Klasse iubenda-cs-cookie-policy-lnk klicken.

  • consentGiven(): Erteilt Einwilligungen. Die Methode akzeptiert folgende Parameter als optionale Parameter:

    • eventName: (string), eine der folgenden Optionen: documentClicked (default), documentScrolled, documentMoved, bannerXclose, cookiePolicyClosed; gibt an, wie die Einwilligung erteilt wird.
    • force: (boolean), true | false (Default): Wenn false, stellt iubenda CS sicher, dass das Banner gezeigt wird, bevor die Einwilligung tatsächlich eingeholt wird; stattdessen wird diese Option auf true, so dass die Einwilligung in jedem Fall erteilt wird.

      Hinweis: Der Einsatz dieser Methode setzt voraus, dass die erteilte Einwilligung völlig gleichwertig ist mit einer Einwilligung, die über die Benutzeroberfläche erteilt wird, z.B. durch Blättern. Daher werden alle der erteilten Einwilligung nachfolgenden Aktionen ausgeführt, einschließlich der Aktualisierung des Präferenz-Cookies, der Aktivierung der zuvor blockierten Snippets und des Rückrufs von onConsentFirstGiven und onConsentRead.

      Um ausschließlich Snippets zu aktivieren, verwenden Sie die MethodeactivateSnippets().

  • activateSnippets(): Aktiviert zuvor blockierte Snippets.
    Hinweis: Diese Methode kann wiederholt ausgeführt werden – bereits aktivierte Snippets werden nicht berücksichtigt. Sie ist daher in jenen Installationen nützlich, in denen nach Einholung der Einwilligung zuvor blockierte Inhalte, die nun aktiviert werden müssen, dynamisch in die Seite eingefügt werden (z.B. träges Laden oder unendliches Scrollen).

    Die Option runOnActivationDoneCallback (boolean, Default ist false)führt, wenn true, den onActivationDone-Rückruf nach Abschluss der Aktivierung des Snippets aus (siehe onActivationDone-Rückruf).

  • isConsentGiven()(DOMElement, Default window.document): zeigt true an, wenn die Einwilligung erteilt wurde, andernfalls wird false angezeigt.

    Anmerkung: Sie können diese Funktion nicht verwenden, wenn Sie banner.rejectButtonDisplay: true oder perPurposeConsent: true festgelegt haben. Wenn Sie das Transparency and Einwilligung Framework aktiviert haben, müssen Sie außerdem zwingend den synchronen Aktivator (safe-tcf-v2.js) hinzufügen.

  • setConsentOnScrollOnElement()(boolean): Durch den Aufruf dieser Methode wird das Element definiert, auf dem das Scrollen zum Zweck der Einwilligung überwacht wird.

    Anmerkung: Diese Methode ist nützlich, wenn Sie die consentOnScrollOnElement-Option, nutzen möchten, aber das DOM-Element noch nicht verfügbar ist, wenn die Cookie Solution initialisiert wird. In diesem Zusammenhang ist es möglich, den onBannerShow callback (Beispiel) (auf Englisch) zu verwenden, der bei der Initialisierung der CS auftritt.

  • storeConsent(): Speichert Einwilligungen in Cookies. Wenn Sie z.B. Einwilligungen von einem früheren Provider migrieren möchten,, könnten Sie diese Methode innerhalb des onBeforePreload ausführen, wenn die Einwilligung bereits von einer anderen Plattform erteilt wurde.

    Wenn Sie Anbieter sind, können Sie außerdem die Funktion storeConsent() nutzen, um unsere Lösung zu testen (siehe diese Demo auf CodePen).

  • gdprApplies() (boolean): Zeigt true an, wenn die DSGVO-Schutzmechanismen auf den aktuellen Nutzer angewendet werden, andernfalls wirdfalse angezeigt.

  • ccpaApplies() (boolean): zeigt true wenn der Schutz des CCPA für den aktuellen Nutzer gilt, andernfalls wird false angezeigt.

  • askCcpaOptOut(): Öffnet das Dialogfeld, um eine Bestätigung für den Opt-out vom Verkauf anzufordern.

  • isCcpaAcknowledged(): Zeigt an, ob die CCPA-Benachrichtigung bestätigt wurde.

  • isCcpaOptedOut(): Zeigt an, ob sich der Nutzer für den Opt-out vom Verkauf entschieden hat.

Anmerkung: Sie können API-Methoden für die Cookie Solution auch von einem Iframe aus ausführen (auf Englisch).

Sehen Sie auch