Słownik

Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwyJak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy

W skrócie

9 min czytania

Google Analytics 4 ogranicza nazwy zdarzeń, zanim zrobi to gust twojego zespołu. Nazwy "must start with a letter", mogą zawierać "only letters, numbers, and underscores", nie mogą mieć spacji i rozróżniają wielkość liter, więc "my_event and My_Event are distinct events". Zastrzeżone nazwy, takie jak page_view, scroll, session_start i file_download, są odrzucane od razu, a Analytics "will display an error message". Nazwa może mieć 40 znaków, a zdarzenie dłuższe nie może stać się kluczowym zdarzeniem, bo "the appended _c will be missing". Zalecane zdarzenia Google zaczynają się od działania, add_to_cart i view_item, co jest sprzeczne z radą object_action z większości przewodników. Późniejsze zmiany nazw są ograniczone do 50 zmodyfikowanych zdarzeń i, jak pisze Google, "do not apply to historical data".

Dlaczego konwencja nazewnictwa zdarzeń ma znaczenie?

Wybór konwencji nazewnictwa zdarzeń jest tani pierwszego dnia i drogi dwusetnego, bo Google Analytics 4 nigdy nie stosuje zmiany nazwy do już zebranych danych. Każda niespójna nazwa, którą wdrożysz, staje się trwałym drugim wierszem w każdym raporcie grupującym według zdarzenia, a jedynym sposobem na późniejsze połączenie tych wierszy jest samodzielne przeliczenie danych w hurtowni.

Ta porażka nie jest teoretyczna ani schludna. Trzech deweloperów oprzyrządowuje ten sam przycisk w trzech sprintach i powstają signup_click, SignupClick oraz click_signup. GA4 traktuje je jako trzy osobne zdarzenia, bo "event names are case sensitive. For example, my_event and My_Event are distinct events." Lejek dzieli się na trzy części, liczba kluczowych zdarzeń to jedna trzecia prawdy, a nikt tego nie zauważa, dopóki ktoś nie porówna panelu ze Stripe. Szerszą dyscyplinę omawia tekst o śledzeniu zdarzeń, a ta strona dotyczy samych nazw.

Jakie nazwy GA4 odrzuca od razu?

GA4 odrzuca zastrzeżone nazwy i prefiksy, a zasady nazewnictwa Google jasno podają konsekwencję: "If you try to use a reserved prefix or name, Analytics will display an error message." Zasady dotyczące każdej nazwy są krótkie:

  • "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces."
  • "Event names are case sensitive."
  • "Event names can include English and non-English words and letters."

W strumieniach danych z witryn Google rezerwuje prefiks query_id oraz dziewiętnaście konkretnych nazw zdarzeń. Zespołom wdrożeniowym najbardziej dają się we znaki te brzmiące rozsądnie, po które naturalnie by się sięgnęło:

Zastrzeżone w sieciDlaczego można by po nie sięgnąć
clickOczywista nazwa dla obsługi kliknięcia
errorOczywista nazwa dla błędu po stronie klienta
scrollOczywista nazwa dla zdarzenia głębokości przewijania
file_downloadOczywista nazwa dla pobrania pliku PDF
page_viewOczywista nazwa dla wirtualnej odsłony w aplikacji jednostronicowej
session_startOczywista nazwa dla odpowiednika otwarcia aplikacji
user_engagementOczywista nazwa dla zdarzenia czasu spędzonego na stronie
video_startOczywista nazwa dla zdarzenia odtwarzacza
ad_impressionOczywista nazwa dla miejsca na własną reklamę

Większość z nich jest już wysyłana za ciebie przez pomiar zaawansowany, dlatego są zastrzeżone. Zanim cokolwiek nazwiesz, sprawdź, co twoja usługa zbiera bez konfiguracji, a o tym, co automatyczne zbieranie wyłapuje, a czego nie, przeczytasz w tekście o autocapture.

Dokumentacja Measurement Protocol dodaje drugą, dłuższą listę, która obowiązuje przy wysyłaniu zdarzeń z serwera. Obejmuje między innymi first_open, first_visit, app_exception, os_update oraz całą rodzinę firebase_ i zaznacza, że "ad_impression, in_app_purchase and screen_view events are only allowed for App streams."

Parametry mają własne zastrzeżenia. Nazwa firebase_conversion jest zarezerwowana, a nazwy parametrów "cannot begin with" _, firebase_, ga_, google_ ani gtag.. Nazwy właściwości użytkownika nie mogą zaczynać się od _, firebase_, ga_ ani google_, a nazwy first_open_time, first_visit_time, last_deep_link_referrer, user_id i first_open_after_install są zajęte.

Jakie obowiązują limity długości?

