W skrócie
8 min czytaniaParametry zdarzeń w GA4 to pary klucz-wartość wysyłane z każdym zdarzeniem Google Analytics 4, na przykład który link kliknięto lub ile wart był zakup. Google pozwala na 25 parametrów na zdarzenie, z nazwami do 40 znaków i wartościami do 100. Parametr niestandardowy jest zbierany, gdy tylko kod go wyśle, ale Google stwierdza, że "isn't available for reporting", dopóki nie zarejestrujesz go jako wymiaru lub wskaźnika niestandardowego, a raporty pokazują go po kolejnych 24 do 48 godzinach.
Czym są parametry zdarzeń w GA4?
Każde zdarzenie rejestrowane przez Google Analytics 4 niesie parametry zdarzeń, czyli pary klucz-wartość mówiące, który link kliknięto, ile wart był zakup albo jaki produkt obejrzał odwiedzający. Nazwa zdarzenia mówi, co się stało. Parametry podają szczegóły. Poradnik Google dla programistów ujmuje to w jednym zdaniu: "Parameters provide additional information about the ways users interact with your website."
Centrum pomocy Google tak samo dzieli dane GA4 na trzy warstwy: "Events measure what users do on your website or app, like clicking a link or watching a video. Event parameters provide more details about these actions, like which link was clicked or how much of the video a user watched. User properties tell you more about the users themselves." Jeśli dopiero poznajesz sam model zdarzeń, zacznij od śledzenia zdarzeń i wróć tu po warstwę parametrów.
Które parametry GA4 zbiera bez żadnego kodu?
GA4 dołącza zestaw parametrów do każdego zdarzenia w strumieniu internetowym, także niestandardowego, zanim napiszesz choćby wiersz kodu śledzącego. Lista parametrów Google "collected by default with every event, including custom events" wymienia dla strumieni internetowych language, page_location, page_referrer, page_title i screen_resolution. GA4 generuje też ga_session_id i ga_session_number dla każdej sesji oraz wysyła engagement_time_msec ze zdarzeniami takimi jak user_engagement i page_view.
Zdarzenia zalecane dodają drugi poziom: parametry, które Google już nazwał i podłączył do raportów predefiniowanych. Większość zespołów używa zdarzenia purchase:
| Parametr | Typ | Wymagany przez Google |
|---|---|---|
transaction_id | ciąg znaków | Tak |
value | liczba | Tak |
currency | ciąg znaków | Tak |
items | tablica produktów | Tak |
coupon | ciąg znaków | Nie |
shipping | liczba | Nie |
tax | liczba | Nie |
Dokumentacja Google dodaje regułę, której zignorowanie psuje raporty przychodów: "If you set value then currency is required for revenue metrics to be computed accurately." Parametry zdarzeń zbieranych automatycznie i zdarzeń zalecanych wypełniają predefiniowane wymiary i wskaźniki. Wszystko, co wymyślisz sam, już nie.

