Dokumentation

Einbindung in 5 Minuten

1. Snippet

Das Snippet bekommst du nach dem Anlegen einer Property unter Property → Einbindung. Es sieht so aus:

<script src="https://consented.eu/sdk/dist/stub.js"
        data-block="googletagmanager.com/gtag|connect.facebook.net"></script>
<script async src="https://consented.eu/p/DEINE-PROPERTY-ID/cmp.js"></script>

Die erste Zeile ist der Stub: unter 1 KB, synchron, und muss vor jedem anderen Skript stehen. Er blockiert die in data-block genannten Muster sofort und setzt die Consent-Mode-Standardwerte.

2. Skripte blockieren

Deklarativ — für Skripte, die du selbst einbindest:

<script type="text/plain" data-consented="google-analytics-4">
  gtag('config', 'G-XXXXXXX');
</script>

Musterbasiert — für Skripte, die andere einbinden:

Trage bei jedem Dienst URL-Fragmente ein (z. B. googletagmanager.com/gtag). Ein MutationObserver entfernt das src-Attribut, bevor der Browser die Datei lädt, und setzt es nach der Einwilligung wieder.

3. JavaScript-API
// Warten, bis der Zustand bekannt ist
Consented.ready(function (state) {
  if (state && state.services['google-analytics-4']) { startTracking(); }
});

// Auf Änderungen reagieren
Consented.on('change', function (state) { console.log(state); });

// Detailansicht öffnen — oder einfach data-consented-open ans Element
Consented.openSettings();

// Nachweisführung
Consented.getConsentId();
4. dataLayer-Ereignisse
EreignisWann
consented_readyRuntime geladen, Zustand bekannt
consented_updateNach jeder Entscheidung des Besuchers
Betroffenenrechte

Jede Einwilligung bekommt eine ID, die dem Besucher in der Detailansicht angezeigt wird. Damit kann er ohne Konto Auskunft verlangen oder löschen lassen:

GET    /api/v1/consent/{consentId}
DELETE /api/v1/consent/{consentId}

Oder komfortabel über die öffentliche Abfrageseite.