Usercentrics-Banner, beantwortet bevor dein Agent die Seite sieht
Usercentrics ist das Standard-CMP deutscher Verlage und rendert seinen Dialog in einer Shadow-Root. Der Consent-Autopilot durchdringt sie, drückt den Ablehnen-Knopf oder ruft das SDK, und sammelt erst dann die Seite für deinen Agenten.
So arbeitet der Erkenner
| Erkannt an | Dem Host #usercentrics-root oder #uc-center-container oder der Test-Id uc-container |
|---|---|
| Ablehnen-Pfad | Der Alle-ablehnen-Knopf (data-testid uc-deny-all-button); UC_UI.denyAllConsents() als API-Weg |
| Akzeptieren-Pfad | Der Alle-akzeptieren-Knopf oder UC_UI.acceptAllConsents(); nur bei consent: accept |
| Shadow DOM | Der Dialog liegt in einer Shadow-Root; der Erkenner durchdringt Shadow-Bäume, bevor er irgendetwas anderes tut |
| Gilt als erledigt, wenn | Der erkannte Host von der Seite verschwunden ist |
| Wenn sich Signaturen ändern | Der Erkenner schaltet auf sicher, tut nichts, und die generische Heuristik ist dran |
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();
// Eine deutsche Nachrichtenseite mit Usercentrics.
await session.act({ steps: [{ action: 'navigate', value: 'https://www.verlag.example/' }] });
const page = await session.observe({ consent: 'reject' });
// Das Banner wurde beantwortet, bevor Kandidaten gesammelt wurden.
console.log(page.url, page.candidates.length);
Was Ablehnen hier tatsächlich heißt
Eine Ablehnung über den eigenen Weg des CMP, kein verstecktes Banner.
Das CMP speichert die Entscheidung
Der Ablehnen-Knopf und der SDK-Aufruf sind dieselben Aktionen, die eine Person ausführt. Usercentrics legt die Wahl in seinem eigenen Consent-Datensatz ab, sodass sich die Seite verhält wie bei einem Besucher, der abgelehnt hat.
Nichts wird per CSS versteckt
Das Overlay auszublenden, während die Einwilligung unbeantwortet bleibt, ließe Skripte auf eine Entscheidung warten. Der Autopilot antwortet und prüft dann, ob das Host-Element wirklich weg ist.
Versionsdrift fällt auf sicher
Usercentrics benennt Test-Ids über Versionen um. Ein Selektor, der nicht mehr passt, heißt: Der Erkenner feuert nicht; die Rückfall-Heuristik sucht einen Ablehnen-Knopf per Text, und findet sie keinen, bleibt das Banner und observe meldet es.
Fragen von Entwicklern
Muss ich für Usercentrics irgendetwas schreiben?
Nein. consent ist eine Option von observe und steht standardmäßig auf reject. Der Erkenner läuft einmal pro Seitenladen, bevor Kandidaten gesammelt werden, sodass deine Anweisungen Cookies nie erwähnen.
Was, wenn die Seite sich verhalten soll, als wäre eingewilligt worden?
Übergib consent: accept. Das ist ein ausdrückliches Opt-in, nie implizit, weil eine Einwilligung im Namen von jemandem eine Entscheidung ist, die dein Code sichtbar treffen sollte.
Kann ich das Banner in Ruhe lassen und selbst behandeln?
Ja, consent: off. Sinnvoll, wenn das Banner das ist, was du testest, oder wenn deine eigenen Workflow-Schritte den Dialog steuern.
Ist die Consent-Wahl hinterher sichtbar?
Das observe-Ergebnis zeigt die Seite nach der Antwort auf das Banner, und das Aktionsprotokoll der Session hält das observe fest. Ob Usercentrics selbst die Wahl protokolliert hat, ist Sache des CMP, und es tut das wie bei jedem Besucher.
Auf einer Seite ansehen, die du automatisierst
Fünf Browserstunden, keine Karte. Eine Usercentrics-Seite öffnen und observe aufrufen.