Jak wysłać niestandardowy parametr zdarzenia?
Niestandardowy parametr zdarzenia wysyłasz, dodając go jako parę klucz-wartość w trzecim argumencie wywołania gtag('event', ...). Poradnik Google podaje strukturę gtag('event', '<event_name>', {<event_parameters>}); z takim przykładem:
gtag('event', 'screen_view', {
app_name: 'myAppName',
screen_name: 'Home',
});Tutaj app_name i screen_name to nazwy parametrów, a myAppName i Home to wartości. Aby dołączyć parametr do każdego zdarzenia na stronie, umieść go w poleceniu config, jak w gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google ostrzega przed trzecią opcją dla wartości niestandardowych: "The set command may not reliably propagate custom parameters to all Google Analytics measurement streams." Do wszystkiego, co wymyślisz sam, używaj event lub config.
Wynik sprawdź w raporcie Realtime lub w DebugView. Google pisze, że "These reports show data as it arrives." DebugView pokazuje na karcie Parameters zdarzenia scalony zestaw, łącznie z wartościami ustawionymi globalnie.
Dlaczego parametr niestandardowy nie pojawia się w raportach GA4?
Parametr niestandardowy nie pojawia się w raportach GA4, bo Google raportuje go dopiero po zarejestrowaniu jako wymiaru lub wskaźnika niestandardowego. Poradnik dla programistów mówi to bez ogródek: "Without this registration, the parameter data is collected but isn't available for reporting." Realtime i DebugView pokazują surową wartość, dlatego parametr może wyglądać dobrze w testach, a tydzień później brakować go w każdej eksploracji.
Rejestracja to dwie minuty pracy na ekranie administracyjnym. Strona pomocy Google wymienia kroki:
- W Admin, w sekcji Data display, kliknij Custom definitions.
- Otwórz kartę Custom dimensions i kliknij Create custom dimensions.
- Wpisz Dimension name. Google dopuszcza tu podkreślenia i spacje, ale nie łączniki.
- Ustaw Scope na Event.
- W polu Event parameter wpisz nazwę parametru dokładnie tak, jak wysyła ją kod.
- Kliknij Save.
Dwóch pól nie można cofnąć. Google oznacza Scope i Event parameter komunikatem "You can't change this field after you save the new dimension." Literówka w nazwie parametru oznacza usunięcie wymiaru i utworzenie go od nowa. Po zapisaniu, jak podaje Google, możesz dodać wymiar do raportów "after 24-48 hours from when the custom data was sent and the custom dimension was created." W tym czasie wymiar jest jedną z udokumentowanych przyczyn (not set) w GA4. Strony Google nie wspominają o uzupełnianiu wartości zebranych przed powstaniem wymiaru, więc zarejestruj go w dniu wdrożenia parametru.
Liczby idą inną drogą. Parametr mierzący ilość, na przykład obejrzane sekundy lub produkty w koszyku, należy do wskaźnika niestandardowego. Reguła Google mówi, że dla "categorical data, however, such as what text was clicked or which page was viewed, it's more appropriate to use an event-scoped custom dimension."
Jakie limity dotyczą parametrów zdarzeń w GA4?
Parametry zdarzeń w GA4 są ograniczone do 25 na zdarzenie, 40 znaków na nazwę i 100 znaków na wartość, a Google nie zapisuje niczego ponad te limity. Strona o limitach zbierania danych podaje: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."
| Limit | Usługa standardowa |
|---|---|
| Parametry na zdarzenie | 25 |
| Długość nazwy parametru | 40 znaków |
| Długość wartości parametru | 100 znaków |
Wartość page_title | 300 znaków |
Wartość page_referrer | 420 znaków |
Wartość page_location | 1 000 znaków |
| Niestandardowe parametry produktu na zdarzenie e-commerce | 27, oprócz wskazanych parametrów produktu |
| Wymiary niestandardowe o zakresie zdarzenia | 50 (125 w Analytics 360) |
| Wskaźniki niestandardowe | 50 (125 w Analytics 360) |
Google podaje, że przejście na Analytics 360 pozwala "increase certain limits (but not event/parameter character limits)", więc długości nazw i wartości są takie same w każdej usłudze. W większości witryn realnym ograniczeniem jest 50 wymiarów niestandardowych o zakresie zdarzenia, a nie 25 parametrów na zdarzenie, bo każdy wymiar obejmuje jedną nazwę parametru we wszystkich zdarzeniach, które ją wysyłają. Dojście do limitu wymiarów też kosztuje: Google podaje, że "you'll need to wait 48 hours after deleting dimensions to add new ones."
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Jakie nazwy parametrów GA4 zastrzega?
GA4 zastrzega pięć przedrostków i listę nazw parametrów zdarzeń, a zastrzeżona nazwa nie może stanowić podstawy wymiaru niestandardowego. Reguły nazewnictwa Google mówią, że nazwy parametrów "can't begin with" podkreślenia, firebase_, ga_, google_ ani gtag.. Nazwy zastrzeżone dla wymiarów i wskaźników niestandardowych to cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id i userid.
W zdarzeniach wielkość liter ma znaczenie i ten sam nawyk warto stosować przy parametrach. Reguły Google stwierdzają: "Event names are case sensitive. For example, my_event and My_Event are distinct events." Wybierz jeden styl, na przykład snake case małymi literami, i trzymaj się go w zdarzeniach i parametrach, żeby Plan i plan nigdy nie stały się dwiema kolumnami.

