Google Analytics Debugger – jak debugować GA4, DebugView i tagi w Google Tag Managerze

Wdrażanie narzędzi analitycznych i skryptów śledzących bez ich dokładnej weryfikacji jest jednym z podstawowych błędów popełnianym często przez doświadczonych marketerów i analityków.

Z poniższego artykułu dowiesz się jak weryfikować zdarzenia, wykorzystując Tag Assistant dla GTM, zaawansowane rozszerzenia przeglądarki Chrome oraz narzędzia deweloperskie. Opanujesz zaawansowane debugowanie wdrożenia GA4 i pixeli reklamowych, co pozwoli Ci wyeliminować błędy pomiarowe, zapewnić technologiczną spójność z polityką prywatności, a przede wszystkim nakarmić algorytmy reklamowe dobrymi jakościowo danymi.

Dla kogo jest ten artykuł i jaką wiedzę powinieneś posiadać przed zapoznaniem się z nim?

Przede wszystkim powinieneś znać podstawowe pojęcia techniczne związane z użyciem narzędzi Google takich jak GA4 czy GTM. Niezbędna do zrozumienia poniższego artykułu jest znajomość definicji tagów, zdarzeń, warstwy danych, zmiennych i triggerów (wyzwalaczy).

Dlaczego debugowanie tagów Google Analytics i pixeli reklamowych ma znaczenie

• Wyeliminowanie braków w danych – błędy w konfiguracji warstwy danych (nazywanej w branży dataLayer lub po prostu DL) często skutkują gubieniem kluczowych parametrów GA4. Jeśli z Twojego zdarzenia zakupowego zniknie pole value (wartość zamówienia), to GA4 i często pixele reklamowe nie zarejestrują wartości transakcji, co całkowicie zrujnuje Twoje raporty przychodowe i performance kampanii.
• Zgodność z Consent Mode V2 – debugowanie pozwala upewnić się, że Twoje tagi respektują wybory użytkownika dotyczące plików cookie. Weryfikacja sygnałów zgody bezpośrednio w zdarzeniach gwarantuje spójność z polityką prywatności a działaniem skryptów. Chroni to organizację przed ewentualnymi karami ze strony UODO. Brak sygnałów o zgodach będzie skutkował blokadą remarketingu GAds, a także cięciem sesji w Clarity i upośledzeniem działania Bing Ads.
• Ochrona przed duplikacją zdarzeń – powielona integracja (np. dwie wtyczki implementujące GA4 w panelu sklepu), czy podwójne wywołanie zdarzenia w warstwie danych często prowadzi do sztucznego zawyżania wyników. Diagnostyka natychmiast obnaża takie podwójne odpalenia, które w przeciwnym razie sztucznie pompowałyby statystyki.
• Pełny obraz lejka sprzedażowego – narzędzia debugujące pomagają zweryfikować zdarzenia e-commerce na każdym etapie, od wejścia na kartę produktu, przez dodanie do koszyka, aż po zakup. Dzięki zdebugowaniu ścieżki do zakupu możemy nauczyć się jak działają poszczególne zdarzenia, w jakim momencie się wyzwalają i jakie informacje są w nich zawarte. Zdobyta wiedza pozwoli lepiej budować i interpretować raporty lejka w GA4.

Google Tag Assistant i DebugView w Google Analytics 4 – główne narzędzia debugowania

Aby debugowanie było w ogóle możliwe i miarodajne, musisz zrozumieć współpracę poszczególnych narzędzi.

• Rozszerzenie Tag Assistant – pozwala wstępnie określić czy i jakie tagi Google znajdują się na stronie. Dzięki niemu możemy znaleźć identyfikatory usług GA4 faktycznie znajdujących się na witrynie, a także znaleźć ID kontenera GTM. Będzie to przydatne, gdy do danego konta Google często jest przypisanych kilka usług.

