Method: vitals.anrrate.query

Запрашивает показатели в наборе показателей.

HTTP-запрос

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
name

string

Обязательно. Название ресурса.

Формат: apps/{app}/anrRateMetricSet.

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Поля
timelineSpec

object (TimelineSpec)

Необязательное поле. Спецификация параметров агрегирования хронологии.

Поддерживаемые периоды агрегирования:

  • DAILY: показатели агрегируются по календарным датам. По историческим причинам часовым поясом по умолчанию и единственным поддерживаемым часовым поясом является America/Los_Angeles.
  • HOURLY: показатели агрегируются с интервалом в один час. Единственный поддерживаемый часовой пояс – UTC. Он используется по умолчанию.
dimensions[]

string

Необязательное поле. Параметры, по которым можно сегментировать показатели.

Поддерживаемые параметры:

  • apiLevel (string) – уровень API Android, который использовался на устройстве пользователя, например 26.
  • versionCode (int64) – версия приложения, которая была запущена на устройстве пользователя.
  • deviceModel (string) – уникальный идентификатор модели устройства пользователя. Идентификатор имеет формат deviceBrand/device, где deviceBrand соответствует Build.BRAND, а device – Build.DEVICE, например google/coral.
  • deviceBrand (string) – уникальный идентификатор бренда устройства пользователя, например google.
  • deviceType (string) – тип устройства пользователя, например PHONE.
  • countryCode (string) – страна или регион, где находится устройство пользователя, на основе его IP-адреса. Представлены в виде двухбуквенного кода ISO-3166 (например, US для США).
  • deviceRamBucket (int64) – ОЗУ устройства в МБ, в сегментах (например, 1024 для 1–1,5 ГБ, 4096 для 4–6 ГБ).
  • deviceSocMake (string) – производитель основной однокристальной системы устройства, например Samsung. Reference
  • deviceSocModel (string) – модель основной однокристальной системы устройства, например Exynos 2100. Reference
  • deviceCpuMake (string) – производитель ЦП устройства, например Qualcomm.
  • deviceCpuModel (string) – модель ЦП устройства, например Kryo 240.
  • deviceGpuMake (string) – производитель графического процессора устройства, например ARM.
  • deviceGpuModel (string) – модель графического процессора устройства, например Mali.
  • deviceGpuVersion (string) – версия графического процессора устройства, например T750.
  • deviceVulkanVersion (string) – версия Vulkan на устройстве, например "4198400".
  • deviceGlEsVersion (string) – версия OpenGL ES на устройстве, например "196610".
  • deviceScreenSize (string) – размер экрана устройства, например NORMAL, LARGE.
  • deviceScreenDpi (string) – плотность экрана устройства, например mdpi, hdpi.
metrics[]

string

Необязательное поле. Показатели, которые нужно агрегировать.

Поддерживаемые показатели:

  • anrRate (google.type.Decimal) – процент уникальных пользователей, у которых за период агрегирования произошла хотя бы одна ошибка ANR.
  • anrRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "anrRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
  • anrRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "anrRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
  • userPerceivedAnrRate (google.type.Decimal) – процент уникальных пользователей, столкнувшихся хотя бы с одной ошибкой ANR в активном режиме за период агрегирования. В настоящее время к ошибкам ANR в активном режиме относятся ошибки типа Input dispatching.
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "userPerceivedAnrRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "userPerceivedAnrRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не . поддерживается с детализацией HOURLY.
  • distinctUsers (google.type.Decimal) – количество уникальных пользователей за период агрегирования, которое использовалось в качестве значения нормализации для показателей anrRate и userPerceivedAnrRate. Пользователь учитывается в этом показателе, если он использовал приложение в активном режиме в течение периода агрегирования. Не следует агрегировать это значение, поскольку это может привести к повторному учету пользователей. Значение округляется до ближайшего кратного 10, 100, 1000 или 1 000 000 в зависимости от величины значения.
filter

string

Необязательное поле. Фильтры, которые нужно применить к данным. Выражение фильтрации соответствует стандарту AIP-160 и поддерживает фильтрацию по равенству всех параметров разбивки.

pageSize

integer

Необязательное поле. Максимальный размер возвращаемых данных.

Если значение не указано, будет возвращено не более 1000 строк. Максимальное значение – 10 000. Значения выше 10 000 будут принудительно заменены на 10 000.

pageToken

string

Необязательное поле. Токен страницы, полученный из предыдущего вызова. Укажите его, чтобы получить следующую страницу.

При разбиении на страницы все остальные параметры, указанные в запросе, должны соответствовать вызову, который предоставил токен страницы.

userCohort

enum (UserCohort)

Необязательное поле. Представление пользователя, которое нужно выбрать. Выходные данные будут соответствовать выбранному представлению.

Допустимые значения:

  • OS_PUBLIC, чтобы выбрать данные из всех общедоступных версий Android. Это значение используется по умолчанию. Поддерживает все перечисленные выше параметры.
  • APP_TESTERS Чтобы выбрать данные пользователей, которые согласились стать тестировщиками. Поддерживает все перечисленные выше параметры.
  • OS_BETA Выбрать данные только из бета-версий Android, исключив данные из выпущенных версий Android. Поддерживаются только следующие параметры:
  • versionCode (int64) – версия приложения, которая была запущена на устройстве пользователя.

  • osBuild (string) – сборка ОС на устройстве пользователя, например "T1B2.220916.004".

Тело ответа

Ответное сообщение для anrrate.query.

Ниже приведена структура данных в ответе, полученном на запрос.

JSON-представление
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Поля
rows[]

object (MetricsRow)

Возвращенные строки данных.

nextPageToken

string

Токен продолжения для получения следующей страницы данных.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Дополнительную информацию вы найдете в OAuth 2.0 Overview.