Słownik

Jak ustawiać właściwości użytkownika w GA4 i raportować o nich

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 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

W skrócie

9 min czytania

Właściwości użytkownika w GA4 to atrybuty osoby, takie jak poziom planu lub preferowany język, które GA4 stosuje do każdego kolejnego zdarzenia tego użytkownika. Ustawiasz je przez gtag('set', 'user_properties', {...}), w sekcji User Properties tagu GA4 Event w Tag Managerze albo przez Firebase SDK, a potem rejestrujesz każdą jako wymiar niestandardowy o zakresie użytkownika, żeby móc o niej raportować. Usługa standardowa pozwala na 25 właściwości użytkownika, a usługa 360 na 100. Nazwy mają limit 24 znaków, wartości 36, a zasady Google zabraniają umieszczania w nich danych umożliwiających identyfikację.

Czym są właściwości użytkownika w GA4?

Google Analytics 4 używa właściwości użytkownika do opisania osoby stojącej za zdarzeniami, na przykład jej poziomu planu, preferowanego języka lub roli, i stosuje każdą wartość do wszystkich kolejnych zdarzeń tego użytkownika. Strona pomocy Google definiuje je jako "attributes that describe groups of your user base," a jako przykłady podaje preferencje językowe i lokalizacje geograficzne. Używaj ich do faktów prawdziwych dla wielu zdarzeń, a szczegóły pojedynczych działań trzymaj w parametrach zdarzeń.

Właściwość użytkownika pojawia się w raportach dopiero po zarejestrowaniu jej jako wymiaru niestandardowego o zakresie użytkownika. Google mówi to wprost: "To report on the data you collect through user properties, create user-scoped custom dimensions." Strona pomocy o wymiarach niestandardowych dodaje, że "User properties become aliases for user-scoped custom dimension slots," więc pracujesz z czytelnymi nazwami, takimi jak customer_tier, zamiast numerowanych miejsc.

GA4 sam wypełnia też zestaw wymiarów użytkownika, takich jak Country, Language i Device category. Te wymiary predefiniowane obejmują typowe przypadki. Niestandardowe właściwości użytkownika służą do faktów znanych tylko twojej witrynie, na przykład tego, czy odwiedzający ma plan darmowy, czy płatny.

Czym właściwości użytkownika różnią się od parametrów zdarzeń?

Właściwości użytkownika opisują osobę i przechodzą na przyszłe zdarzenia, a parametry zdarzeń opisują jedno zdarzenie i na nim się kończą. Strona Google o wymiarach niestandardowych wyznacza tę granicę w dwóch zdaniach: parametry zdarzeń "provide more details about these actions, like which link was clicked," a "User properties tell you more about the users themselves."

KwestiaWłaściwość użytkownikaParametr zdarzenia
OpisujeUżytkownikaJedno działanie
DotyczyTego zdarzenia i wszystkich późniejszych zdarzeń użytkownikaTylko zdarzenia, które go wysłało
Zakres wymiaru niestandardowegoUżytkownikZdarzenie
Limit liczby, usługa standardowa25 właściwości użytkownika25 parametrów na zdarzenie
Długość nazwy24 znaki40 znaków
Długość wartości36 znaków100 znaków
Przykładcustomer_tier = prolink_type = outbound

Limit 36 znaków na wartość oznacza krótkie etykiety kategorii, a nie swobodny tekst. Jeśli wciąż planujesz, które dane zasługują na miejsce, zacznij od decyzji, którym mają służyć, jak opisuje poradnik o wdrażaniu analityki niestandardowej.

Jak ustawić właściwości użytkownika przez gtag?

Właściwości użytkownika ustawisz tagiem Google, wywołując polecenie set z obiektem user_properties, który stosuje wartości do każdego zdarzenia na stronie. Strona pomocy Google podaje taki przykład:

gtag('set', 'user_properties', {
  favorite_composer: 'Mahler',
  favorite_instrument: 'double bass',
  season_ticketholder: 'true',
});

Aby ograniczyć wartości do jednego strumienia danych, Google pokazuje ten sam obiekt w poleceniu config: gtag('config', 'STREAM_ID', { 'user_properties': { ... } }). Uruchom wywołanie, gdy tylko strona pozna wartość, na przykład zaraz po zalogowaniu.

Strona pomocy Google wymienia dwa inne sposoby ich ustawiania:

  1. Google Tag Manager. W tagu Google Analytics 4 Event "add a row in the User Properties section for each parameter you want to include."
  2. Firebase dla aplikacji mobilnych. Po zainstalowaniu pakietu Google Analytics for Firebase SDK postępuj zgodnie z dokumentacją Firebase "Set user properties".

