Zum Inhalt springen
Cookie-Banner

Cookiebot-Dialoge, abgelehnt wie ein Besucher sie ablehnen würde

Cookiebot ist auf mittelgroßen europäischen Seiten verbreitet und bietet eine JavaScript-API. Der Autopilot nutzt den Ablehnen-Knopf, wenn er da ist, sonst die API, und behandelt einen noch sichtbaren Dialog als unbeantwortet.

Was auf einer Cookiebot-Seite passiert

Innerhalb eines einzigen observe-Aufrufs, bevor ein Kandidat gesammelt wird.

  1. Erkennen

    Der Dialog wird am Host #CybotCookiebotDialog erkannt. Kein Host, kein Erkenner: Die Seite wird wie jede andere behandelt.

  2. Ablehnen

    Der Ablehnen-Knopf (CybotCookiebotDialogBodyButtonDecline oder die Alle-ablehnen-Variante der Stufenauswahl) wird gedrückt. Gelingt das nicht, lehnt Cookiebot.submitCustomConsent(false, false, false) Präferenzen, Statistik und Marketing über das SDK ab.

  3. Bestätigen

    Der Host muss verschwinden, damit die Aktion zählt. Ein Dialog, der noch da ist, bedeutet: observe meldet ein unbeantwortetes Banner, statt so zu tun als ob.

  4. Sammeln

    Erst jetzt werden die interaktiven Elemente der Seite für deinen Agenten eingesammelt, sodass eine Kandidatenliste nie die Knöpfe des Banners enthält.

Fakten zum Erkenner

Erkannt an #CybotCookiebotDialog
Ablehnen-Pfad Ablehnen-Knopf; API-Rückfall submitCustomConsent(false, false, false)
Akzeptieren-Pfad Alle-erlauben-Knopf oder submitCustomConsent(true, true, true), nur bei consent: accept
Kategorien Präferenzen, Statistik, Marketing, in dieser Reihenfolge im API-Aufruf
Rückfall Passt die Signatur nicht, bleibt der Erkenner still und die Heuristik läuft
Kosten Keine Inferenz; der Erkenner ist eine feste Tabelle im Browser-Bundle

Stand: 2026-09-04

Das Banner als Teil von observe ablehnen

import { Browserberg } from '@browserberg/sdk';

const bb = new Browserberg({
  apiKey: process.env.BROWSERBERG_API_KEY,
  baseUrl: 'https://browserberg.com',
});

const session = await bb.sessions.create();

// Ein Shop mit Cookiebot.
await session.act({ steps: [{ action: 'navigate', value: 'https://shop.example.eu/' }] });
const page = await session.observe({ consent: 'reject' });

// Das Banner wurde beantwortet, bevor Kandidaten gesammelt wurden.
console.log(page.url, page.candidates.length);

Fragen von Entwicklern

Warum überhaupt die API rufen, wenn es einen Knopf gibt?

Manche Cookiebot-Layouts verstecken den Ablehnen-Knopf hinter einer Detailansicht. Der API-Weg erreicht denselben Consent-Datensatz, ohne den Dialog zu durchlaufen, und wird nur versucht, wenn der Knopf fehlt.

Bleibt die Wahl über Seiten hinweg in der Session erhalten?

Cookiebot speichert sie im eigenen Cookie, sodass spätere Seiten derselben Session ohne Dialog laden. Eine neue Session ist ein Erstbesuch, der Dialog kommt zurück, und der Erkenner beantwortet ihn erneut.

Was liefert observe, wenn sich der Dialog nicht schließen lässt?

Die Seite, wie sie ist, mit dem Banner, und einen Hinweis in der Antwort. Es wird nicht geraten, dass das Banner weg sei.

Funktioniert das in einem iframe?

Cookiebot rendert im Hauptdokument. Banner, die andere CMPs in iframes rendern, fallen an die generische Heuristik, die in Frames gleicher Herkunft nachsieht.

Auf einer Cookiebot-Seite ausprobieren

Fünf Browserstunden, keine Karte. Ein observe-Aufruf ist die ganze Integration.