• Tryb podglądu GTM (Preview Mode) – pozwala on na podejrzenie jakie tagi obecne w Twoim kontenerze są wyzwalane, a także jakie sygnały trafiają do tagów Google (takich jak np. tag AW czy GA4). Do właściwego podglądu możemy przejść zarówno z rozszerzenia Tag Assistant, jak i bezpośrednio z GTM. Warto pamiętać, że możemy debugować informacje odczytywane przez GTM jedynie mając dostęp do niego. W przeciwnym razie możemy podejrzeć tylko to co wysyła GA4, GAds czy pixele reklamowe. W celu wejścia w debuger musimy przejść do interesującego nas konta, następnie odszukać przycisk podglądu (prawy górny róg) i przejść z jego pomocą do nowego okna, w którym wpisujemy URL witryny powiązanej z kontenerem GTM.

💡 Cenna wskazówka

Zbyt niski dostęp nie jest wcale problemem – gdy podgląd edytowanego kontenera nie jest możliwy (tryb tylko do odczytu), możemy zdebugować już opublikowaną wersję przechodząc do zakładki wersje, a następnie klikając w podgląd ostatniej wersji:

• DebugView w GA4 – miejsce w interfejsie administracyjnym Google Analytics 4. O ile GTM Preview Mode pokazuje, co zostało wysłane z Twojej przeglądarki, o tyle DebugView w GA4 potwierdza, co zostało faktycznie odebrane i przetworzone przez serwery Google i ostatecznie trafiło do usługi. Do podglądu w GA4 można przejść wchodząc w interesującą nas usługę, następnie w sekcję administracyjną i sekcję wyświetlania danych, gdzie znajduje się zakładka DebugView.

Tryb debugowania w Google Tag Managerze – jak korzystać z podglądu w praktyce

Przed uruchomieniem podglądu musisz upewnić się, że nie mamy żadnych rozszerzeń zwiększających prywatność użytkownika (adblocki) lub czy nie korzystamy z przeglądarki z wbudowaną blokadą skryptów śledzących (np. Brave). Wspomniane funkcjonalności mogą nawet całkowicie zablokować pomiar i wysyłanie danych do zewnętrznych narzędzi, przez co nasze sprawdzenie nie będzie w ogóle możliwe.

Otwarcie podglądu GTM: Otwieramy debuger klikając podgląd, wpisujemy adres naszej witryny. W tym momencie powinien ukazać się właściwy ekran podglądu w GTM.

W tym momencie musimy się zatrzymać. Widok początkowo może nieco przytłoczyć, mnogość zakładek i sekcji jest w tym wypadku naprawdę spora. Przejdźmy wspólnie po kolejnych zakładkach i sekcjach.

Podgląd w GTM pozwoli Ci na:

• sprawdzenie wszystkich eventów warstwy danych (sekcja zaznaczona na zrzucie ekranu numerem 6 jest elementem sterującym całego podglądu)
• sprawdzenie wszystkich zdarzeń w warstwie danych na danej podstronie. Nie należy mylić ich ze zdarzeniami GA4, gdyż jest to zupełnie inny koncept – zdarzenia wysyłane do GA4 można znaleźć w zakładce odnoszącej się bezpośrednio do tej usługi (1).
• podejrzenie, które tagi wyzwoliły się w trakcie konkretnych interakcji ze stroną (2)
• które tagi nie wyzwoliły się – dzięki podglądowi możesz precyzyjnie namierzyć co jest przyczyną problemu (2)
• podejrzenie zmiennych wbudowanych i zdefiniowanych przez użytkownika (3)
• podejrzenie warstwy danych (4) na poszczególnych interakcjach ze stroną (6)
• sprawdzenie sygnałów zgody użytkownika na śledzenie (5)

1. Przełączenie między poszczególnymi tagami Google – na zrzucie ekranu wyżej widoczna jest sekcja umożliwiająca wybór tagu Google (1). Dzięki niej możemy podejrzeć jakie informacje są faktycznie wysyłane do GA4 czy GAds. Przydatne jest to w wypadku gdzie część narzędzi jest implementowana z pominięciem Google Tag Managera. Kliknięcie w dane zdarzenie pozwoli ci na sprawdzenie jego szczegółowej zawartości (np. warstwy danych zdarzenia e-commerce wraz z parametrami GA4).