Czego nigdy nie wysyłać jako parametru zdarzenia?
Danych osobowych i unikalnych identyfikatorów nigdy nie należy wysyłać jako parametrów zdarzeń GA4. Zasady Google mówią, że "no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", a jako przykłady podają adresy e-mail, prywatne numery telefonów i numery ubezpieczenia społecznego. Typowy wyciek to wartość formularza lub ciąg zapytania z adresu URL skopiowany do parametru, co omawia sekcja o zdarzeniach i parametrach w tekście o tym, jak Google Analytics zbiera dane użytkowników.
Unikalne wartości stwarzają drugi problem, nawet jeśli nie są danymi osobowymi. Google zaleca usługom standardowym, by nie tworzyły "unnecessary high-cardinality custom dimensions", i podaje trzy przykłady: unikalny identyfikator użytkownika, unikalny identyfikator sesji i znacznik czasu. Takie wymiary "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." Wysyłaj kategorie, takie jak plan: pro lub method: google, a nie wartości inne przy każdym działaniu.
Jedna reguła parsowania zaskakuje zespoły. Google ostrzega, że "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text", więc wartość tekstowa "94E40" zostanie odczytana jako notacja naukowa. Kody wyglądające jak liczby poprzedzaj przedrostkiem, na przykład sku_94E40, żeby pozostały tekstem.
Jak Flowsery obsługuje dane zdarzeń niestandardowych?
Flowsery rejestruje zdarzenie niestandardowe jednym wywołaniem, na przykład window.flowsery("signup"), bez menedżera tagów i bez etapu rejestrowania wymiaru niestandardowego między kodem a dashboardem. Śledzenie celów i zdarzeń obejmuje kliknięcia przycisków, wysłane formularze, pobrania plików i odtworzenia filmów, pozwala przypisywać do zdarzeń wartości przychodu i pokazuje każde z nich w kanale zdarzeń w czasie rzeczywistym, więc śledzenie sprawdzisz od razu po wdrożeniu. Zdarzenia są śledzone bez plików cookie i danych osobowych. Jeśli przenosisz plan zdarzeń z GA4, porównanie śledzenia zdarzeń niestandardowych w analityce prywatnościowej i w GA4 podpowiada, które nawyki z GA4 porzucić po drodze.
Najczęściej zadawane pytania
Ile parametrów może mieć zdarzenie w GA4?
Zdarzenie GA4 może mieć 25 parametrów w usłudze standardowej. Google nie zapisuje parametrów ponad ten limit, więc dodatkowe wartości nigdy nie trafiają do raportów. Analytics 360 podnosi niektóre limity, ale nie limit 40 znaków na nazwę ani 100 znaków na wartość.
Dlaczego widzę parametr w DebugView, ale nie w raportach?
DebugView i Realtime pokazują surowe parametry na bieżąco, a raporty standardowe i eksploracje pokazują tylko parametry niestandardowe zarejestrowane jako wymiary lub wskaźniki. Zarejestruj parametr w Admin, Custom definitions, a potem daj danym 24 do 48 godzin na pojawienie się.
Czym parametr zdarzenia różni się od wymiaru niestandardowego?
Parametr zdarzenia to para klucz-wartość wysyłana przez kod ze zdarzeniem. Wymiar niestandardowy to pole raportu utworzone w GA4, które odczytuje jedną nazwę parametru we wszystkich zdarzeniach, które ją wysyłają. Jeden wymiar niestandardowy o zakresie zdarzenia obejmuje parametr w dowolnej liczbie zdarzeń.
Czy wymiary niestandardowe obejmują dane zebrane przed ich utworzeniem?
Strony pomocy Google nie mówią, że wymiary niestandardowe uzupełniają wcześniejsze dane. Podają, że wymiaru można użyć po 24 do 48 godzinach od wysłania danych i utworzenia wymiaru. Zarejestruj wymiar w dniu wdrożenia parametru, żeby uniknąć luki.
Czy mogę wysłać identyfikator użytkownika jako parametr zdarzenia?
Nie rejestruj identyfikatora użytkownika jako wymiaru niestandardowego o zakresie zdarzenia. user_id znajduje się na liście nazw zastrzeżonych Google, a unikalny identyfikator użytkownika Google wymienia jako wymiar o wysokiej kardynalności, którego należy unikać. W takim przypadku Google wskazuje funkcję User-ID.
Co dzieje się z wartością parametru dłuższą niż 100 znaków?
GA4 nie zapisuje wartości przekraczającej limit dla danego parametru. Limit to 100 znaków dla większości parametrów, z wyjątkami: 300 dla page_title, 420 dla page_referrer i 1 000 dla page_location. Długie wartości przed wysłaniem skróć lub zamień na krótkie kategorie.
Czy mogę wysłać parametr niestandardowy poleceniem gtag set?
Google to odradza. Polecenie set może nie przekazywać niezawodnie parametrów niestandardowych do wszystkich strumieni pomiarowych Google Analytics. Wartości niestandardowe wysyłaj przez event lub config, czyli dwa polecenia zalecane przez Google do tego zadania.
Ile parametrów niestandardowych może mieć produkt w e-commerce?
Tabela limitów ogranicza niestandardowe parametry produktu do 27 na zdarzenie e-commerce, oprócz parametrów produktu wskazanych przez GA4, takich jak item_id i item_name. Ten limit jest niezależny od limitu 25 parametrów samego zdarzenia.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Czy nazwa wymiaru niestandardowego może zawierać łącznik?
Reguła na ekranie administracyjnym Google dopuszcza w nazwie wymiaru niestandardowego podkreślenia i spacje, ale nie łączniki. Trzymaj się liter, cyfr, podkreśleń i spacji, żeby uniknąć błędu walidacji przy zapisywaniu wymiaru.
Co się stanie, jeśli przez pomyłkę usunę wymiar niestandardowy?
Oczekiwanie obowiązuje, gdy osiągniesz limit wymiarów niestandardowych. Uwaga Google brzmi: "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." Gdy wszystkie 50 miejsc o zakresie zdarzenia jest zajętych, usunięcie niewłaściwego wymiaru dla zwolnienia miejsca kosztuje dwa dni, zanim będzie można odtworzyć go ponownie.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Do czego służą wymiary niestandardowe w GA4 i jakie mają limity
Rejestracja wymiarów niestandardowych w GA4 zmienia parametry zdarzeń w pola raportów. Poznaj trzy zakresy, limity 50, 25 i 10 oraz pułapkę kardynalności.


Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4
Google podzieliło jedno słowo na dwa: kluczowe zdarzenia i konwersje w GA4 to teraz różne obiekty w Analytics i Ads. Co oznaczają i gdzie je znajdziesz.


Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Współczynnik odrzuceń w GA4 to odsetek sesji bez zaangażowania. Sprawdź, jak definiuje go Google, czym różni się od Universal Analytics i gdzie go dodać.


