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.
-
Erkennen
Der Dialog wird am Host #CybotCookiebotDialog erkannt. Kein Host, kein Erkenner: Die Seite wird wie jede andere behandelt.
-
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.
-
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.
-
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.