Czterdzieści znaków dla nazwy zdarzenia, a kara za przekroczenie jest dziwniejsza niż zwykłe odrzucenie. Limity zbierania zdarzeń Google podają dla nazwy "40 characters" i dodają: "If you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing." Zdarzenie nadal jest zbierane. Po prostu po cichu przestaje liczyć się jako kluczowe, bo GA4 wewnętrznie dopisuje _c i dłuższa nazwa przekracza limit.

Pozostałe limity kształtują konwencję w równym stopniu co limit nazwy:

LimitWartość
Długość nazwy zdarzenia40 znaków
Unikalne nazwy zdarzeń, strumień z witrynyBez limitu
Unikalne nazwy zdarzeń, strumień z aplikacji500 na użytkownika aplikacji
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
Właściwości użytkownika na usługę25
Długość nazwy właściwości użytkownika24 znaki
Długość wartości właściwości użytkownika36 znaków

Zespoły najczęściej potykają się o 100 znaków wartości parametru. Nazwa produktu, zapytanie wyszukiwania lub komunikat błędu formularza łatwo go przekroczą, a wtedy wartość zostaje obcięta, a zdarzenie nie jest odrzucane. Limit 24 znaków dla nazwy właściwości użytkownika jest jeszcze ciaśniejszy, o szesnaście znaków krótszy niż limit nazwy zdarzenia, co jest dobrym powodem, by nie kopiować nazw zdarzeń do nazw właściwości.

Brak limitu unikalnych zdarzeń w sieci to pułapka, a nie przywilej. Nic nie stoi na przeszkodzie, by wdrożyć czterysta nazw zdarzeń, ale raporty stają się wtedy bezużyteczne, a każda nazwa musi zostać zarejestrowana jako definicja niestandardowa, zanim pojawi się w większości analiz. Koszt tej rejestracji omawia tekst o konfiguracji wymiarów niestandardowych.

Deweloper rozpisuje schemat nazewnictwa na tablicy przed napisaniem kodu śledzącego.

Co powinno być pierwsze: obiekt czy działanie?

Popularna rada mówi: najpierw obiekt, czyli cart_added i video_played, bo raporty sortują się alfabetycznie, a nazwy zaczynające się od obiektu grupują wszystkie zdarzenia dotyczące tej samej rzeczy. To dobra rada, ale niezgodna z Google.

Zalecane zdarzenia Google zaczynają się od działania. Sam zestaw dla handlu to add_payment_info, add_shipping_info, add_to_cart, add_to_wishlist, begin_checkout, purchase, refund, remove_from_cart, select_item, view_item, a zestaw ogólny dodaje earn_virtual_currency, join_group, login, search, select_content, share, sign_up, spend_virtual_currency, tutorial_begin i tutorial_complete.

Ma to znaczenie, bo zalecane zdarzenia nie są kosmetyką. Google opisuje je jako "standardized events for different business verticals (e.g., retail, travel, games) that unlock prebuilt reporting panels", a zdarzenia niestandardowe jako "events that you define yourself because no prepopulated automatic, enhanced, or recommended event fits your needs", które są "accessible using custom reports". Zmiana add_to_cart na cart_added dla wewnętrznej spójności kosztuje cię gotowe raporty e-commerce.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Działająca zasada dzieli więc zdarzenia według pochodzenia, a nie gustu. Tam, gdzie istnieje zalecane zdarzenie, używaj pisowni Google dokładnie w opublikowanej formie, a własny schemat z obiektem na początku stosuj tylko do zdarzeń, których Google nie definiuje. Konwencja dająca add_to_cart obok pricing_table_viewed wygląda na papierze niespójnie, ale tylko ona zachowuje i raporty, i kolejność sortowania. Niezależnie od wybranej kolejności snake_case z małymi literami to jedyny zapis, który omija pułapkę wielkości liter, bo konwencja dopuszczająca różną wielkość dowolnego znaku prędzej czy później zostanie złamana.

Wybór kolejności w nazwie zdarzenia
1
Sprawdź listę zalecanych zdarzeń. Zobacz, czy Google definiuje już zdarzenie dla tego, co śledzisz, na przykład add_to_cart lub begin_checkout.
2
Jest dopasowanie. Użyj dokładnej pisowni Google, z działaniem na początku, żeby zachować gotowe raporty e-commerce.
3
Brak dopasowania. Zastosuj własny schemat z obiektem na początku, korzystając z zamkniętej listy czasowników i obiektów.
Kolejność w nazwie zależy od tego, czy Google zdefiniowało już zdarzenie, a nie od wewnętrznego stylu.

Ile kosztuje zmiana nazwy zdarzenia po starcie?

