Ir al contenido principal

Guía de integración de la CMP

Añade el banner de consentimiento de cookies de SiteGuardian a tu sitio web. Elige tu plataforma a continuación.

HTML / Cualquier sitio web

Añade esta etiqueta de script antes de la etiqueta de cierre </head> de tu HTML:

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

Sustituye YOUR_SITE_ID por el ID de tu sitio de la configuración de la CMP en tu panel de Monitor.

API de JavaScript

El widget expone una API de JavaScript estable para el acceso programático al consentimiento. Utiliza patrones basados en eventos, ya que el widget se carga de forma asíncrona.

Esperar a que la CMP esté lista

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

Comprobar el consentimiento de una categoría

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

Reaccionar a los cambios de consentimiento

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 callback

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

Nota: La vía de integración principal es el evento sg:consent. Las llamadas directas a la API (SiteGuardianCMP.getConsent()) requieren primero el evento sg:ready, o una comprobación con window.SiteGuardianCMP, ya que el widget se carga de forma asíncrona.

Google Consent Mode v2 PRO+

Cuando está activado (planes PRO+), el widget se integra automáticamente con Google Consent Mode v2. Establece el estado denegado por defecto al cargar la página y actualiza las señales de consentimiento cuando el usuario toma una decisión.

Señales admitidas:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

No se necesita configuración adicional. Activa Google Consent Mode en la configuración de tu CMP y el widget se encarga del resto.