DebugView w GA4: 10 problemów, przez które zdarzenia nie docierają

Czym jest DebugView w GA4 i jak go włączyć

DebugView znajdziesz w ustawieniach administracyjnych usługi, w sekcji wyświetlania danych. Raport pokazuje tylko te zdarzenia, które przyszły z flagą debugowania, więc najpierw trzeba ją włączyć na swoim urządzeniu.

Przykłady w kodzie gtag.js:

// cała konfiguracja w trybie debugowania – tylko w środowisku testowym
gtag('config', 'G-ABC123XYZ', { 'debug_mode': true });

// tylko jedno zdarzenie
gtag('event', 'generate_lead', { 'form_id': 'kontakt', 'debug_mode': true });

Dokumentacja Google wyraźnie zaznacza, że ustawienie parametru na false nie wyłącza trybu debugowania. Jeśli chcesz go wyłączyć, usuń parametr z konfiguracji. To częsty błąd przy wdrożeniach, w których ktoś „wyłączył” debugowanie na produkcji, a wszystkie wizyty dalej trafiały do DebugView.

Jak czytać DebugView: urządzenia, zdarzenia i parametry

Ekran DebugView składa się z selektora urządzeń i trzech kolumn: archiwum minutowego, strumienia sekundowego oraz listy najważniejszych zdarzeń i właściwości użytkownika. Każde kliknięcie zdarzenia otwiera jego parametry.

• Selektor urządzeń (Debug device) w lewym górnym rogu pozwala wybrać jedno urządzenie, jeśli testuje kilka osób naraz. Liczba obok pokazuje, ile urządzeń w trybie debugowania wysyła dane.
• Strumień minutowy (lewa kolumna) to archiwum zdarzeń z ostatnich 30 minut, zgrupowanych w minutowe bloki. Kliknięcie bloku przewija strumień sekundowy.
• Strumień sekundowy (środkowa kolumna) pokazuje zdarzenia z ostatnich 60 sekund w kolejności ich wystąpienia. Kliknięcie zdarzenia otwiera listę parametrów i elementów (items).
• Prawa kolumna zawiera zestawienie najczęstszych zdarzeń z ostatnich 30 minut i bieżące właściwości użytkownika.

Najważniejsza czynność to sprawdzenie parametrów. Dla zdarzenia purchase muszą być widoczne transaction_id, value, currency i lista produktów. Jeśli parametr jest w żądaniu, ale nie ma go w raportach, pamiętaj, że niestandardowe parametry trzeba zarejestrować jako wymiary lub dane niestandardowe – DebugView pokazuje je od razu, raporty dopiero po rejestracji. Zdarzenia oznaczone jako kluczowe są w DebugView wyróżnione, co pozwala szybko sprawdzić konfigurację opisaną w artykule o zdarzeniach kluczowych w GA4.

10 problemów, przez które zdarzenia nie docierają do DebugView

Poniższe problemy uszeregowaliśmy według tego, jak często pojawiają się w praktyce. Przy każdym znajdziesz objaw i sposób sprawdzenia.

1. Tryb debugowania nie jest włączony

Zdarzenie dociera do GA4, ale bez flagi debugowania, więc widać je w raporcie Czas rzeczywisty, a nie w DebugView. Sprawdź w karcie Network, czy żądanie collect zawiera parametr _dbg=1. Jeśli nie, uruchom podgląd przez Tag Assistant albo dodaj debug_mode.

2. Wybrane jest inne urządzenie

Gdy testuje kilka osób albo masz otwarte dwie przeglądarki, DebugView może pokazywać inne urządzenie. Rozwiń selektor urządzeń i wybierz właściwe. Po dłuższej przerwie odśwież widok.

3. Brak zgody na analityczne ciasteczka

Według dokumentacji Google zdarzenia nie pojawią się w trybie debugowania, gdy działa Consent Mode, a użytkownik nie wyraził zgody na analityczne ciasteczka. Przy testach najpierw zaakceptuj baner, a działanie przy odmowie sprawdzaj osobno. Jak to zrobić, opisujemy w tekście o tym, jak sprawdzić, czy Consent Mode działa, a różnice między trybami Consent Mode – w porównaniu trybu podstawowego i zaawansowanego.

4. Bloker reklam lub ochrona prywatności w przeglądarce

Rozszerzenia blokujące reklamy i przeglądarki z wbudowaną ochroną blokują żądania do domen analitycznych. W karcie Network takie żądanie jest oznaczone jako zablokowane albo w ogóle się nie pojawia. Testuj w czystym profilu przeglądarki bez rozszerzeń.

5. Błędny identyfikator pomiaru

Tag wysyła dane do innej usługi, np. testowej albo starej. Porównaj parametr tid w żądaniu z identyfikatorem strumienia danych w ustawieniach usługi, w której otworzyłeś DebugView. W firmach z wieloma usługami to zaskakująco częsta przyczyna.

6. Tag w ogóle się nie uruchamia

