Wymiary i dane w czasie rzeczywistym

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

Wymiary

W raportach dotyczących dowolnej usługi można wysyłać zapytania o te wymiary. W przypadku kolumny wymiaru w odpowiedzi raportu w polu name zasobu Dimension podaj „Nazwę interfejsu API”.

Nazwa interfejsu API Nazwa interfejsu Opis
appVersion Wersja aplikacji Wartość parametru versionName (Android) lub skrócona wersja pakietu (iOS) aplikacji.
audienceId Identyfikator odbiorców Identyfikator numeryczny 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 tej listy 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, pobrany z 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, określony na podstawie adresu IP. Sformatowany zgodnie 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 identyfikatora strumienia.
streamId Identyfikator transmisji na żywo Identyfikator strumienia danych w postaci liczby dla 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 o wymiarach niestandardowych ograniczonych do użytkownika. Więcej informacji o wymiarach niestandardowych znajdziesz w sekcji Niestandardowe właściwości użytkownika. Wymiary niestandardowe są określane w żądaniu raportu interfejsu API za pomocą nazwy parametru i zakresu wymiaru. Na przykład w żądaniu do interfejsu Data API możesz użyć parametru "customUser:last_level", aby utworzyć raport dotyczący wymiaru niestandardowego ograniczonego do użytkownika o nazwie parametru "last_level". To żądanie interfejsu API zakończy się niepowodzeniem, jeśli w usłudze nie zarejestrowano niestandardowego wymiaru o zakresie użytkownika.

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

Ogólna nazwa interfejsu API Opis
customUser:parameter_name Wymiar niestandardowy ograniczony do użytkownika w przypadku parameter_name.

Interfejs Realtime API nie obsługuje wymiarów niestandardowych ograniczonych do zdarzenia.

Dane

W raportach dotyczących dowolnej usługi można wysyłać zapytania o te dane. W przypadku kolumny danych w odpowiedzi raportu w polu name zasobu Metric podaj „Nazwę interfejsu API”.

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 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. Sposób obliczania: liczba zdarzeń screen_view + liczba zdarzeń page_view.

Interfejs Realtime API nie obsługuje danych niestandardowych ograniczonych do zdarzenia.