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.