Vai al contenuto principale

Guida all'integrazione della CMP

Aggiungi il banner di consenso ai cookie di SiteGuardian al tuo sito web. Scegli la tua piattaforma qui sotto.

HTML / Qualsiasi sito web

Aggiungi questo tag script prima del tag di chiusura </head> del tuo HTML:

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

Sostituisci YOUR_SITE_ID con l'ID del tuo sito, disponibile nelle impostazioni CMP della dashboard Monitor.

API JavaScript

Il widget espone un'API JavaScript stabile per l'accesso programmatico al consenso. Usa pattern event-driven poiché il widget viene caricato in modo asincrono.

Attendi che la CMP sia pronta

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

Verifica il consenso per una categoria

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

Reagisci alle modifiche del consenso

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

API di callback

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

Nota: Il percorso di integrazione principale è l'evento sg:consent. Le chiamate API dirette (SiteGuardianCMP.getConsent()) richiedono prima l'evento sg:ready o una guardia window.SiteGuardianCMP, poiché il widget viene caricato in modo asincrono.

Google Consent Mode v2 PRO+

Quando è abilitato (piani PRO+), il widget si integra automaticamente con Google Consent Mode v2. Imposta lo stato predefinito su denied al caricamento della pagina e aggiorna i segnali di consenso quando l'utente effettua una scelta.

Segnali supportati:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Non è necessaria alcuna configurazione aggiuntiva. Attiva Google Consent Mode nelle impostazioni della tua CMP e il widget farà il resto.