Kod po stronie serwera może wysyłać właściwości użytkownika przez Measurement Protocol w obiekcie user_properties, gdzie każda właściwość ma pole value. Poradnik Google dla programistów zaznacza, że właściwości można wysyłać bez żadnych zdarzeń oraz że "Google Analytics uses the most recent value of a user property for each user."

Analityk przy biurku przegląda wykresy na laptopie, etap rejestrowania właściwości użytkownika, aby pojawiła się w raportach.

Jak raportować o właściwości użytkownika w GA4?

O właściwości użytkownika raportujesz po utworzeniu wymiaru niestandardowego o zakresie użytkownika w Admin, w sekcji Data display, Custom definitions, z co najmniej rolą Editor w usłudze. Procedura Google:

  1. W Admin, w sekcji Data display, kliknij Custom definitions.
  2. Otwórz kartę Custom dimensions i kliknij Create custom dimensions.
  3. Wpisz nazwę wymiaru. Łączniki są niedozwolone, ale podkreślenia i spacje tak.
  4. Ustaw Scope na User. Google podaje, że zakresu nie można zmienić po zapisaniu.
  5. Wpisz nazwę właściwości użytkownika dokładnie tak, jak wysyła ją kod. To pole również jest niezmienne po zapisaniu.
  6. Kliknij Save.

Strony Google nie zgadzają się co do kolejności. Strona o zbieraniu danych użytkowników każe utworzyć wymiar "Before you set user properties," a strona o tworzeniu wymiaru zaleca najpierw dodać właściwość do kodu i potwierdzić ją na karcie "Users by User property" w raporcie Realtime. Google podaje, że wymiar trafia do raportów po 24 do 48 godzinach, więc zarejestruj go w dniu wdrożenia właściwości. Gdy już istnieje, możesz używać go w porównaniach, filtrach, eksploracjach i warunkach list odbiorców.

Od kodu do raportu w czterech krokach
1
Wyślij ją. Wywołaj gtag('set', 'user_properties', {...}), gdy tylko strona pozna wartość.
2
Potwierdź ją. Poszukaj właściwości na karcie Users by User property w raporcie Realtime.
3
Zarejestruj ją. Utwórz w Admin wymiar niestandardowy o zakresie użytkownika i wpisz nazwę właściwości dokładnie tak, jak wysyła ją kod.
4
Poczekaj. Wymiar trafia do raportów po 24 do 48 godzinach.
Zarejestruj wymiar w dniu wdrożenia właściwości, żeby oczekiwanie zaczęło się jak najwcześniej.

Jakie limity dotyczą właściwości użytkownika w GA4?

Standardowa usługa GA4 przyjmuje 25 właściwości użytkownika, a usługa Google Analytics 360 przyjmuje 100, z nazwami do 24 znaków i wartościami do 36 znaków. Strona Google o limitach zbierania danych stwierdza, że Analytics "doesn't process the 26th user property" w usłudze standardowej.

LimitUsługa standardowaUsługa 360
Właściwości użytkownika na usługę25100
Wymiary niestandardowe o zakresie użytkownika25100
Długość nazwy właściwości użytkownika24 znakiNie podano na stronie limitów 360
Długość wartości właściwości użytkownika36 znakówNie podano na stronie limitów 360

Nazwy podlegają jeszcze trzem zasadom z poradnika dla programistów i stron pomocy Google:

  • Nazwy zastrzeżone. Nie można używać first_open_time, first_visit_time, last_deep_link_referrer, user_id ani first_open_after_install.
  • Przedrostki zastrzeżone. Nazwy nie mogą zaczynać się od google_, ga_ ani firebase_.
  • Wielkość liter. Google ostrzega, że "setting two user properties whose names differ only in case results in two distinct user properties being logged."

Czwarta pułapka kryje się w wymiarze niestandardowym. Google podaje, ż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." Kod poziomu taki jak 94E40 zmienia się w notację naukową, więc poprzedzaj kody literą.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Które właściwości użytkownika GA4 zbiera automatycznie?

GA4 automatycznie zbiera zestaw predefiniowanych wymiarów użytkownika, a Google podaje, że przy gtag.js lub SDK "you don't need to write additional code to collect" tych danych. W witrynach obejmują one Age, Gender, Interests, Language, Country, Region, City, Browser, Device category, Device brand, Operating system i Platform. Strumienie aplikacji dodają App store, App version, Device model i New/Established.