2. Podsumowanie tagów obecnych w kontenerze – wróćmy do sekcji Google Tag Managera. Ta sekcja pozwoli ci na sprawdzenie, które tagi wyzwoliły się na danym evencie, a które nie. Dzieli się ona na dwie części: tagi wyzwolone na danym zdarzeniu i tagi nieaktywne.

Jest to świetne rozwiązanie pozwalające na sprawdzenie poprawności Twojego wdrożenia. Przykładowo chcesz wdrożyć zdarzenie konwersji, budujesz tag oraz definiujesz wyzwalacz (trigger). Wchodzisz do trybu debugowania i wykonujesz interesującą Cię akcję na stronie. Niestety tag się nie wyzwala, więc odszukujesz moment, w którym powinien on być uruchomiony, następnie sprawdzasz interesujący Cię tag i wchodzisz w szczegóły:

W szczegółach uruchomienia wyświetlają się informacje o warunkach i wykorzystywanych zmiennych do definiowania konkretnej akcji użytkownika na stronie.

Gdy używasz kompleksowych warunków wyzwolenia, możesz zobaczyć status każdego z warunków. Dodatkowo w sekcji właściwości można zobaczyć informacje wysyłane wraz z danym tagiem (jak np. wartość czy identyfikator konwersji dla tagów zakupu).

💡 Cenna wskazówka
By odszukać konkretne miejsce, w którym wyzwolił się dany tag, nie musisz przeklikiwać się przez kolejne zdarzenia w sekcji eventów (6). Wystarczy przejść do podsumowania (strony lub całej sesji), znaleźć interesujący Cię tag i sprawdzić unikalny numer zdarzenia powodującego uruchomienie.

3. Zmienne – Kolejna zakładka obok tagów to zmienne. Dzięki niej możesz sprawdzić jakie informacje zawierają zmienne na danych zdarzeniach. Pamiętaj, że wraz ze zmianą eventów w historii także część zawartości zmiennych będzie się zmieniać. Najprostszym przykładem jest zmienna ecommerce.items, przekazująca informacje o produktach z którymi użytkownik wszedł w interakcję. Będzie ona zupełnie inna w zdarzeniu wyświetlenia listingu i wyboru przedmiotu, pomimo że obie interakcje dzieją się na tej samej podstronie.

4. Warstwa danych – Zakładka warstwa danych to jednocześnie prosty i bardzo przydatny element podglądu GTM, zwłaszcza wśród średnio zaawansowanych analityków. Zakładka ta wyświetla informacje, jak cała warstwa wygląda na etapie danego zdarzenia. Mówiąc prościej: masz wgląd we wszystkie dane, które są w danym momencie dostępne, oraz wartości przypisane do każdego zdarzenia w Google Tag Managerze. Każdą informację dostępną w warstwie danych można przekształcić w zmienną, jednakże większość zmiennych predefiniowanych nie pobiera konkretnych informacji z warstwy danych – definicję należy przeprowadzić ręcznie.

5. Zakładka ze stanem zgody – Ta sekcja wskazuje jaki stan zgody obecny jest na danym zdarzeniu. Przykładowo gdy mamy tag Meta ustawiony na reagowanie na zgodę na reklamy (ad_storage), a consent nadawany jest za późno to będzie on blokowany. Debugowanie pozwala wcześnie wykryć ten błąd i przykładowo przepiąć wspomniany tag na inne późniejsze zdarzenie.

W wypadku przedstawionym powyżej tag się nie wyzwoli, odczyta stan zgód jako odrzucony i automatycznie zablokuje tag. Początkowo może być to mylące. Skoro zaakceptowałem zgodę, to czy stan zgód nie powinien być od razu oznaczony jako granted (przyznano)? Niestety mechanizm aktualizacji zgód działa w następujący sposób: stan zgód domyślny jest zawsze oznaczony jako odrzucony i jest jak najszybciej aktualizowany do stanu faktycznego.

