Method: vitals.crashrate.query

object (TimelineSpec)

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

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

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

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.

string

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

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

• crashRate (google.type.Decimal) – процент уникальных пользователей, столкнувшихся хотя бы с одним сбоем за период агрегирования.
• crashRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "crashRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
• crashRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "crashRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
• userPerceivedCrashRate (google.type.Decimal) – процент уникальных пользователей за период агрегирования, которые столкнулись хотя бы с одним сбоем в активном режиме. Приложение считается активно используемым, если оно показывает данные на экране или выполняет видимые пользователям операции.
• userPerceivedCrashRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "userPerceivedCrashRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
• userPerceivedCrashRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "userPerceivedCrashRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается при почасовой детализации.
• distinctUsers (google.type.Decimal) – количество уникальных пользователей за период агрегирования, которое использовалось в качестве значения нормализации для показателей crashRate и userPerceivedCrashRate. Пользователь учитывается в этом показателе, если он активно использовал приложение в течение периода агрегирования. Приложение считается активно используемым, если оно показывает данные на экране или выполняет видимые пользователям операции. Не следует агрегировать это значение, поскольку это может привести к повторному учету пользователей. Значение округляется до ближайшего кратного 10, 100, 1000 или 1 000 000 в зависимости от величины значения.

string

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

integer

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

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

string

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

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

enum (UserCohort)

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

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

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

• versionCode (int64) – версия приложения, которая была запущена на устройстве пользователя.

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