Nie zużywaj na ich kopiowanie żadnego z 25 miejsc. Strona Google o wymiarach niestandardowych o zakresie użytkownika mówi: "Don't create a custom user property if a predefined user dimension already exists."

Age, Gender i Interests mają pewien haczyk. Google podaje, że "must meet the Analytics data thresholds to see demographic and interest data," i ukrywa te wiersze, gdy grupa jest na tyle mała, że można zidentyfikować osoby. Strona o progach danych w GA4 wyjaśnia, kiedy to się dzieje i co to ogranicza.

Od kiedy działa właściwość użytkownika w GA4?

Właściwość użytkownika obowiązuje od chwili ustawienia dla wszystkich przyszłych zdarzeń tego użytkownika, także w późniejszych sesjach, i nigdy dla zdarzeń wcześniejszych. Sformułowanie Google: "The user property will not apply to events that happened before the user property was set."

Jeśli odwiedzający przeczyta pięć stron i dopiero przy rejestracji otrzyma customer_tier, tych pięć wyświetleń nie będzie miało poziomu. Ustawiaj właściwość przy każdym załadowaniu strony dla zalogowanego użytkownika.

GA4 usuwa też duplikaty. Google podaje, że Analytics zbiera właściwość użytkownika, gdy zostanie "set for the first time on a page" lub gdy zmieni się jej wartość, więc powtórzenie tego samego wywołania set na jednej stronie nie wysyła dodatkowych danych.

Kłódka leżąca na klawiaturze laptopa, symbol zasady, że właściwości użytkownika nigdy nie mogą zawierać danych osobowych.

Czy właściwości użytkownika w GA4 mogą zawierać dane osobowe?

Właściwości użytkownika w GA4 nie mogą zawierać danych umożliwiających identyfikację, bo zasady Google zabraniają ich wysyłania. Strona pomocy Google stwierdza, że jej "policies mandate that no data be passed to Google that Google could use or recognize as personally identifiable information (PII)," i wymienia jako przykłady "email addresses, personal mobile numbers, and social security numbers". Lista funkcji wymagających szczególnej uwagi obejmuje "All custom dimensions," a więc każdą zarejestrowaną właściwość użytkownika.

Ogranicz wartości do kategorii takich jak pro, trial czy admin. Do stałego identyfikatora konta Google wskazuje funkcję User-ID zamiast właściwości użytkownika, a strona o wymiarach niestandardowych ostrzega przed "a custom dimension for a unique ID per user." Nawet identyfikator, który nikogo nie nazywa, może być danymi osobowymi w świetle przepisów o prywatności, jak wyjaśnia poradnik o identyfikatorach analitycznych i danych osobowych.

Jak Flowsery przypisuje szczegóły do zalogowanego użytkownika?

Flowsery przypisuje szczegóły do zalogowanego użytkownika jednym wywołaniem identify(), które dokumentacja SDK opisuje jako sposób, by "Identify the current visitor with user details." Udokumentowany przykład przekazuje identyfikator użytkownika, e-mail i imię: flowsery.identify({ userId: 'user_123', email: 'user@example.com', name: 'John Doe' }). API odwiedzających Flowsery zwraca następnie identyfikator, imię i e-mail tego użytkownika w polu profilu, które dla anonimowych odwiedzających ma wartość null. Ruch anonimowy działa inaczej. Z opcją "Cookieless" Flowsery używa codziennie zmienianego hasha odwiedzającego i nie przechowuje danych osobowych, więc nie łączy anonimowego odwiedzającego między dniami ani urządzeniami. Zdarzenia niestandardowe przyjmują opcjonalne metadane: skrypt rejestruje je przez window.flowsery("signup"), a pakiet npm przez flowsery.trackEvent('signup'), w ramach śledzenia celów i zdarzeń we Flowsery. Zdarzenia pojawiają się w kanale zdarzeń w czasie rzeczywistym od razu po uruchomieniu, bez etapu rejestracji.

Najczęściej zadawane pytania

Czym właściwość użytkownika różni się od wymiaru niestandardowego o zakresie użytkownika?

Właściwość użytkownika to wartość wysyłana przez twój kod, na przykład customer_tier. Wymiar niestandardowy o zakresie użytkownika to rejestracja w Admin GA4, która sprawia, że właściwość jest widoczna w raportach. Potrzebujesz obu, a Google podaje, że wymiar trafia do raportów po 24 do 48 godzinach od utworzenia.

Ile właściwości użytkownika może mieć usługa GA4?

