Wymiary i dane w czasie rzeczywistym

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

Wymiary

W raportach dotyczących dowolnej usługi można uwzględnić te wymiary. W polu name w zasobie Dimension określ „Nazwa interfejsu API” jako kolumnę wymiaru w odpowiedzi na raport.

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 zakresie dat raportu. 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 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.
audienceResourceName Nazwa zasobu związanego z odbiorcami Nazwa zasobu tej listy odbiorców. Nazwy zasobów zawierają identyfikatory kolekcji i zasobów, które umożliwiają jednoznaczne ich identyfikowanie. 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 będącego źródłem aktywności użytkownika, pobrany z adresu IP.
country Kraj Kraj będący źródłem aktywności użytkownika.
countryId Identyfikator kraju Identyfikator geograficzny kraju będącego źródłem aktywności użytkownika, uzyskany na podstawie jego adresu IP. w formacie zgodnym 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 minęł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 Liczbowy identyfikator strumienia danych z aplikacji lub witryny.
streamName Nazwa strumienia Nazwa strumienia danych z aplikacji lub witryny.
unifiedScreenName Tytuł strony i nazwa ekranu. Tytuł strony (internet) lub nazwa ekranu (aplikacja), na której zostało zarejestrowane zdarzenie.

Wymiary niestandardowe

Interfejs API danych w czasie rzeczywistym może tworzyć raporty na podstawie wymiarów niestandardowych ograniczonych do użytkownika. Więcej informacji o wymiarach niestandardowych znajdziesz w artykule Niestandardowe właściwości użytkownika. Wymiary niestandardowe są określane w żądaniu raportu interfejsu API za pomocą nazwy i zakresu parametru wymiaru. Na przykład uwzględnij w żądaniu do interfejsu Data API parametr "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 usługa nie zarejestrowała tego wymiaru niestandardowego ograniczonego do użytkownika.

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

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

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

Dane

W raportach dotyczących dowolnej usługi możesz wyświetlać te dane. W polu name zasobu Metric określ „Nazwa interfejsu API” dla kolumny danych w odpowiedzi na raport.

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. (liczba zdarzeń screen_view + liczba zdarzeń page_view).

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