Powyżej widnieje widok z późniejszego zdarzenia, na którym stan zgód został już zaktualizowany.

DebugView w Google Analytics 4

Ostatecznym etapem jest sprawdzenie interesujących nas eventów bezpośrednio w DebugView w GA4.

W ostatnim etapie sprawdzenia musisz skupić się na trzech punktach:

1. Czy GA4 odbiera podstawowe zdarzenia – rozpoczęcie sesji, zbieranie zdarzeń o zaangażowaniu użytkownika i czy zbiera zdarzenia page_view przy każdym wyświetleniu podstrony.
2. Czy do GA4 trafiają wszystkie customowe zdarzenia, które konfigurowałeś (np. wypełnienie formularza).
3. Czy do GA4 trafiają zdarzenia ze ścieżki e-commerce (wszystkie zdarzenia e-commerce opisane są w dokumentacji Google, są to zdarzenia takie jak np. add_to_cart czy purchase). Warto posłużyć się małą checklistą sprawdzając zawartość danego zdarzenia e-commerce po prostu w nie klikając:
   • Zdarzenie e-commerce zawiera informacje o wartości przedmiotów, walucie i o samych przedmiotach wraz z ich identyfikatorami.
   • W przypadku zdarzenia zakupu parametr transaction_id jest niezbędny. Bez niego GA4 nie będzie odbierało informacji o przychodach i zrujnuje większość raportów.
   • W sekcji parametry znajdziemy informacje o wartości zdarzenia i walucie, a w sekcji elementy wszystkie szczegółowe informacje o przedmiotach związanych z danym zdarzeniem.

Google Analytics Debugger i inne rozszerzenia Chrome – szybkie debugowanie

Analytics Debugger: Stworzony przez Davida Vallejo, Analytics Debugger jest uważany za jedno z najlepszych rozszerzeń do debugowania. Narzędzie to ładuje się bezpośrednio w DevTools (narzędzia deweloperskie), co zapobiega ingerencji w widok samej strony i ułatwia debugowanie na dwóch ekranach jednocześnie. Warto wspomnieć, że ten sam twórca oferuje aplikację służącą do debugowania wdrożeń analityki na urządzeniach mobilnych z systemem Android lub iOS.

Rozszerzenie oferuje szerokie możliwości i znacznie wykracza swoimi funkcjami poza funkcjonalności oferowane przez Tag Assistant. Jest ono niezwykle przydatne w szczególności przy debugowaniu wdrożeń pixeli reklamowych (przykładowo: Meta, TikTok, Bing Ads).

Główne cechy narzędzia:

• Narzędzie nie ogranicza się do ekosystemu Google. Bezbłędnie debuguje sygnały z Tealium, Piwik Pro, Matomo, Adobe Tools oraz większości popularnych pixeli marketingowych.
• Dokumentuje wszystkie informacje wysyłane do danych pixeli reklamowych wraz ze szczegółowymi informacjami odnośnie przedmiotów czy kwocie transakcji – możesz podejrzeć tu wszystko co trafia do miejsca docelowego.
• Dokumentuje hity wysyłane do GAds (w tym informacje o remarketingu).
• Narzędzie pokazuje, czy hit został wysłany do serwera sGTM.
• Posiada dedykowaną, wysoce czytelną zakładkę dla raportowania zdarzeń e-commerce (kroki koszyka, segregacja na sekcje e-commerce), co mocno przyspiesza QA.
• Wyświetla obecny stan trybu uzyskiwania zgody dla każdego wysyłanego hitu/zdarzenia.
• Przechowuje informacje wysyłane do pixeli reklamowych z poprzednich podstron – zawsze możesz cofnąć się do poprzednich etapów ścieżki zakupowej. Jest to główna przewaga tego rozszerzenia nad wtyczkami od Mety czy Tiktoka, które oferują jedynie podgląd zdarzeń na bieżącej stronie.

