Параметры и метрики, поддерживаемые в запросах к методу 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.