Słownik

Jak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzenia

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Jak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzeniaJak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzenia

W skrócie

8 min czytania

Parametry 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:

ParametrTypWymagany przez Google
transaction_idciąg znakówTak
valueliczbaTak
currencyciąg znakówTak
itemstablica produktówTak
couponciąg znakówNie
shippingliczbaNie
taxliczbaNie

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.

Programista pisze kod na laptopie, podobnie jak przy ręcznym tworzeniu wywołania zdarzenia gtag.

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:

  1. W Admin, w sekcji Data display, kliknij Custom definitions.
  2. Otwórz kartę Custom dimensions i kliknij Create custom dimensions.
  3. Wpisz Dimension name. Google dopuszcza tu podkreślenia i spacje, ale nie łączniki.
  4. Ustaw Scope na Event.
  5. W polu Event parameter wpisz nazwę parametru dokładnie tak, jak wysyła ją kod.
  6. 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."

Od parametru niestandardowego do widocznego raportu
1
Wyślij go. Kod dodaje parametr do wywołania zdarzenia gtag.
2
Zebrany, ale bez raportowania. Google zapisuje wartość, lecz nie pokazuje jej w raportach.
3
Zarejestruj go. Utwórz wymiar lub wskaźnik niestandardowy w Admin, Custom definitions.
4
Poczekaj. Daj danym 24 do 48 godzin od rejestracji.
5
Sprawdź raport. Wymiar jest już dostępny w eksploracjach i raportach standardowych.
Parametr niestandardowy widać w DebugView od pierwszego działania, ale zanim trafi do raportu, wymaga rejestracji i odczekania.

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."

LimitUsługa standardowa
Parametry na zdarzenie25
Długość nazwy parametru40 znaków
Długość wartości parametru100 znaków
Wartość page_title300 znaków
Wartość page_referrer420 znaków
Wartość page_location1 000 znaków
Niestandardowe parametry produktu na zdarzenie e-commerce27, oprócz wskazanych parametrów produktu
Wymiary niestandardowe o zakresie zdarzenia50 (125 w Analytics 360)
Wskaźniki niestandardowe50 (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."

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

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.

Dokumenty papierowe niszczone w biurze, obraz dyscypliny w trzymaniu danych osobowych z dala od wywołań śledzących.

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.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

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

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ą limityDo czego służą wymiary niestandardowe w GA4 i jakie mają limity
Słownik

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.

•8 min czytania
Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4Co zmieniło się w kluczowych zdarzeniach i konwersjach w GA4
Słownik

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.

•7 min czytania
Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowaniaDlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Słownik

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ć.

•8 min czytania
Jak ustawiać właściwości użytkownika w GA4 i raportować o nichJak ustawiać właściwości użytkownika w GA4 i raportować o nich
Słownik

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.

•9 min czytania
Jak oblicza się liczbę stron na sesję i co mówi ona o wizycieJak oblicza się liczbę stron na sesję i co mówi ona o wizycie
Słownik

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.

•7 min czytania
Co rejestruje śledzenie kliknięć na stronie i które kliknięcia gubiCo rejestruje śledzenie kliknięć na stronie i które kliknięcia gubi
Słownik

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ęć.

•8 min czytania

Powiązane artykuły