Ir para o conteúdo principal

Guia de Integração da CMP

Adicione o banner de consentimento de cookies SiteGuardian ao seu site. Escolha a sua plataforma abaixo.

HTML / Qualquer site

Adicione esta tag de script antes do fecho da </head> tag do seu HTML:

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

Substitua YOUR_SITE_ID pelo ID do seu site nas definições da CMP no painel do monitor.

API JavaScript

O widget expõe uma API JavaScript estável para acesso programático ao consentimento. Utilize padrões orientados a eventos, uma vez que o widget é carregado de forma assíncrona.

Aguardar que a CMP esteja pronta

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

Verificar o consentimento para uma categoria

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

Reagir a alterações de consentimento

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: O caminho principal de integração é o evento sg:consent. As chamadas diretas à API (SiteGuardianCMP.getConsent()) requerem primeiro o evento sg:ready ou uma verificação a window.SiteGuardianCMP, uma vez que o widget é carregado de forma assíncrona.

Google Consent Mode v2 PRO+

Quando ativado (planos PRO+), o widget integra-se automaticamente com o Google Consent Mode v2. Define o estado predefinido como recusado no carregamento da página e atualiza os sinais de consentimento quando o utilizador faz uma escolha.

Sinais suportados:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Não é necessária configuração adicional. Ative o Google Consent Mode nas definições da CMP e o widget trata do resto.