Zum Hauptinhalt springen

CMP-Integrationsleitfaden

Binden Sie das SiteGuardian-Cookie-Banner in Ihre Website ein. Wählen Sie unten Ihre Plattform.

HTML / Beliebige Website

Fügen Sie dieses Script-Tag vor dem schließenden </head> Tag Ihres HTML ein:

<script src="https://cmp.siteguardian.io/v1/widget.js" data-site-id="YOUR_SITE_ID" async></script>

Ersetzen Sie YOUR_SITE_ID durch Ihre Site-ID aus den CMP-Einstellungen in Ihrem Monitor-Dashboard.

JavaScript-API

Das Widget stellt eine stabile JavaScript-API für den programmatischen Zugriff auf Einwilligungen bereit. Nutzen Sie ereignisgesteuerte Muster, da das Widget asynchron geladen wird.

Auf CMP-Bereitschaft warten

document.addEventListener('sg:ready', () => { // CMP loaded and consent state resolved const consent = SiteGuardianCMP.getConsent(); // consent = { categories_accepted: [...], action: "accept_all", ... } or null });

Einwilligung für eine Kategorie prüfen

if (window.SiteGuardianCMP) { const hasAnalytics = SiteGuardianCMP.hasConsented('analytics'); // true/false }

Auf Änderungen der Einwilligung reagieren

document.addEventListener('sg:consent', (e) => { console.log('Accepted:', e.detail.categories_accepted); console.log('Rejected:', e.detail.categories_rejected); console.log('Action:', e.detail.action); // accept_all, reject_all, custom });

Callback-API

SiteGuardianCMP.onConsent(function(consent) { // Fires every time the user makes a consent decision if (consent.categories_accepted.includes('analytics')) { // Load analytics } });

Hinweis: Der primäre Integrationspfad ist das Ereignis sg:consent. Direkte API-Aufrufe (SiteGuardianCMP.getConsent()) setzen zuerst das Ereignis sg:ready oder eine window.SiteGuardianCMP-Prüfung voraus, da das Widget asynchron geladen wird.

Google Consent Mode v2 PRO+

Wenn aktiviert (PRO+-Pläne), integriert sich das Widget automatisch mit Google Consent Mode v2. Es setzt beim Seitenaufruf den Standardzustand auf „denied“ und aktualisiert die Consent-Signale, sobald der Nutzer eine Entscheidung trifft.

Unterstützte Signale:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Keine zusätzliche Konfiguration erforderlich. Aktivieren Sie Google Consent Mode in Ihren CMP-Einstellungen — den Rest erledigt das Widget.