Przejdź do głównej treści

Przewodnik integracji CMP

Dodaj baner zgody na pliki cookie SiteGuardian do swojej strony. Wybierz platformę poniżej.

HTML / dowolna strona

Dodaj ten tag script przed zamykającym </head> tagiem swojego HTML:

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

Zastąp YOUR_SITE_ID identyfikatorem swojej strony z ustawień CMP w panelu monitora.

API JavaScript

Widget udostępnia stabilne API JavaScript do programowego dostępu do zgód. Stosuj wzorce sterowane zdarzeniami, ponieważ widget ładuje się asynchronicznie.

Poczekaj, aż CMP będzie gotowe

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

Sprawdź zgodę dla kategorii

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

Reaguj na zmiany zgody

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 callback

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

Uwaga: Główną ścieżką integracji jest zdarzenie sg:consent. Bezpośrednie wywołania API (SiteGuardianCMP.getConsent()) wymagają wcześniej zdarzenia sg:ready lub zabezpieczenia window.SiteGuardianCMP, ponieważ widget ładuje się asynchronicznie.

Google Consent Mode v2 PRO+

Po włączeniu (plany PRO+) widget automatycznie integruje się z Google Consent Mode v2. Ustawia domyślny stan denied przy ładowaniu strony i aktualizuje sygnały zgody, gdy użytkownik dokona wyboru.

Obsługiwane sygnały:

  • analytics_storage
  • ad_storage
  • ad_user_data
  • ad_personalization

Nie jest wymagana dodatkowa konfiguracja. Włącz Google Consent Mode w ustawieniach CMP, a widget zajmie się resztą.