Parametr zdarzenia (ang. event parameter) to para „nazwa–wartość” przesyłana razem ze zdarzeniem do Google Analytics 4, która doprecyzowuje, co dokładnie się wydarzyło – np. value, currency, form_id czy file_name. Bez parametrów zdarzenie mówi tylko, że coś nastąpiło; z parametrami wiadomo, jakiej strony, produktu, formularza lub kwoty dotyczy. Dla marketera to fundament raportowania: parametr zarejestrowany jako wymiar niestandardowy lub dane niestandardowe pozwala segmentować i porównywać wyniki w raportach oraz eksploracjach.
Jak działa parametr zdarzenia w GA4?
Każde zdarzenie w GA4 składa się z nazwy oraz zestawu parametrów. Część z nich GA4 dołącza automatycznie (m.in. page_location, page_referrer, page_title, language), część jest zalecana dla zdarzeń rekomendowanych (np. value, currency, transaction_id, items przy zakupie), a resztę definiuje zespół wdrażający zgodnie z planem pomiarowym. Parametry trafiają do GA4 przez tag gtag.js, Google Tag Manager (najczęściej z warstwy danych) lub Measurement Protocol.
Przykład zdarzenia purchase z parametrami:
| Parametr | Przykładowa wartość | Rola w raportach |
|---|---|---|
transaction_id | ORD-2026-00871 | deduplikacja transakcji |
value | 349.90 | przychód, wartość konwersji |
currency | PLN | przeliczanie walut |
coupon | LATO10 | analiza skuteczności rabatów |
payment_type | blik | parametr własny, do rejestracji jako wymiar |
Jak zarejestrować parametr jako wymiar niestandardowy?
- Sprawdź w DebugView lub raporcie czasu rzeczywistego, że parametr faktycznie dociera z odpowiednią wartością.
- W panelu GA4 wejdź w Administracja → Definicje niestandardowe → Utwórz wymiar niestandardowy.
- Wybierz zakres (zdarzenie, użytkownik lub element), wpisz nazwę wyświetlaną i dokładną nazwę parametru – wielkość liter ma znaczenie.
- Dla wartości liczbowych (kwoty, ilości, czas) utwórz zamiast tego dane niestandardowe.
- Odczekaj do 24–48 godzin – dane pojawią się w raportach tylko od momentu rejestracji, nie wstecz.
Limity w standardowej usłudze GA4: do 25 parametrów niestandardowych na zdarzenie, nazwa parametru do 40 znaków, wartość do 100 znaków, 50 wymiarów niestandardowych o zakresie zdarzenia i 50 danych niestandardowych. Aktualne progi podaje dokumentacja Google.
Kiedy warto dodawać parametry, a kiedy nie?
- Warto, gdy jedna wartość będzie analizowana w wielu przekrojach – np.
form_idpozwala raportować wszystkie formularze jednym zdarzeniemgenerate_leadzamiast tworzyć dziesięć osobnych zdarzeń. - Warto, gdy parametr ma być użyty w definicji zdarzenia konwersji, odbiorcy lub w eksporcie do BigQuery.
- Nie warto, gdy wartości są niemal unikalne (identyfikatory sesji, pełne adresy URL z parametrami) – wymiar o wysokiej kardynalności szybko trafi do wiersza „(other)”.
- Nie wolno przesyłać danych osobowych (adresów e-mail, numerów telefonu, imion) – narusza to warunki korzystania z GA4 i RODO.
Najczęstsze błędy przy parametrach zdarzeń
- Niespójne nazewnictwo:
formId,form_idiForm_IDto trzy różne parametry. - Przesyłanie kwot jako tekst z przecinkiem („349,90”) zamiast liczby –
valuenie zostanie zsumowane. - Brak
currencyprzyvalue– GA4 może odrzucić wartość transakcji. - Rejestrowanie wymiaru przed wdrożeniem parametru i zdziwienie pustymi raportami.
- Traktowanie parametru jako wymiaru bez rejestracji – w raportach standardowych po prostu go nie widać, choć jest w eksplorowaniu tylko dla części pól.
Parametry zdarzeń w praktyce ICBM
Podczas wdrożenia GA4 zaczynamy od planu pomiarowego: dla każdego zdarzenia opisujemy nazwę, listę parametrów, źródło wartości w warstwie danych oraz decyzję, czy parametr staje się wymiarem, daną niestandardową, czy służy wyłącznie do konfiguracji konwersji. Taki dokument eliminuje dublujące się zdarzenia, chroni limity wymiarów niestandardowych i przyspiesza późniejsze audyty. Parametry testujemy w DebugView przed publikacją kontenera GTM, a po 48 godzinach weryfikujemy kompletność danych w eksploracjach i – jeśli klient korzysta z BigQuery – bezpośrednio w surowych tabelach.
Najczęściej zadawane pytania
Czym różni się parametr zdarzenia od wymiaru niestandardowego?
Parametr to dane wysyłane do GA4 razem ze zdarzeniem. Wymiar niestandardowy to zarejestrowana w panelu „etykieta” dla tego parametru, dzięki której jego wartości pojawiają się w raportach i eksploracjach. Bez rejestracji parametr jest zbierany, ale w większości raportów niewidoczny.
Czy zarejestrowanie parametru jako wymiaru działa wstecz?
Nie. Dane w raportach pojawiają się od momentu utworzenia wymiaru niestandardowego. Historyczne wartości parametru są dostępne wyłącznie w eksporcie do BigQuery, jeśli był włączony wcześniej.
Czy mogę przesyłać własne parametry do zdarzeń automatycznych, np. page_view?
Tak. W GTM lub gtag.js można dołączyć własne parametry do dowolnego zdarzenia, w tym do page_view, np. typ strony czy kategorię treści. Obowiązują te same limity liczby i długości parametrów co dla zdarzeń niestandardowych.