Jeśli w karcie Network nie ma żądania, problem leży w regule lub w warstwie danych. Otwórz podgląd GTM i sprawdź, czy tag jest w sekcji uruchomionych przy właściwym zdarzeniu. Pełną procedurę opisujemy w artykule jak sprawdzić, czy tag działa, a poprawną strukturę zdarzeń e-commerce w specyfikacji dataLayer dla GA4.

7. Filtr danych wyklucza Twoje zdarzenia

Aktywny filtr ruchu wewnętrznego obejmujący adres IP biura może sprawić, że Twoje zdarzenia nie przejdą przetwarzania. To samo dotyczy filtra nazwy hosta, dostępnego od czerwca 2026 roku, jeśli testujesz na wykluczonej domenie, np. środowisku stagingowym. Na czas testów przełącz filtr w stan testowy albo testuj spoza objętej nim sieci.

8. Nazwa zdarzenia lub parametru łamie zasady GA4

Nazwa zdarzenia może mieć maksymalnie 40 znaków, musi zaczynać się od litery i zawierać tylko litery, cyfry i podkreślniki. Nazwy zarezerwowane (np. session_start, first_visit) i przedrostki ga_, google_ oraz firebase_ są zabronione. Zdarzenie może mieć do 25 parametrów, a wartość parametru tekstowego jest obcinana po 100 znakach. Zdarzenia łamiące te zasady mogą zostać odrzucone lub zapisane niekompletnie.

9. Zdarzenia z serwera nie mają flagi debugowania

Zdarzenia z Measurement Protocol i z server-side taggingu trafią do DebugView tylko wtedy, gdy niosą flagę debugowania. Serwer walidacyjny Measurement Protocol sprawdza poprawność żądania, ale nie wysyła zdarzeń do DebugView. Przykładowe zdarzenie z flagą:

{
  "client_id": "1234567890.1730012345",
  "events": [{
    "name": "purchase",
    "params": {
      "transaction_id": "ZAM-2026-10458",
      "value": 249.00,
      "currency": "PLN",
      "session_id": "1730012345",
      "debug_mode": true
    }
  }]
}

Przy server-side GTM sprawdź w podglądzie kontenera serwerowego żądania wychodzące do GA4. Konfigurację serwera opisujemy w poradniku o server-side taggingu krok po kroku.

10. Aplikacja jednostronicowa nie wysyła odsłon

W sklepach i serwisach zbudowanych jako SPA przejście między podstronami nie przeładowuje strony, więc tag nie wysyła kolejnych page_view. Sprawdź w ustawieniach pomiaru zaawansowanego strumienia, czy włączona jest opcja zmian strony na podstawie zdarzeń historii przeglądarki, albo wysyłaj odsłony wirtualne z warstwy danych.

Jak zdiagnozować problem z DebugView w 5 minut

Najszybsza diagnoza polega na sprawdzaniu po kolei od przeglądarki do GA4. Każdy krok wyklucza jedną grupę przyczyn.

1. Otwórz kartę Network i wpisz filtr collect. Brak żądania oznacza problem z tagiem lub regułą (punkt 6).
2. Sprawdź status żądania. Zablokowane żądanie wskazuje na bloker lub ochronę przeglądarki (punkt 4).
3. Sprawdź tid. Inny identyfikator niż w usłudze oznacza błędny tag (punkt 5).
4. Sprawdź _dbg=1. Brak flagi oznacza wyłączony tryb debugowania (punkt 1).
5. Sprawdź parametry zgody gcs i gcd w żądaniu. Odmowa zgody na analitykę wyjaśnia pusty DebugView (punkt 3).
6. Sprawdź selektor urządzeń i filtry danych w GA4 (punkty 2 i 7).

Czy zdarzenia z DebugView trafiają do raportów

Tak – zdarzenia wysłane w trybie debugowania są przetwarzane jak pozostałe i mogą pojawić się w standardowych raportach. Dlatego Google zaleca odfiltrowanie ruchu deweloperskiego.

W ustawieniach filtrów danych znajdziesz filtr ruchu deweloperskiego, który wyklucza z raportów zdarzenia z flagą debugowania. Najpierw uruchom go w stanie testowym i sprawdź efekt, a dopiero potem aktywuj. Pamiętaj, że filtr aktywny działa tylko na dane zebrane po aktywacji i nie da się go cofnąć dla przetworzonych danych.

Druga sprawa to zakupy testowe. Jeśli testujesz purchase na produkcji, zamówienie trafi do przychodu w raportach. Używaj zamówień, które sklep anuluje, i wysyłaj dla nich zdarzenie refund, albo testuj na stronie stagingowej z osobnym strumieniem danych. Zdublowane zakupy to temat na osobny tekst – opisujemy go w artykule o duplikatach transakcji w GA4.

Gdy testy wypadną dobrze, warto ustawić automatyczne alerty o nagłych spadkach zdarzeń – sposoby opisujemy w tekście o monitoringu tagów na produkcji. Przegląd tegorocznych zmian w usłudze, łącznie z nowym filtrem nazwy hosta, znajdziesz w zestawieniu nowości w GA4 w 2026 roku. Pozostałe poradniki diagnostyczne zebraliśmy w podtemacie Debugowanie tagów.