Wymiary i dane obsługiwane w zapytaniach do metody Czas rzeczywisty interfejsu Analytics Data API. Podstawowe metody raportowania (np. RunReport`) akceptują inny zestaw wymiarów i danych
niż metoda Czas rzeczywisty.
Wymiary
Podane niżej wymiary mogą być żądane w raportach dowolnej usługi. Podaj nazwę interfejsu API w polu name zasobu Dimension w kolumnie wymiaru w odpowiedzi na raport.
| Nazwa interfejsu API | Nazwa interfejsu użytkownika | Opis |
|---|---|---|
| appVersion | Wersja aplikacji | Wartość parametru versionName (Android) lub skrócona wersja pakietu (iOS) aplikacji. |
| audienceId | Identyfikator listy odbiorców | Liczbowy identyfikator listy odbiorców. Użytkownicy są uwzględniani w listach 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ą uwzględniani w listach 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. |
| 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, określony na podstawie jego 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, określony na podstawie jego adresu IP. Sformatowano zgodnie ze standardem ISO 3166-1 alfa-2. |
| deviceCategory | Kategoria urządzenia | Rodzaj urządzenia: komputer, tablet lub telefon komórkowy. |
| eventName | Nazwa zdarzenia | Nazwa zdarzenia. |
| minutesAgo | Liczba minut temu w czasie rzeczywistym | Liczba minut przed zebraniem zdarzenia. 00 to bieżąca minuta, a 01 – poprzednia. |
| platform | Platforma | Platforma, na której uruchomiono Twoją aplikację lub witrynę, np. internet, iOS albo Android. Aby określić w raporcie typ strumienia, użyj obu wartości: platform i streamId. |
| streamId | Identyfikator strumienia | 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 (sieć) lub nazwa ekranu (aplikacja), na której zostało zarejestrowane 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 artykule Niestandardowe właściwości użytkownika. Wymiary niestandardowe są określane w żądaniu raportu interfejsu API według nazwy parametru wymiaru i zakresu. np. uwzględnij zmienną "customUser:last_level" w żądaniu interfejsu Data API, aby utworzyć raport dotyczący wymiaru niestandardowego ograniczonego do użytkownika o nazwie parametru "last_level". To żądanie do interfejsu API nie powiedzie się, jeśli usługa nie zarejestrowała tego wymiaru niestandardowego ograniczonego do użytkownika.
Oto ogólna składnia wymiarów niestandardowych. Możesz wysłać zapytanie do metody metadanych API, aby wyświetlić listę wszystkich niestandardowych wymiarów danej usługi.
| Ogólna nazwa interfejsu API | Opis |
|---|---|
| customUser:nazwa_parametru | Wymiar niestandardowy ograniczony do użytkownika dla parametru „parameter_name” |
Wymiary niestandardowe ograniczone do zdarzenia nie są obsługiwane w interfejsie Realtime API.
Wskaźniki
Tych danych można żądać w raportach dowolnej usługi. W polu name zasobu Metric podaj nazwę interfejsu API w kolumnie danych w odpowiedzi raportu.
| Nazwa interfejsu API | Nazwa interfejsu użytkownika | Opis |
|---|---|---|
| activeUsers | Aktywni użytkownicy | Liczba unikalnych użytkowników, którzy korzystali z Twojej witryny lub aplikacji. |
| liczby konwersji | Konwersje | Liczba zdarzeń konwersji. Zdarzenia są oznaczane jako konwersje w momencie zbierania danych. Zmiany w oznaczeniu konwersji zdarzeń są stosowane od tej pory. Każde zdarzenie możesz oznaczyć jako konwersję w Google Analytics, a niektóre zdarzenia (np. first_open, purchase) są domyślnie oznaczane jako konwersje. Więcej informacji znajdziesz w artykule [GA4] Konwersje. |
| eventCount | Liczba zdarzeń | Liczba zdarzeń. |
| screenPageViews | wyświetleń | 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. (screen_view + zdarzenia page_view). |
Interfejs Realtime API nie obsługuje danych niestandardowych ograniczonych do zdarzenia.