Usługa standardowa może mieć 25 właściwości użytkownika, a usługa Google Analytics 360 100. W usłudze standardowej Analytics nie przetwarza 26. właściwości. Wymiary niestandardowe o zakresie użytkownika mają te same limity 25 i 100.

Czy właściwości użytkownika w GA4 dotyczą przeszłych zdarzeń?

Nie. Google podaje, że właściwość użytkownika obowiązuje dla wszystkich przyszłych zdarzeń tego użytkownika, także w późniejszych sesjach, ale "will not apply to events that happened before the user property was set." Ustaw ją, gdy tylko poznasz wartość.

Jak zmienić właściwość użytkownika w GA4?

Wyślij właściwość ponownie z nową wartością. Poradnik Google dla programistów podaje, że Analytics "uses the most recent value of a user property for each user," a GA4 zbiera właściwość ponownie przy każdej zmianie wartości. Wcześniejsze zdarzenia zachowują wartość z chwili wysłania.

Czy mogę użyć user_id jako nazwy właściwości użytkownika?

Nie. user_id to jedna z pięciu nazw zastrzeżonych, obok first_open_time, first_visit_time, last_deep_link_referrer i first_open_after_install. Nazwy nie mogą też zaczynać się od google_, ga_ ani firebase_. Do identyfikatorów kont używaj funkcji User-ID.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Gdzie sprawdzić, czy właściwość użytkownika dociera do GA4?

Otwórz raport Realtime i spójrz na kartę "Users by User property". Google podaje, że karta "shows the number of people who are grouped into each user property." Potwierdź tam właściwość, zanim zbudujesz na niej raporty.

Czy mogę ustawiać właściwości użytkownika GA4 w Google Tag Managerze?

Tak. W tagu Google Analytics 4 Event dodaj wiersz w sekcji User Properties dla każdej właściwości, którą chcesz wysłać. Potem zarejestruj każdą jako wymiar niestandardowy o zakresie użytkownika, inaczej nie pojawi się w raportach.

Dlaczego mojej właściwości użytkownika nie ma w raportach GA4?

Właściwość użytkownika pozostaje poza raportami, dopóki nie istnieje jej wymiar niestandardowy i nie zakończy się jego przetwarzanie. Google podaje, że wymiar trafia do raportów po 24 do 48 godzinach od utworzenia. Sprawdź, czy zakres to User i czy nazwa właściwości dokładnie zgadza się z tym, co wysyła kod, bo oba pola są niezmienne po zapisaniu.

Czy właściwość użytkownika w GA4 może zawierać adres e-mail?

Nie. Zasady Google zabraniają wysyłania danych, które mógłby rozpoznać jako umożliwiające identyfikację, a adresy e-mail są wymienione jako przykład. Ogranicz wartości do krótkich kategorii, takich jak pro, trial czy admin.

Czy tworzyć właściwość użytkownika dla Country lub Language?

Nie. GA4 zbiera już predefiniowane wymiary użytkownika, takie jak Country, Language i Device category, a Google zaleca, by nie tworzyć własnych, gdy dane obejmuje wymiar predefiniowany. Zachowaj swoje 25 miejsc na fakty znane tylko twojej witrynie.

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
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
Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wierszeCo liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze
Słownik

Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze

Raport stron docelowych w GA4 pokazuje pierwszą stronę każdej sesji. Gdzie go znaleźć, jakie ma domyślne wskaźniki, skąd (not set) i jak dodać źródło.

•8 min czytania
Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witrynyJak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny
Słownik

Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny

Skonfiguruj wyszukiwanie w witrynie w GA4 przez pomiar zaawansowany, dodaj własne parametry zapytań, znajdź wymiar Search term i śledź wyszukiwania bez adresu URL.

•8 min czytania
Jak połączyć Search Console z GA4 i opublikować raportyJak połączyć Search Console z GA4 i opublikować raporty
Słownik

Jak połączyć Search Console z GA4 i opublikować raporty

Jak połączyć Search Console z GA4 w sekcji Administracja, jakie role są potrzebne, jak opublikować dwa raporty w Library i czego te dane nie połączą.

•8 min czytania
Jak budować wskaźniki obliczane w GA4 przy limicie pięciu miejscJak budować wskaźniki obliczane w GA4 przy limicie pięciu miejsc
Słownik

Jak budować wskaźniki obliczane w GA4 przy limicie pięciu miejsc

Google ogranicza wskaźniki obliczane w GA4 do 5 na standardową usługę. Poznaj składnię wzorów, jednostki, miejsca użycia i to, czego wzór nie może zawierać.

•9 min czytania

Powiązane artykuły