Wypróbuj serwer MCP w Google Analytics. Zainstaluj go z
GitHub. Więcej informacji znajdziesz w
ogłoszeniu.
Wymiary i dane w czasie rzeczywistym
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-29 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-29 UTC."],[[["\u003cp\u003eThe Realtime reporting method of the Analytics Data API allows you to query specific dimensions and metrics to analyze real-time user behavior on your app or website.\u003c/p\u003e\n"],["\u003cp\u003eSupported dimensions include user demographics (like city and country), device information, app version, audience data, event details, and user-scoped custom dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can use metrics like \u003ccode\u003eactiveUsers\u003c/code\u003e, \u003ccode\u003eeventCount\u003c/code\u003e, \u003ccode\u003escreenPageViews\u003c/code\u003e, and \u003ccode\u003ekeyEvents\u003c/code\u003e to understand real-time user engagement.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Core Reporting methods, the Realtime method uses a different set of dimensions and metrics and doesn't support event-scoped custom dimensions or metrics.\u003c/p\u003e\n"]]],["The Realtime Analytics Data API supports specific dimensions and metrics for querying. Dimensions include `appVersion`, `audienceId/Name/ResourceName`, geographic data (`city/Id`, `country/Id`), `deviceCategory`, `eventName`, `minutesAgo`, `platform`, `streamId/Name`, and `unifiedScreenName`. User-scoped custom dimensions are supported using the `customUser:parameter_name` format. Supported metrics are `activeUsers`, `eventCount`, `keyEvents`, and `screenPageViews`. Event-scoped custom dimensions and metrics are not supported in the Realtime API.\n"],null,["# Realtime Dimensions & Metrics\n\nThe dimensions and metrics supported in queries to the [Realtime method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) of the Analytics Data API. The\nCore Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Realtime method.\n\nDimensions\n----------\n\nThe following dimensions can be requested in reports for any property. Specify\nthe \"API Name\" in a [`Dimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension) resource's `name`\nfield for a column of the dimension in the report response.\n\n| API Name | UI Name | Description |\n|------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appVersion` | App version | The app's versionName (Android) or short bundle version (iOS). |\n| `audienceId` | Audience ID | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceName` | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceResourceName` | Audience resource name | The resource name of this audience. Resource names contain both collection \\& resource identifiers to uniquely identify a resource; to learn more, see [Resource names](//google.aip.dev/122). |\n| `city` | City | The city from which the user activity originated. |\n| `cityId` | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. |\n| `country` | Country | The country from which the user activity originated. |\n| `countryId` | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. |\n| `deviceCategory` | Device category | The type of device: Desktop, Tablet, or Mobile. |\n| `eventName` | Event name | The name of the event. |\n| `minutesAgo` | Realtime minutes ago | The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute. |\n| `platform` | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. |\n| `streamId` | Stream ID | The numeric data stream identifier for your app or website. |\n| `streamName` | Stream name | The data stream name for your app or website. |\n| `unifiedScreenName` | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. |\n\n### Custom Dimensions\n\nThe Realtime Data API can create reports on User scoped Custom Dimensions. See\n[Custom user properties](//support.google.com/analytics/answer/9269570) to learn\nmore about custom dimensions. Custom dimensions are specified in an API report\nrequest by the dimension's parameter name and scope. For example, include\n`\"customUser:last_level\"` in a Data API request to create a report for the\nUser-scoped Custom Dimension with parameter name `\"last_level\"`. This API\nrequest will fail if the property has not registered this User-scoped Custom\nDimension.\n\nThe following are the general syntax for Custom Dimensions. You can query the\n[Metadata API method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) to list all\nCustom Dimensions for a Property.\n\n| Generic API Name | Description |\n|-----------------------------|----------------------------------------------------|\n| `customUser:parameter_name` | User-scoped Custom Dimension for `parameter_name`. |\n\nEvent-scoped custom dimensions aren't supported in the Realtime API.\n\nMetrics\n-------\n\nThe following metrics can be requested in reports for any property. Specify the\n\"API Name\" in a [`Metric`](/analytics/devguides/reporting/data/v1/rest/v1beta/Metric) resource's `name` field for\na column of the metric in the report response.\n\n| API Name | UI Name | Description |\n|-------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `activeUsers` | Active users | The number of distinct users who visited your site or app. |\n| `eventCount` | Event count | The count of events. |\n| `keyEvents` | Key events | The count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as `first_open` or `purchase`) are marked as key events by default. |\n| `screenPageViews` | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). |\n\nEvent-scoped custom metrics aren't supported in the Realtime API."]]
