Naar hoofdinhoud

CMP-integratiehandleiding

Voeg de SiteGuardian cookie-consent banner toe aan je website. Kies hieronder je platform.

HTML / elke website

Voeg deze script-tag toe vóór de afsluitende </head> tag van je HTML:

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

Vervang YOUR_SITE_ID door je site-ID uit de CMP-instellingen in je monitor-dashboard.

JavaScript-API

De widget biedt een stabiele JavaScript-API voor programmatische toegang tot toestemming. Gebruik event-gedreven patronen, aangezien de widget asynchroon laadt.

Wacht tot de CMP gereed is

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

Controleer de toestemming voor een categorie

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

Reageer op wijzigingen in toestemming

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 } });

Let op: Het primaire integratiepad is het sg:consent-event. Directe API-aanroepen (SiteGuardianCMP.getConsent()) vereisen eerst het sg:ready-event of een window.SiteGuardianCMP-guard, omdat de widget asynchroon laadt.

Google Consent Mode v2 PRO+

Wanneer ingeschakeld (PRO+-abonnementen) integreert de widget automatisch met Google Consent Mode v2. Bij het laden van de pagina wordt de standaardstatus op denied gezet en worden de consent-signalen bijgewerkt zodra de gebruiker een keuze maakt.

Ondersteunde signalen:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Geen aanvullende configuratie nodig. Schakel Google Consent Mode in bij je CMP-instellingen en de widget regelt de rest.