Wymiary i dane w czasie rzeczywistym

Wymiary i dane obsługiwane w zapytaniach do metody Realtime interfejsu Analytics Data API. Metody podstawowego raportowania (RunReport np.) akceptują inny zestaw wymiarów i danych niż metoda Realtime.

Wymiary

W raportach dotyczących dowolnej usługi można żądać tych wymiarów. W polu name zasobu Dimension podaj „Nazwę interfejsu API”, aby w odpowiedzi na raport otrzymać kolumnę z wymiarem.

Nazwa interfejsu API Nazwa interfejsu Opis
appVersion Wersja aplikacji Wartość parametru versionName (Android) lub skrócona wersja pakietu (iOS) aplikacji.
audienceId Identyfikator odbiorców Liczbowy identyfikator listy odbiorców. Użytkownicy są przypisywani do list odbiorców, do których należeli w okresie objętym raportem. Bieżące działania użytkowników nie mają wpływu na historyczne informacje w raportach o ich przynależności do list.
audienceName Nazwa listy odbiorców Nazwa nadana liście odbiorców. Użytkownicy są przypisywani do list odbiorców, do których należeli w okresie objętym raportem. Bieżące działania użytkowników nie mają wpływu na historyczne informacje w raportach o ich przynależności do list.
audienceResourceName Nazwa zasobu związanego z odbiorcami Nazwa zasobu związanego z tą listą odbiorców. Nazwy zasobów zawierają identyfikatory kolekcji i zasobów, które jednoznacznie identyfikują zasób. Więcej informacji znajdziesz w artykule Nazwy zasobów.
city Miasto Miasto będące źródłem aktywności użytkownika.
cityId Identyfikator miasta Identyfikator geograficzny miasta, z którego pochodzi aktywność użytkownika, uzyskany na podstawie jego adresu IP.
country Kraj Kraj będący źródłem aktywności użytkownika.
countryId Identyfikator kraju Identyfikator geograficzny kraju, z którego pochodzi aktywność użytkownika, uzyskany na podstawie jego adresu IP. Format zgodny ze standardem ISO 3166-1 alfa-2.
deviceCategory Kategoria urządzenia Typ urządzenia: komputer, tablet lub telefon komórkowy.
eventName Nazwa zdarzenia Nazwa zdarzenia.
minutesAgo Liczba minut temu w czasie rzeczywistym Liczba minut, które upłynęły od zarejestrowania zdarzenia. 00 oznacza bieżącą minutę, a 01 – poprzednią.
platform Platforma Platforma, na której uruchomiono Twoją aplikację lub witrynę, np. internet, iOS albo Android. Aby określić typ strumienia w raporcie, użyj zarówno platformy, jak i streamId.
streamId Identyfikator transmisji na żywo Liczbowy identyfikator strumienia danych z Twojej aplikacji lub witryny.
streamName Nazwa strumienia Nazwa strumienia danych z Twojej aplikacji lub witryny.
unifiedScreenName Tytuł strony i nazwa ekranu Tytuł strony (internet) lub nazwa ekranu (aplikacja), na której zarejestrowano zdarzenie.

Wymiary niestandardowe

Interfejs Realtime Data API może tworzyć raporty na podstawie wymiarów niestandardowych ograniczonych do użytkownika. Więcej informacji o wymiarach niestandardowych znajdziesz w artykule Właściwości niestandardowe użytkownika. Wymiary niestandardowe są określane w żądaniu raportu do interfejsu API za pomocą nazwy parametru i zakresu wymiaru. Aby na przykład utworzyć raport dotyczący wymiaru niestandardowego ograniczonego do użytkownika o nazwie parametru "last_level", dodaj do żądania do interfejsu Data API parametr "customUser:last_level". Jeśli w usłudze nie zarejestrowano tego wymiaru niestandardowego ograniczonego do użytkownika, to żądanie do interfejsu API zakończy się niepowodzeniem.

Oto ogólna składnia wymiarów niestandardowych. Aby wyświetlić listę wszystkich wymiarów niestandardowych w usłudze, możesz wysłać zapytanie do metody Metadata API.

Ogólna nazwa interfejsu API Opis
customUser:parameter_name Wymiar niestandardowy ograniczony do użytkownika o nazwie parametru parameter_name.

Wymiary niestandardowe ograniczone do zdarzenia nie są obsługiwane w interfejsie Realtime API.

Dane

W raportach dotyczących dowolnej usługi można żądać tych danych. W polu name zasobu Metric podaj „Nazwę interfejsu API”, aby w odpowiedzi na raport otrzymać kolumnę z danymi.

Nazwa interfejsu API Nazwa interfejsu Opis
activeUsers Aktywni użytkownicy Liczba unikalnych użytkowników, którzy korzystali z Twojej witryny lub aplikacji.
eventCount Liczba zdarzeń Liczba zdarzeń.
keyEvents Kluczowe zdarzenia Liczba kluczowych zdarzeń. Oznaczenie zdarzenia jako kluczowego zdarzenia wpływa na raporty od chwili jego utworzenia. Ta zmiana nie wpłynie na dane historyczne. W Google Analytics możesz oznaczyć dowolne zdarzenie jako kluczowe, a niektóre zdarzenia (np. first_open lub purchase) są domyślnie oznaczone jako kluczowe.
screenPageViews Wyświetlenia Liczba ekranów aplikacji lub stron internetowych wyświetlonych przez użytkowników. Zliczane są też ponowne wyświetlenia poszczególnych stron i ekranów. (liczba zdarzeń screen_view + liczba zdarzeń page_view).

Dane niestandardowe ograniczone do zdarzenia nie są obsługiwane w interfejsie Realtime API.