Obszerna dokumentacja odnośnie narzędzia znajduje się na jego oficjalnej stronie. Jednakże na początku przygody z narzędziem warto wspomnieć o kilku podstawowych kwestiach:

• Dostęp do rozszerzenia uzyskujemy wchodząc w narzędzia deweloperskie, czyli: prawy przycisk myszy > zbadaj > w górnej zakładce powinna pokazać się nam zakładka Analytics Debugger.
• Przed rozpoczęciem debugowania warto dodać interesujące nas sekcje do bieżącego widoku z pomocą ikony plusa przy wyborze sekcji.

Jak wspomniano wcześniej, rozszerzenie oferuje nie tylko debugowanie GA4, ale też pixeli reklamowych czy innych programów analitycznych.

Oczywiście ostatecznym źródłem prawdy są informacje znajdujące się w sekcji network narzędzi deweloperskich. Jednakże sprawdzanie danych w ten sposób jest czasochłonne i wymaga wiedzy technicznej odnośnie tego jak dane informacje powinny wyglądać. W codziennej pracy warto opierać się na gotowych rozwiązaniach takich jak wspomniana wtyczka i oficjalne narzędzia od Google.

Debugowanie pixeli reklamowych – parametry konwersji i ich weryfikacja

Większość dużych platform reklamowych ma swoje dedykowane narzędzia do sprawdzania eventów. Przykładowo Meta Pixel Helper jest dostępny oficjalnie w rozszerzeniach przeglądarki Chrome (tak samo TikTok Pixel Helper czy Pinterest Tag Helper). Jednakże w trakcie zbiorczego checku posługiwanie się wieloma narzędziami potrafi być frustrujące. Dlatego polecane jest jednoczesne korzystanie z wtyczki, która grupuje wszystkie wysyłane hity (Analytics Debugger) i Tag Assistant, by zawczasu wyłapać błędy w wyzwalaniu się danych tagów (dopiero tagi wysyłają informacje dalej).

Każda z platform reklamowych jest nieco inna i może potrzebować innego rodzaju danych do prowadzenia efektywnych kampanii, jednakże wiele elementów jest wspólnych dla każdej z nich. Debugując wdrożenia skup się na solidnych podstawach i w miarę potrzeb pogłębiaj swoje poszukiwania. Poniżej przedstawiona jest krótka checklista, uniwersalna dla każdego z pixeli reklamowych:

• prawidłowa nazwa eventu zawarta w informacjach wysyłanych dalej
• brak duplikacji zdarze
• przesyłane podstawowe informacje o produktach (przede wszystkim ich identyfikatory – wpływa to bezpośrednio na matchrate z feedem produktowym)
• wartość eventu konwersji

Kluczem sprawnego debugowania jest nie tylko opanowanie posługiwania się narzędziami, ale poznanie charakterystyki danego systemu reklamowego. Przydatne w tej kwestii są materiały źródłowe. Dokumentacja, pomimo tego że potrafi wyglądać na zawiłą, w dłuższej perspektywie pozwoli poznać wymagania danego pixela od podszewki. Przykładowo Meta Pixel w swojej dokumentacji ma jasno wypunktowane zmienne na danym evencie wymagane do poprawnego działania kampanii.

Dobre dane zaczynają się od dobrego debugowania

Skuteczne debugowanie wdrożenia analityki to proces wymagający metodyczności. Samo przeklikanie witryny z włączonymi wtyczkami to zdecydowanie za mało w profesjonalnym środowisku. Prawdziwa jakość danych rodzi się ze zwinnego łączenia narzędzi: zaczynasz od weryfikacji architektury tagów w środowisku Google Tag Assistant, badasz dataLayer równolegle z rozszerzeniami jak Analytics Debugger, walidajesz systemy zewnętrzne używając kilku źródeł prawdy jednocześnie, a w ostateczności – kiedy szukasz twardych i bezspornych dowodów – konfrontujesz to wszystko z surowymi logami w zakładce network Twojej przeglądarki. Ten warsztat to najlepsza inwestycja w skalowalność i bezpieczeństwo analityczne każdej organizacji.