Integracja zewnętrznej planszy RODO

Dokument ten opisuje sposób integracji własnej planszy RODO z naszym Pixelem, aby umożliwić emisję specjalnych formatów reklamowych.

📘

Integracja przedstawiona na poniższej stronie nie jest wymagana dla większości Partnerów. Jeśli w Twoim przypadku będziemy potrzebować opisanej tu integracji, powiadomimy Cię o tym fakcie.

Czego dotyczy ten dokument?

Format reklamowy Welcome Screen to pełnoekranowa reklama wyświetlana przy wejściu użytkownika na stronę. Aby nie nachodzić na modal zgody (CMP), reklama czeka na sygnał, że interakcja z CMP dobiegła końca — niezależnie od tego, czy modal faktycznie się pojawił.

Sygnałem tym jest zdarzenie aktualizacji zgody zgodne z Google Consent Mode v2 — standard wspierany przez większość nowoczesnych platform CMP.

Wymaganie

Twój CMP musi wysyłać aktualizację stanu zgody przez gtag po każdym zakończeniu interakcji z modalem (lub gdy modal nie jest wyświetlany):

gtag('consent', 'update', {
    'ad_storage': 'granted',        // lub 'denied'
    'ad_user_data': 'granted',      // lub 'denied'
    'ad_personalization': 'granted' // lub 'denied'
    // ... pozostałe typy zgody
});

Wartości poszczególnych typów zgody nie mają znaczenia dla wyświetlenia reklamy — liczy się sam fakt wysłania zdarzenia, który sygnalizuje zakończenie obsługi CMP.

Co musisz zrobić

Musisz zapewnić, że Twój serwis wysyła zdarzenie gtag('consent', 'update', ...) po każdym zakończeniu obsługi CMP. Są dwa sposoby:

Opcja A — konfiguracja planszy CMP (zalecane)

Sprawdź dokumentację swojego dostawcy CMP pod hasłem „Google Consent Mode" lub „Consent Mode v2" — większość platform udostępnia gotową integrację lub dedykowany plugin. Włączenie jej po stronie konfiguracji CMP nie wymaga zmian w kodzie serwisu.

Opcja B — ręczny handler w kodzie serwisu

Jeśli konfiguracja CMP nie wchodzi w grę, dodaj wywołanie gtag bezpośrednio w callbacku swojego CMP:

// Wywołaj po każdym zakończeniu interakcji z CMP:
// akceptacja, odrzucenie, zamknięcie modala,
// a także gdy modal nie jest wyświetlany (zgoda już zapisana, poza jurysdykcją RODO itp.)
yourCmp.onFinished(function (decision) {
    gtag('consent', 'update', {
        'ad_storage': decision.adStorageGranted ? 'granted' : 'denied'
        // pozostałe typy zgody zgodnie z decyzją użytkownika
    });
});

Dokładna nazwa callbacku i struktura obiektu decyzji zależy od Twojego dostawcy CMP — sprawdź jego dokumentację.

🚧

Wywołanie musi nastąpić we wszystkich ścieżkach kończących CMP — w tym gdy modal w ogóle się nie pojawia. Brak wywołania zablokuje wyświetlenie Welcome Screen dla tych użytkowników na czas nieokreślony.

Weryfikacja integracji

Weryfikację przeprowadź w zakładce Console w DevTools — sprawdź, czy po zakończeniu obsługi CMP zdarzenie consent update jest obecne w dataLayer.

Scenariusz 1 — pełny flow CMP (wyczyszczona pamięć podręczna)

Otwórz stronę w trybie incognito lub wyczyść localStorage i cookies, przejdź przez modal CMP, a następnie wykonaj:

window.dataLayer?.filter(e => e[0] === 'consent' && e[1] === 'update')
// Oczekiwany wynik: tablica z co najmniej jednym wpisem

Scenariusz 2 — zgoda już zapisana (modal pominięty)

Otwórz stronę z istniejącą zgodą w localStorage/cookies (modal nie powinien się pojawić), a następnie wykonaj to samo polecenie:

window.dataLayer?.filter(e => e[0] === 'consent' && e[1] === 'update')
// Oczekiwany wynik: tablica z co najmniej jednym wpisem — zdarzenie musi być wysłane nawet bez wyświetlenia modala