Размеры в реальном времени и усиление; Метрики
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Параметры и метрики, поддерживаемые в запросах к методу Realtime API Analytics Data. Основные методы отчётности (например, RunReport ) принимают другой набор параметров и метрик, чем метод Realtime.
Размеры
Следующие измерения можно запросить в отчётах для любого свойства. Укажите «Имя API» в поле name ресурса Dimension для столбца измерения в ответе отчёта.
| Имя API | Имя пользовательского интерфейса | Описание |
|---|
appVersion | Версия приложения | Название версии приложения (Android) или сокращенная версия пакета (iOS). |
audienceId | Идентификатор аудитории | Числовой идентификатор аудитории. Пользователи включаются в те аудитории, к которым они принадлежали в течение периода отчёта. Текущее поведение пользователя не влияет на историческую принадлежность к аудитории в отчётах. |
audienceName | Имя аудитории | Имя аудитории. Пользователи включаются в те аудитории, к которым они принадлежали в течение периода отчёта. Текущее поведение пользователя не влияет на историческую принадлежность к аудитории в отчётах. |
audienceResourceName | Название ресурса аудитории | Название ресурса этой аудитории. Названия ресурсов содержат идентификаторы как коллекции, так и ресурса, что позволяет однозначно идентифицировать ресурс. Подробнее см. в разделе «Названия ресурсов» . |
city | Город | Город, в котором была совершена пользовательская активность. |
cityId | Идентификатор города | Географический идентификатор города, из которого была совершена активность пользователя, полученный из его IP-адреса. |
country | Страна | Страна, из которой произошла активность пользователя. |
countryId | Идентификатор страны | Географический идентификатор страны, из которой был совершен вход пользователя, полученный на основе его IP-адреса. Форматируется в соответствии со стандартом ISO 3166-1 alpha-2. |
deviceCategory | Категория устройства | Тип устройства: настольный компьютер, планшет или мобильное устройство. |
eventName | Название события | Название мероприятия. |
minutesAgo | Минуты назад в реальном времени | Количество минут назад, когда было собрано событие. 00 — текущая минута, а 01 — предыдущая минута. |
platform | Платформа | Платформа, на которой работало ваше приложение или веб-сайт; например, веб-сайт, iOS или Android. Чтобы определить тип потока в отчёте, используйте и платформу, и streamId. |
streamId | Идентификатор потока | Числовой идентификатор потока данных для вашего приложения или веб-сайта. |
streamName | Название потока | Имя потока данных для вашего приложения или веб-сайта. |
unifiedScreenName | Название страницы и имя экрана | Заголовок страницы (веб-страницы) или имя экрана (приложения), на которых было зарегистрировано событие. |
Индивидуальные размеры
API данных в реальном времени может создавать отчёты по пользовательским измерениям. Подробнее о пользовательских измерениях см. в разделе «Свойства пользовательских пользователей» . Пользовательские измерения указываются в запросе отчёта API по имени параметра и области действия. Например, включите "customUser:last_level" в запрос API данных, чтобы создать отчёт по пользовательскому измерению с именем параметра "last_level" . Этот запрос API завершится ошибкой, если свойство не зарегистрировало это пользовательское измерение.
Ниже представлен общий синтаксис для пользовательских измерений. Вы можете запросить метод Metadata API, чтобы получить список всех пользовательских измерений для свойства.
| Общее имя API | Описание |
|---|
customUser:parameter_name | Пользовательское измерение для parameter_name , определяемое пользователем. |
Пользовательские измерения на уровне событий не поддерживаются в Realtime API.
Метрики
Следующие метрики можно запросить в отчётах по любому свойству. Укажите «Имя API» в поле name ресурса Metric » для столбца метрики в ответе отчёта.
| Имя API | Имя пользовательского интерфейса | Описание |
|---|
activeUsers | Активные пользователи | Количество отдельных пользователей, посетивших ваш сайт или приложение. |
eventCount | Количество событий | Количество событий. |
keyEvents | Ключевые события | Количество ключевых событий. Отметка события как ключевого влияет на отчёты с момента создания. Исторические данные при этом не изменяются. В Google Analytics можно отметить любое событие как ключевое, а некоторые события (например, first_open или purchase ) помечаются как ключевые по умолчанию. |
screenPageViews | Просмотры | Количество экранов приложения или веб-страниц, просмотренных вашими пользователями. Учитываются повторные просмотры одной страницы или экрана (события screen_view + page_view). |
Пользовательские метрики на уровне событий не поддерживаются в Realtime API.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[null,null,["Последнее обновление: 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."]]