Kosztuje trwałą utratę ciągłości historii i jedno z pięćdziesięciu miejsc. Dokumentacja Google o zmianie nazw zdarzeń jest w pierwszej kwestii jednoznaczna: "Modified and new events do not apply to historical data." Modyfikacja zmienia zdarzenia tylko od tego momentu. Każdy wiersz już zapisany w usłudze zachowuje starą nazwę i nie istnieje ponowne przetwarzanie, które by to naprawiło.

Do tego dochodzą dwa ograniczenia. "An hour or more passes before modifications take effect", więc poprawka nie działa natychmiast nawet po jej wprowadzeniu. A "you can modify up to 50 existing events and create up to 50 events based on existing events", co oznacza, że funkcja modyfikacji jest zestawem naprawczym, a nie warstwą nazewnictwa, na której można polegać bez końca.

Praktyczny koszt jednej zmiany nazwy to:

  • Trwały podział w każdym raporcie grupującym według nazwy zdarzenia, w dniu zmiany.
  • Każdą definicję kluczowego zdarzenia, grupę odbiorców lub lejek odwołujący się do starej nazwy trzeba powielić dla nowej, bo inaczej przestaną liczyć. Różnicę między tymi pojęciami wyjaśnia tekst o kluczowych zdarzeniach i konwersjach.
  • Porównania rok do roku przez tę granicę trzeba składać ręcznie.
  • Jedno z pięćdziesięciu miejsc na modyfikacje, zajęte tak długo, jak stara nazwa wciąż napływa z zapisanej w pamięci podręcznej strony lub niezaktualizowanej wersji aplikacji.

Niczego z tego nie da się odzyskać większym budżetem ani dłuższym czekaniem, i to najmocniejszy argument za poświęceniem jednego popołudnia na dokument nazewnictwa, zanim trafi na produkcję pierwszy tag.

Jak wygląda działająca konwencja?

Konwencja to spisane cztery decyzje, a nie lista nazw. Podejmij każdą raz, a lista powstanie sama.

Wielkość liter: wyłącznie małe litery w snake_case, zarówno w nazwach, jak i parametrach. GA4 i tak przyjmuje tylko litery, cyfry i podkreślenia, a małe litery usuwają jedyny sposób, w jaki dwa identyczne zdarzenia mogą się rozjechać.

Słownictwo: zamknięta lista czasowników i zamknięta lista obiektów. view, select, add, remove, submit, start, complete wystarczają w większości witryn. Dwa czasowniki o tym samym znaczeniu to prosta droga do tego, by signup_submit i signup_complete trafiły na produkcję jednocześnie.

Kolejność: pisownia Google tam, gdzie istnieje zalecane zdarzenie, obiekt na początku wszędzie indziej, a wyjątek zapisany w dokumencie, żeby następny inżynier po cichu go nie „ujednolicił".

Miejsce na szczegóły: zmienne informacje należą do parametrów, nigdy do nazwy. form_submit z parametrem form_name to jedno zdarzenie, które można filtrować, a newsletter_form_submit, contact_form_submit i demo_form_submit to trzy zdarzenia, których nie porównasz bez osobnego raportu dla każdego formularza, a które zużywają trzy rejestracje definicji niestandardowych zamiast jednej.

Długość: trzymaj nazwy wyraźnie poniżej 40 znaków, bo kara dla kluczowych zdarzeń dopisuje _c do wybranej nazwy, a błąd jest cichy.

Najczęściej zadawane pytania

Jakie znaki może zawierać nazwa zdarzenia GA4?

Litery, cyfry i podkreślenia, a nazwa musi zaczynać się od litery. Google podaje tę zasadę tak: "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces." Dozwolone są litery spoza alfabetu angielskiego: "Event names can include English and non-English words and letters."

Czy nazwy zdarzeń GA4 rozróżniają wielkość liter?

Tak. Zasady nazewnictwa Google mówią, że "event names are case sensitive. For example, my_event and My_Event are distinct events." Nie ma etapu normalizacji, więc dwie pisownie tego samego zdarzenia dają dwa niezależne wiersze w każdym raporcie grupującym według nazwy zdarzenia.

Dwie osoby porównują panel analityczny z innym źródłem danych, żeby wykryć rozbieżność w raportach.

Co się stanie, jeśli wyślę zastrzeżoną nazwę zdarzenia?

Analytics ją odrzuci i pokaże błąd. Zasady nazewnictwa mówią, że "if you try to use a reserved prefix or name, Analytics will display an error message." Zastrzeżone nazwy w sieci obejmują click, error, scroll, file_download, page_view, session_start, user_engagement i video_start.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Czy używać schematu object_action, czy action_object?

