API отчётности разработчиков Google Play позволяет получать доступ к метрикам, отчётам и временной шкале ваших приложений. Чтобы максимально упростить использование API, наборы метрик стандартизируют доступ к метрикам. Набор метрик — это логическая группа связанных метрик с общими атрибутами (такими как актуальность и детализация), которые можно запрашивать вместе. Набор метрик также содержит ряд параметров, которые можно использовать для фильтрации или разбивки. Если не указано иное, все метрики можно разбить или отфильтровать по всем доступным параметрам.
Свежесть
Каждый ресурс набора метрик предлагает стандартный метод GET для получения даты и времени последней доступной точки данных, известной как актуальность. Поскольку набор метрик может поддерживать несколько уровней детализации (дневной, часовой), операция возвращает одно значение актуальности для каждого поддерживаемого уровня детализации.
Значение свежести можно использовать непосредственно в качестве конечной точки в диапазоне времени запроса.
Запросы данных
Для доступа к данным в наборе метрик следует использовать специальный метод QUERY для выполнения запросов. В каждом запросе необходимо указать уровень детализации и временной диапазон. Наряду с метриками, к которым вы хотите получить доступ, необходимо указать измерения, которые будут использоваться для разбивки агрегаций.
При запросе временных шкал следует проявлять осторожность, чтобы размер временного диапазона был обратно пропорционален размеру вашего приложения и количеству разбивок. Например, для большого приложения следует выбирать меньше дней в одном запросе, чтобы избежать превышения времени ожидания, вызванного чтением слишком большого объёма данных.
Доступные наборы метрик
В индексе ниже перечислены все конечные точки и связанные с ними данные, которые вы можете запросить.
| Метрический набор | Описание | Поддерживаемые метрики |
|---|---|---|
vitals.anrrate | Содержит данные ANR в сочетании с данными об использовании для создания нормализованной метрики, независимой от количества пользователей. | anrRate (google.type.Decimal) : процент отдельных пользователей в период агрегации, которые столкнулись хотя бы с одной ошибкой ANR. anrRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики anrRate за 7 дней до указанной даты включительно. anrRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики anrRate за 28 дней до указанной даты включительно. userPerceivedAnrRate (google.type.Decimal) : процент отдельных пользователей за период агрегации, столкнувшихся хотя бы с одной ошибкой ANR, воспринимаемой пользователем. В настоящее время учитываются только ошибки ANR типа «Диспетчеризация ввода». userPerceivedAnrRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedAnrRate за 7 дней до указанной даты включительно. userPerceivedAnrRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedAnrRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.crashrate | Содержит данные о сбоях в сочетании с данными об использовании для создания нормализованной метрики, независимой от количества пользователей. | crashRate (google.type.Decimal) : процент отдельных пользователей за период агрегации, у которых произошел хотя бы один сбой. crashRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики crashRate за 7 дней до указанной даты включительно. crashRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики crashRate за 28 дней до указанной даты включительно. userPerceivedCrashRate (google.type.Decimal) : процент отдельных пользователей за период агрегации, у которых произошел хотя бы один сбой во время активного использования приложения. userPerceivedCrashRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedCrashRate за 7 дней до указанной даты включительно. userPerceivedCrashRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedCrashRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.lmkrate | Содержит данные LMK (низкий уровень утилизации памяти) в сочетании с данными об использовании для создания нормализованной метрики, независимой от количества пользователей. | userPerceivedLmkRate (google.type.Decimal) : процент отдельных пользователей за период агрегации, которые столкнулись хотя бы с одной ошибкой LMK (нехваткой памяти) во время активного использования вашего приложения. Приложение считается активно используемым, если оно демонстрирует какую-либо активность или выполняет какую-либо службу переднего плана. userPerceivedLmkRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedLmkRate за 7 дней до указанной даты включительно. userPerceivedLmkRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики userPerceivedLmkRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.excessivewakeuprate | Содержит данные о количестве пробуждений AlarmManager в сочетании с данными о состоянии процесса для создания нормализованной метрики, независимой от количества пользователей. | excessWakeupRate (google.type.Decimal) : процент отдельных пользователей в период агрегации, у которых было более 10 пробуждений в час. excessWakeupRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики excessWakeupRate за 7 дней до указанной даты включительно. excessWakeupRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики excessWakeupRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.stuckbackgroundwakelockrate | Содержит данные о длительности пробуждения PowerManager в сочетании с данными о состоянии процесса для создания нормализованной метрики, независимой от количества пользователей. | stuckBgWakelockRate (google.type.Decimal) : процент отдельных пользователей в период агрегации, у которых wakelock удерживался в фоновом режиме более 1 часа. stuckBgWakelockRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователям значение метрики stuckBgWakelockRate за 7 дней до указанной даты включительно. stuckBgWakelockRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики stuckBgWakelockRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.slowstartuprate | Содержит данные о медленном запуске приложений, разбитые по типу запуска приложения (холодный, теплый, горячий). | slowStartRate (google.type.Decimal) : процент отдельных пользователей в период агрегации, у которых было событие медленного старта. slowStartRate7dUserWeighted (google.type.Decimal) : средневзвешенное по пользователям значение метрики slowStartRate за 7 дней до указанной даты включительно. slowStartRate28dUserWeighted (google.type.Decimal) : средневзвешенное по пользователю значение метрики slowStartRate за 28 дней до указанной даты включительно. distinctUsers (google.type.Decimal) : приблизительное количество пользователей, по которым были доступны данные за период агрегации. |
vitals.errors.counts | Содержит ненормализованные счетчики ошибок. | Обратите внимание: этот ресурс пока доступен только в альфа-версии API v1. errorReportCount (google.type.Decimal) : абсолютное количество отдельных отчетов об ошибках, полученных для приложения. |
Размеры
Каждый набор метрик поддерживает отдельный набор параметров для фильтрации и разбивки. Список параметров, доступных в API, представлен в индексе параметров ниже.
| Измерение | Описание |
|---|---|
versionCode | Код версии приложения, работавшего на устройстве пользователя на момент сбора данных. Строковое значение этого параметра можно интерпретировать как целое число. Подробнее о том, как работает управление версиями приложений на Android, см. здесь. |
countryCode | Идентификатор страны или региона пользователя на основе его IP-адреса, представленный в виде двухбуквенного кода ISO-3166 (например, US для США). |
Размеры устройства
Это параметры, характерные для конкретного устройства, а также его программные и аппаратные характеристики.
| Измерение | Описание |
|---|---|
apiLevel | Уровень API Android, работавшего на устройстве пользователя на момент сбора данных. Строковое значение этого параметра можно интерпретировать как целое число. Список версий Android и их соответствие уровням API см. здесь. |
deviceModel | Идентификатор конкретной модели устройства, определенный в каталоге устройств Play Console. |
deviceType | Идентификатор форм-фактора конкретного устройства, используемый в каталоге устройств Play Console. |
deviceRamBucket | Оперативная память устройства, в МБ, в блоках (3 ГБ, 4 ГБ и т. д.). |
deviceSocMake | Марка основной системы на кристалле устройства, например, Samsung. См . здесь . |
deviceSocModel | Название модели основного процессора устройства, например, «Exynos 2100». См. здесь . |
deviceCpuMake | Марка процессора устройства, например, Qualcomm. |
deviceCpuModel | Модель центрального процессора устройства, например, «Kryo 240». |
deviceGpuMake | Марка графического процессора устройства, например, ARM. |
deviceGpuModel | Модель графического процессора устройства, например, Mali. |
deviceGpuVersion | Версия графического процессора устройства, например, T750. |
deviceVulkanVersion | Версия устройства Vulkan, например, «4198400». |
deviceGlEsVersion | Версия OpenGL ES устройства, например, «196610». |
deviceScreenSize | Размер экрана устройства, например, ОБЫЧНЫЙ, БОЛЬШОЙ. |
deviceScreenDpi | Плотность экрана устройства, например, mdpi, hdpi. |