Aller au contenu principal

Guide d'intégration de la CMP

Ajoutez la bannière de consentement aux cookies SiteGuardian à votre site web. Choisissez votre plateforme ci-dessous.

HTML / tout site web

Ajoutez cette balise script avant la fermeture </head> de votre HTML :

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

Remplacez YOUR_SITE_ID par l'identifiant de site issu des paramètres CMP de votre tableau de bord Monitor.

API JavaScript

Le widget expose une API JavaScript stable pour un accès programmatique au consentement. Utilisez une approche événementielle, car le widget se charge de manière asynchrone.

Attendre que la CMP soit prête

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

Vérifier le consentement pour une catégorie

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

Réagir aux changements de consentement

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 de rappel

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

Remarque : La voie d'intégration privilégiée est l'événement sg:consent. Les appels directs à l'API (SiteGuardianCMP.getConsent()) nécessitent d'abord l'événement sg:ready ou une vérification window.SiteGuardianCMP, car le widget se charge de manière asynchrone.

Google Consent Mode v2 PRO+

Lorsqu'il est activé (plans PRO+), le widget s'intègre automatiquement à Google Consent Mode v2. Il applique un état refusé par défaut au chargement de la page et met à jour les signaux de consentement dès que l'utilisateur fait un choix.

Signaux pris en charge :

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Aucune configuration supplémentaire nécessaire. Activez Google Consent Mode dans les paramètres de votre CMP, et le widget s'occupe du reste.