W zalecanych zdarzeniach Google, które zaczynają się od działania, używaj dokładnej pisowni Google, a we wszystkich pozostałych umieszczaj obiekt na początku. Zalecany zestaw Google obejmuje add_to_cart, begin_checkout, select_item i view_item, a zmiana tych nazw oznacza utratę gotowych paneli raportowych, które Google z nimi wiąże.

Czy mogę zmienić nazwę zdarzenia GA4 po starcie?

Możesz zmienić ją na przyszłość, ale nigdy wstecz. Google stwierdza, że "modified and new events do not apply to historical data", że "an hour or more passes before modifications take effect" i że "can modify up to 50 existing events and create up to 50 events based on existing events".

Jak długa może być nazwa zdarzenia GA4?

40 znaków. Przekroczenie ma konkretną konsekwencję wykraczającą poza odrzucenie: Google ostrzega, że "if you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing."

Co się stanie, jeśli zespół wdroży niespójne nazwy zdarzeń?

GA4 traktuje każdą pisownię jako osobne zdarzenie, bo nazwy zdarzeń rozróżniają wielkość liter. Trzech deweloperów nazywających ten sam przycisk signup_click, SignupClick i click_signup daje trzy osobne wiersze w każdym raporcie, dzieli lejek na trzy części i obniża liczbę kluczowych zdarzeń do jednej trzeciej rzeczywistej sumy. Nikt tego nie zauważa, dopóki ktoś nie porówna panelu z innym źródłem danych, na przykład ze Stripe.

Czy istnieje limit liczby nazw zdarzeń wysyłanych do GA4?

Strumień z witryny nie ma limitu unikalnych nazw zdarzeń, ale ten brak działa raczej przeciwko tobie. Nazwy zdarzeń pojawiają się same, lecz każdy dołączony parametr wymaga miejsca na definicję niestandardową, więc czterysta nazw daje raporty, których nikt nie odczyta. Strumień z aplikacji ma limit: 500 unikalnych zdarzeń na użytkownika aplikacji.

Czym różni się zdarzenie niestandardowe od zalecanego?

Zdarzenie zalecane to jedna ze standardowych nazw Google dla branży, takiej jak handel czy podróże, i według Google odblokowuje gotowe panele raportowe. Zdarzenie niestandardowe definiujesz samodzielnie, gdy nie pasuje żadne z automatycznych, zaawansowanych ani zalecanych zdarzeń Google, i pojawia się tylko w tworzonych przez ciebie raportach niestandardowych. Zmiana nazwy zalecanego zdarzenia, takiego jak add_to_cart, dla wewnętrznej spójności oznacza utratę dołączonego do niego gotowego panelu.

Czy kluczowe zdarzenia nadal się liczą po zmianie nazwy śledzonego zdarzenia?

Nie automatycznie. Każdą definicję kluczowego zdarzenia, grupę odbiorców lub lejek wskazujący starą nazwę trzeba powielić dla nowej, bo inaczej przestaną liczyć w chwili, gdy zmiana zacznie działać. Takie powielenie nie zużywa miejsca na modyfikację, bo zajmuje je tylko sama zmiana nazwy, a GA4 pozwala na pięćdziesiąt takich zmian.

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

Jak warstwa danych przekazuje zdarzenia do tagów analitycznychJak warstwa danych przekazuje zdarzenia do tagów analitycznych
Słownik

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.

•9 min czytania
Jak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzeniaJak parametry zdarzeń w GA4 przenoszą szczegóły każdego zdarzenia
Słownik

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

Google ogranicza parametry zdarzeń w GA4 do 25 na zdarzenie. Poznaj limity nazw i wartości, nazwy zastrzeżone i powód, dla którego własne parametry nie trafiają do raportów.

•8 min czytania
Co zawiera plan śledzenia i czego nie jest w stanie wychwycićCo zawiera plan śledzenia i czego nie jest w stanie wychwycić
Słownik

Co zawiera plan śledzenia i czego nie jest w stanie wychwycić

Plan śledzenia opisuje każde zdarzenie, wyzwalacz, właściwość i właściciela, zanim trafi do kodu. Zobacz kolumny, wypełniony przykład i lukę, której nie widzą narzędzia walidacyjne.

•8 min czytania
Google wymienia siedem osobnych przyczyn wartości (not set) w GA4Google wymienia siedem osobnych przyczyn wartości (not set) w GA4
Słownik

Google wymienia siedem osobnych przyczyn wartości (not set) w GA4

Dokumentacja Google podaje dla (not set) w GA4 inną przyczynę dla każdego wymiaru, od braku session_start po puste content_group. Oto przyczyny i poprawki.

•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

Powiązane artykuły