Wdrożenie CookieOfficer przez Google Tag Manager
Import szablonu, konfiguracja tagów i dlaczego tagi Google traktuje się inaczej niż pozostałe.
Wdrożenie banera przez Google Tag Manager nie wymaga bezpośredniego dostępu do kodu strony. Sprawdza się tam, gdzie modyfikacja serwisu jest utrudniona lub wydłużona przez współpracę z programistami. W tym przypadku baner dodajesz jako tag w GTM z gotowego szablonu.
Poniżej znajdziesz instrukcję krok po kroku, jak dodać szablon, skonfigurować tag CookieOfficer oraz jak uzależnić uruchamianie pozostałych narzędzi (tagów) od zgody użytkownika.
Wymagania wstępne
- Uprawnienia do publikacji w kontenerze Google Tag Manager.
- Identyfikator projektu. Znajdziesz go w panelu CookieOfficer, na stronie „Instalacja”, w zakładce Google Tag Manager.
- Stronę z certyfikatem SSL. Nasz skrypt ładuje się z szyfrowanego adresu, a przeglądarka zablokuje go na stronie bez certyfikatu.
Jak dodać szablon CookieOfficer do kontenera?
Szablon CookieOfficer możesz dodać w narzędziu Google Tag Manager na dwa sposoby.
Import pliku szablonu
- Znajdź plik
co-cmp.tplw paczce wdrożeniowej. - W Google Tag Managerze przejdź do Szablony > Szablony tagów > Nowy.
- Z menu w prawym górnym rogu wybierz import i wskaż plik.
- Zapisz szablon.
Szablon wgrany z pliku nie aktualizuje się automatycznie. Po wydaniu nowej wersji trzeba go wgrać ponownie.
Galeria szablonów społeczności
- W Google Tag Managerze przejdź do Szablony > Szablony tagów > Wyszukaj w galerii.
- Wpisz „CookieOfficer CMP” i wybierz szablon z listy.
- Kliknij „Dodaj do obszaru roboczego” i potwierdź uprawnienia.
Szablon dodany z galerii będzie aktualizował się automatycznie.
Szablon korzysta z czterech uprawnień: dostępu do stanu zgody, dostępu do wskazanych plików cookies, dostępu do pamięci lokalnej po wzorcu klucza oraz zgody na wstrzyknięcie skryptu z naszego adresu.
Jak utworzyć nowy tag CookieOfficer?
- Przejdź do Tagi > wybierz Nowy i jako typ zaznacz szablon CookieOfficer CMP.
- W polu na identyfikator projektu (Site ID) wklej identyfikator ze strony „Instalacja”. Resztę pól zostaw domyślnie.
- Jako regułę uruchamiania ustaw „Inicjowanie zgody - wszystkie strony”, po angielsku „Consent Initialization”.
- Zapisz tag i opublikuj kontener.
Weryfikacja: włącz tryb podglądu w Google Tag Managerze i otwórz stronę. Tag powinien uruchomić się w sekcji inicjowania zgody, baner ma się pokazać, a po określeniu decyzji na banerze, w warstwie danych zobaczysz aktualizację sygnałów zgody. Następnie wróć na stronę „Instalacja” i uruchom weryfikację strony skanem.
Jak uzależnić uruchamianie narzędzi wykorzystujących pliki cookies od zgody użytkownika?
Uruchamianie tagów w zależności od stanu zgody użytkownika zrobisz w GTM.
Tagi Google, czyli GA4, Google Ads i Floodlight. Zostaw bez dodatkowej zgody. Same obsługują Google Consent Mode i przy odmowie zgody przez użytkowników przechodzą w tryb bez plików cookies. W polu Zaawansowane > Dodatkowa zgoda zostaw „Nie ustawiono”. Dopisanie własnego wymagania wyłączy je całkowicie i zepsuje modelowanie konwersji.
Tagi spoza ekosytemu Google, na przykład Meta, HubSpot albo LinkedIn. Te nie są obsługiwane przez Google Consent Mode. W każdym z nich wejdź w Zaawansowane > Dodatkowa zgoda i wskaż ad_storage dla tagów marketingowych albo analytics_storage dla analitycznych. Dodatkowo możesz ustawić wyzwalacz na jednym ze zdarzeń, które wysyłamy do warstwy danych.
Zdarzenia w warstwie danych
| Zdarzenie | Kiedy jest uruchamiany |
|---|---|
cookie_consent_update | zawsze, gdy stan zgody zostanie określony, przy każdej zmianie oraz na każdej nowej odsłonie. |
cookie_consent_statistics | gdy użytkownik wyraził zgodę na wykorzystanie cookies z kategorii "Analityczne" |
cookie_consent_marketing | gdy użytkownik wyraził zgodę na wykorzystanie cookies z kategorii "Marketingowe" |
cookie_consent_preferences | gdy użytkownik wyraził zgodę na wykorzystanie cookies z kategorii "Funkcjonalne" |
W Google Tag Managerze utwórz wyzwalacz typu „Zdarzenie niestandardowe” o nazwie równej wybranemu zdarzeniu. Wysyłamy je na każdej odsłonie, także wtedy, gdy użytkownik wyraził zgodę wcześniej, więc wyzwalacz zadziała na kolejnych podstronach.
Kluczowe informacje:
- Zdarzenia działają niezależnie od Google Consent Mode, ponieważ jest to ogólny mechanizm Google Tag Managera. Możesz nimi wyzwalać dowolne tagi, nawet te, które nie korzystają z Consent Mode.
- Jeśli zdarzenie nie wystąpi, odpowiedni tag nie zostanie uruchomiony.
Uwaga na nazwy zdarzeń. Nazwy mogą być mylące, podobnie jak klucze data-co-cat. Kategoria analityczna daje statistics, a funkcjonalna daje preferences. Wyzwalacz oparty na cookie_consent_analytics nigdy się nie uruchomi, a Google Tag Manager nie zgłosi błędu.
Blokowanie skryptów w kodzie strony. Skrypty umieszczone bezpośrednio w kodzie strony, poza kontenerem, zablokujesz atrybutem data-co-cat w połączeniu z type="text/plain". Szczegóły znajdziesz w artykule Blokowanie automatyczne i manualne.
Częste błędy, których warto unikać
- Nie stosuj reguły „Wszystkie strony” („All Pages”) zamiast inicjowania zgody. Tag uruchomi się zbyt późno, więc część skryptów wystartuje przed decyzją użytkownika.
- Nie dodawaj dodatkowej zgody do tagów Google. W przypadku odmowy przestaną działać zamiast przejść w tryb bez plików cookies.
- Usuń skrypt instalacyjny CookieOfficer z kodu strony, jeśli wdrażasz go przez kontener. Druga kopia kodu wyłączy się automatycznie, ale pozostaną dwa miejsca do aktualizacji.
- Pamiętaj o publikacji kontenera. Zapisany tag w obszarze roboczym nie będzie działał na stronie.