Jak ustawiać właściwości użytkownika w GA4 i raportować o nich
Ustaw właściwości użytkownika w GA4 przez gtag lub Tag Manager, zarejestruj je jako wymiary niestandardowe o zakresie użytkownika i zmieść się w limicie 25.


Jak oblicza się liczbę stron na sesję i co mówi ona o wizycie
W GA4 liczba stron na sesję to Views per session: wyświetlenia stron i ekranów podzielone przez sesje. Wzór, miejsce w raportach i sposób interpretacji.
Co rejestruje śledzenie kliknięć na stronie i które kliknięcia gubi
Śledzenie kliknięć zapisuje, w który element, na jakiej stronie i kiedy kliknął odwiedzający. Poznaj trzy metody, pola do wysłania i powody znikania kliknięć.
Powiązane artykuły


Jak warstwa danych przekazuje zdarzenia do tagów analitycznych
Warstwa danych to kolejka, do której strona wysyła zdarzenia analityczne. Jak Menedżer tagów odczytuje dataLayer, dlaczego dane się scalają i jakie błędy gubią zdarzenia.


Strona wejścia a strona docelowa w GA4 i Adobe
Podział na stronę wejścia i stronę docelową ma znaczenie: GA4 oferuje tylko wymiar Landing page, Adobe tylko Entry page, a liczą je z różnych pól.


Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy
Konwencja nazw zdarzeń musi uwzględniać zastrzeżone nazwy GA4, limit 40 znaków i wielkość liter, bo zmiana nazwy po starcie nie obejmuje historii.

