Preise Partner werden Kontakt
NL FR DE
Entwickler

Entwicklerdokumentation

Integrieren Sie CookieOpt mit unserer API und dem JavaScript-SDK in Ihre Website oder Anwendung.

Installation

Fügen Sie das CookieOpt-Skript direkt vor dem schließenden </head>-Tag Ihrer Website ein und ersetzen Sie JOUW_API_KEY durch den API-Schlüssel Ihrer Website aus dem Dashboard:

<script src="https://www.cookieopt.com/embed/banner.js" data-api-key="JOUW_API_KEY"></script>

Das Skript lädt den Cookie-Banner, wendet Google Consent Mode v2 an und stellt die JavaScript-API über window.CookieOpt bereit. Binden Sie das Skript vor Google Tag Manager oder Google Analytics ein, damit die Consent-Standardwerte zuerst gesetzt werden.

Prüfen Sie die Wahl des Besuchers, bevor Sie selbst Cookies setzen. Die Kategorien sind functional (immer erlaubt), preferences, analytics und marketing:

if (window.CookieOpt.hasConsent('analytics')) {
  // statistieken laden
}

var consent = window.CookieOpt.getConsent();
// { functional: true, preferences: false, analytics: true, marketing: false }

Events

Reagieren Sie auf die Wahl des Besuchers mit einem Callback oder mit dem DOM-Event. Der Callback wird sofort aufgerufen, wenn der Consent bereits bekannt ist (wiederkehrender Besucher), sonst sobald der Besucher wählt:

window.CookieOpt.onConsentReady(function (consent, type) {
  // type: accept_all, reject_all, custom of existing
  if (consent.marketing) {
    // marketingscripts laden
  }
});

window.addEventListener('CookieOptOnConsentReady', function (e) {
  console.log(e.detail.consent, e.detail.type);
});

API

Methode oder PropertyBeschreibung
CookieOpt.consentAktueller Consent-Status pro Kategorie.
CookieOpt.consentReadytrue, sobald der Consent geladen oder erteilt wurde.
CookieOpt.consentTypeArt der Wahl: accept_all, reject_all, custom oder existing.
CookieOpt.getConsent()Gibt eine Kopie des Consent-Objekts zurück.
CookieOpt.hasConsent(categorie)Gibt true oder false für eine Kategorie zurück.
CookieOpt.onConsentReady(fn)Registriert einen Callback, der aufgerufen wird, sobald der Consent bekannt ist.

Cookie-Erklärung

CookieOpt erstellt automatisch eine Cookie-Erklärung für Ihre Website, die nach jedem Scan aktualisiert wird. Verlinken Sie sie aus Ihrer Datenschutzerklärung:

https://www.cookieopt.com/cookie-declaration/JOUW_API_KEY

Die vollständige Entwicklerdokumentation mit Beispielen für Google Consent Mode v2, das Speichern des Consents in Ihrer eigenen Datenbank und den Umstieg von Cookiebot finden Sie unter cookieopt.com/developer.