Google Play Developer Reporting API позволяет вам получать доступ к метрикам, отчетам и временной шкале ваших приложений. Чтобы максимально упростить использование 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 дней до даты включительно. differentUsers (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 дней до даты включительно. differentUsers (google.type.Decimal) : приблизительное количество пользователей, для которых были доступны данные за период агрегирования. |
vitals.excessivewakeuprate | Содержит данные счетчиков пробуждения AlarmManager в сочетании с данными состояния процесса для создания нормализованной метрики, независимой от счетчиков пользователей. | чрезмерноWakeupRate (google.type.Decimal) : процент отдельных пользователей за период агрегирования, у которых было более 10 пробуждений в час. чрезмерноWakeupRate7dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение показателя absoluteWakeupRate за 7 дней до указанной даты включительно. чрезмерноWakeupRate28dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение показателя absoluteWakeupRate за 28 дней до указанной даты включительно. differentUsers (google.type.Decimal) : приблизительное количество пользователей, для которых были доступны данные за период агрегирования. |
vitals.stuckbackgroundwakelockrate | Содержит данные о продолжительности пробуждения PowerManager в сочетании с данными о состоянии процесса для получения нормализованной метрики, независимой от количества пользователей. | StickBgWakelockRate (google.type.Decimal) : процент отдельных пользователей за период агрегации, для которых в фоновом режиме удерживалась блокировка более 1 часа. stickBgWakelockRate7dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение метрики stickBgWakelockRate за 7 дней до указанной даты включительно. StickBgWakelockRate28dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение метрики stickBgWakelockRate за 28 дней до указанной даты включительно. differentUsers (google.type.Decimal) : приблизительное количество пользователей, для которых были доступны данные за период агрегирования. |
vitals.slowstartuprate | Содержит данные о медленном запуске приложения с разбивкой по типу запуска приложения (холодный, теплый, горячий). | slowStartRate (google.type.Decimal) : процент отдельных пользователей в периоде агрегирования, у которых было событие медленного запуска. slowStartRate7dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение показателя slowStartRate за 7 дней до даты включительно. slowStartRate28dUserWeighted (google.type.Decimal) : взвешенное пользователем среднее значение показателя slowStartRate за 28 дней до даты включительно. differentUsers (google.type.Decimal) : приблизительное количество пользователей, для которых были доступны данные за период агрегирования. |
vitals.errors.counts | Содержит ненормализованное количество отчетов об ошибках. | Обратите внимание: этот ресурс пока доступен только в альфа-версии v1 API. 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 | Модель процессора устройства, например, «Крио 240». |
deviceGpuMake | Производитель графического процессора устройства, например, ARM. |
deviceGpuModel | Модель графического процессора устройства, например, Mali. |
deviceGpuVersion | Версия графического процессора устройства, например, T750. |
deviceVulkanVersion | Вулканская версия устройства, например, «4198400». |
deviceGlEsVersion | Версия устройства OpenGL ES, например, "196610". |
deviceScreenSize | Размер экрана устройства, например, НОРМАЛЬНЫЙ, БОЛЬШОЙ. |
deviceScreenDpi | Плотность экрана устройства, например, mdpi, hdpi. |