Method: vitals.lmkrate.query

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

HTTP-запрос

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/lmkRateMetricSet}:query

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

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

Параметры
name

string

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

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

Тело запроса

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

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

object (TimelineSpec)

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

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

  • DAILY: показатели агрегируются по календарным датам. По историческим причинам часовым поясом по умолчанию и единственным поддерживаемым часовым поясом является America/Los_Angeles.
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

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

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

  • userPerceivedLmkRate (google.type.Decimal) – процент уникальных пользователей, у которых за период агрегирования произошел хотя бы один сбой LMK в активном режиме. Приложение считается активно используемым, если оно показывает данные на экране или выполняет видимые пользователям операции.
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "userPerceivedLmkRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "userPerceivedLmkRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • distinctUsers (google.type.Decimal) – количество уникальных пользователей за период агрегирования, которое использовалось в качестве значения нормализации для показателей userPerceivedLmkRate. Пользователь учитывается в этом показателе, если он использовал приложение в активном режиме в течение периода агрегирования. Не следует агрегировать это значение, поскольку это может привести к повторному учету пользователей. Значение округляется до ближайшего кратного 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".

Тело ответа

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

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

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

object (MetricsRow)

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

string

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

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

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

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

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