Как отслеживать технические показатели приложения с помощью Android Vitals

Чтобы посмотреть дополнительные сведения о показателе, нажмите Подробнее () рядом с ним. Вы увидите следующую информацию:

• Пороги соответствия.
• Сравнение с другими приложениями в этой категории.
• Подробное сравнение показателей.
  • Вверху страницы на карточке сравнения нажмите Изменить группу аналогов, чтобы изменить специальную группу аналогов. После этого вы сможете сравнить свое приложение с другими продуктами в Google Play.
• Динамику изменений показателя.

Эти показатели отражают качество вашего приложения. Они рассчитываются на основе данных о частоте использования приложения и количестве пользователей, столкнувшихся с ошибкой ANR. В результате показывается процент таких пользователей от общего числа активных пользователей за день. Показатель "Активный пользователь за день" предполагает взаимодействие с приложением на одном устройстве в течение одного дня. Если пользователь в течение одного дня запускает приложение на нескольких устройствах, каждое из них учитывается при расчете количества активных пользователей за этот день. Если несколько пользователей запускают приложение на одном и том же устройстве в течение одного дня, это будет считаться как один активный пользователь за день.

Существует три показателя доли ошибок ANR:

• Доля ошибок ANR в активном режиме. Процент активных пользователей за день, столкнувшихся по крайней мере с одной ошибкой ANR в активном режиме. Это такие ошибки, которые, вероятнее всего, были замечены пользователем при работе с приложением. Пока для этого показателя учитываются только ошибки ANR вида input dispatching timed out. Этот показатель всегда будет меньше общего показателя доли ошибок ANR, потому что рассчитывается с учетом активных пользователей за день и не включает все ошибки ANR.
  Доля ошибок ANR в активном режиме – один из основных показателей Android Vitals. Он влияет на параметры видимости приложения в Google Play. Этот показатель важен, так как учитывающиеся в нем ошибки возникают во время работы с приложением и доставляют неудобства пользователям.
• Доля ошибок ANR. Процент пользователей за день, столкнувшихся по крайней мере с одной ошибкой ANR. Этот показатель учитывает ошибки ANR, которые не относятся к возникшим в активном режиме, однако мы не можем гарантировать, что они произошли незаметно для пользователей.
• Доля повторных ошибок ANR. Процент активных пользователей за день, столкнувшихся по крайней мере с двумя ошибками ANR. Этот показатель помогает выявлять цикличные проблемы.

Устранение неполадок

Ошибки, влияющие на показатели доли ошибок ANR, представлены на странице Сбои и ошибки ANR. Там также можно использовать фильтр, чтобы показывались только ошибки ANR в активном режиме.

Инструкции по диагностике и устранению ошибок ANR представлены на сайте Android для разработчиков.

Эти показатели отражают качество вашего приложения. Они рассчитываются на основе данных о частоте использования приложения и количестве пользователей, столкнувшихся со сбоями. В результате показывается процент таких пользователей от общего числа активных пользователей за день. Показатель "Активный пользователь за день" предполагает использование приложения с одного устройства в течение одного дня. Если у пользователя несколько устройств, каждое из них будет учтено. Например, если два человека, у каждого из которых по одному устройству, использовали приложение в течение двух дней, в показателе будет отражено четыре сеанса.

Существует три показателя доли сбоев:

• Доля сбоев в активном режиме. Процент активных пользователей за день, столкнувшихся по крайней мере с одним сбоем в активном режиме. Это такие сбои, которые, вероятнее всего, были замечены пользователем при работе с приложением. Например, к ним относятся сбои в момент, когда приложение показывает данные на экране или работает в активном режиме. Этот показатель всегда будет меньше общего показателя доли сбоев, потому как рассчитывается с учетом активных пользователей за день и не включает все сбои.
  Доля сбоев в активном режиме – один из основных показателей Android Vitals. Он влияет на параметры видимости приложения в Google Play. Этот показатель важен, так как учитывающиеся в нем сбои возникают во время работы с приложением и доставляют неудобства пользователям. Поэтому вам стоит следить за тем, чтобы он не превышал порог соответствия.

• Доля сбоев. Процент активных пользователей за день, столкнувшихся по крайней мере с одним сбоем. Этот показатель учитывает сбои, которые не относятся к возникшим в активном режиме, однако мы не можем гарантировать, что они произошли незаметно для пользователей.

• Доля повторных сбоев. Процент активных пользователей за день, столкнувшихся по крайней мере с двумя сбоями. Этот показатель помогает выявлять цикличные проблемы.

Устранение неполадок

Инструкции по диагностике и устранению сбоев можно найти на сайте Android для разработчиков.

На странице Время запуска можно посмотреть сведения о медленных холодных, теплых и горячих запусках. Время запуска – это интервал между запуском приложения и появлением на экране первых кадров. Его также называют начальной отрисовкой.

Если в приложении несколько экранов загрузки, то период ожидания перед началом работы может быть дольше.

Сведения о сборе данных

• Время запуска записывается, только когда пользователь выполняет какое-то действие.
  • Пример. Время запуска приложения-клавиатуры равняется времени запуска сопутствующего приложения.
• Если приложение запускается несколько раз в течение дня, записывается максимальное время запуска за этот день для каждого состояния системы.
• Время запуска фиксируется, когда полностью загружается первый фрейм приложения, даже если это не экран, с которым взаимодействует пользователь.
  • Пример. Если при запуске приложения отображается заставка, время запуска равняется времени ее загрузки.

Сведения Android Vitals

• Затронуто сеансов. Процент сеансов, в ходе которых наблюдался медленный запуск, для каждого состояния системы.
  • Медленный холодный запуск: 5 секунд или больше.
  • Медленный теплый запуск: 2 секунды или больше.
  • Медленный горячий запуск: 1 секунда или больше.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. В ходе 10 % или 1 % сеансов в день наблюдался медленный запуск приложения.

Устранение неполадок

Если медленный запуск приложения наблюдается слишком часто, найдите решение этой проблемы на сайте для разработчиков Android.

Почему это важно

Сведения о медленных сеансах помогают оценить производительность приложения, которая влияет на плавность игрового процесса.

Интерпретация данных

На странице "Медленные сеансы" показан процент сеансов в день, во время которых более 25 % кадров отрисовывалось со скоростью ниже 30 или 20 кадр/с (в зависимости от выбранного контрольного показателя). Здесь также можно посмотреть распределение сеансов игры по частоте кадров (она измеряется по 75-му процентилю, то есть 75 % кадров достигают как минимум этой частоты).

Большинство игр в Google Play должно стремиться к частоте 30 кадр/с или выше. Это гарантирует, что пользователи получат адекватное впечатление от игры любого типа (хотя некоторые предпочитают, чтобы частота была не менее 60 кадр/с, особенно на устройствах премиального класса). Следите за долей медленных сеансов (30 кадр/с), чтобы достигнуть указанного целевого уровня. Помните, что в этом показателе учитываются только сеансы, где более 25 % кадров прорисовывались со скоростью ниже 30 кадр/с, то есть допускается некоторая изменчивость.

Хотя частота 30 кадр/с считается стандартом, есть ситуации и типы игр, когда целесообразно снизить это значение. Кроме того, не все устройства могут поддерживать такую скорость отрисовки. В таких случаях рекомендуется, чтобы минимум 75 % кадров отрисовывалось со скоростью 20 кадр/с или выше. Следите за долей медленных сеансов (20 кадр/с), чтобы достигнуть указанного целевого уровня.

В Android Vitals представлена статистика о медленных сеансах (30 и 20 кадр/с) для каждого устройства, а также для всех устройств и сеансов. С помощью общего показателя можно понять, насколько в целом довольны пользователи. Но не забывайте следить за производительностью отдельных устройств. Со временем в Google Play ваша игра перестанет показываться для тех пользователей, на устройствах которых не удается достичь частоты 20 кадр/с.

В Android Vitals этот показатель начинает отслеживаться, только если сеанс игры длится не менее одной минуты.

Сведения о сборе данных

Показатель "Медленные сеансы" определяется на основе данных, собранных с помощью SurfaceFlinger. Частота кадров во время сеанса рассчитывается с учетом задержек при отрисовке кадров во всех зонах, которые относятся к приложению. При этом учитываются кадры, формируемые с помощью OpenGL, Vulkan и инструментов разработки интерфейса приложений для Android. Этот показатель пока поддерживается только для игр.

Данные о частоте кадров для него собираются на устройствах с Android 9 или более поздней версией.

Информация на панели управления

• Репрезентативная частота кадров. Частота кадров в вашей игре на устройствах с Android 9 или более поздней версией, рассчитанная по 75-му процентилю. Это значит, что в 75 % сеансов частота кадров была не менее указанного значения на протяжении 75 % времени.
• Изменение доли медленных сеансов. Изменение процента медленных сеансов во времени.
• Распределение частоты кадров. Гистограмма частоты кадров в 75-м процентиле для всех сеансов. Это означает, что частота отрисовки 75 % кадров в сеансе была выше указанного значения.

Устранение неполадок

Если в вашем приложении часто возникают медленные сеансы, найдите решение этой проблемы на сайте для разработчиков Android.

Интерпретация данных

На странице "Слишком много медленно формирующихся кадров" указан процент сеансов в день, во время которых более 50 % кадров не были сформированы за установленное время отрисовки на устройстве. Приложение должно работать со скоростью 60 кадров в секунду без пропусков и зависаний.

Сведения о сборе данных

Google собирает информацию о фреймах, обработанных с помощью UI Toolkit, а не с помощью OpenGL или Vulkan напрямую.

Информация на панели управления

Данные в каждой строке представлены в процентилях.

• Затронуто сеансов. Процент сеансов в день, в течение которых время формирования более 50 % кадров превысило 16 мс. Учитываются дни, когда ваше приложение использовалось. Например, если два человека пользовались приложением в течение двух дней, число сеансов равно четырем.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. Время обработки 90 % или 99 % всех фреймов в отчете было меньше указанного значения. Эти показатели рассчитываются на основе всей собранной информации о фреймах.

Нажав на запись в таблице, вы увидите диаграмму "Распределение времени отрисовки интерфейса". Для большинства фреймов время отрисовки должно составлять 16 мс или меньше.

Данные под диаграммой помогут вам выяснить причины проблем с загрузкой интерфейса. Например, высокое значение показателя "Большая задержка ввода" говорит о том, что следует внести изменения в тот раздел кода, который отвечает за события ввода. Подробную информацию о перечисленных ниже показателях вы найдете в этой статье.

• Пропущенные события Vsync. Количество пропущенных событий Vsync, разделенное на число кадров, обработка которых заняла более 16 мс.
• Большая задержка ввода. Отношение количества событий ввода, которые заняли более 24 мс, к числу кадров, обработка которых заняла свыше 16 мс.
• Медленный поток UI. Отношение количества потоков UI, выполнение которых заняло более 8 мс, к числу кадров, формирование которых заняло свыше 16 мс.
• Медленные команды на отрисовку. Отношение количества случаев, когда отправка команды на отрисовку в графический процессор заняла более 12 мс, к числу кадров, обработка которых заняла свыше 16 мс.
• Медленная загрузка растровых изображений. Отношение количества случаев, когда растровое изображение загружалось в графический процессор дольше 3,2 мс, к количеству фреймов, обработка которых заняла более 16 мс.

Устранение неполадок

Если для многих кадров время отрисовки превысило 16 мс, найдите решение этой проблемы на сайте для разработчиков Android.

Интерпретация данных

На странице "Слишком много медленно формирующихся кадров" указан процент сеансов в день, во время которых более 50 % кадров не были сформированы за установленное время отрисовки на устройстве. Приложение должно работать со скоростью 60 кадров в секунду без пропусков и зависаний.

Сведения о сборе данных

Google собирает информацию о фреймах, обработанных с помощью UI Toolkit, а не с помощью OpenGL или Vulkan напрямую.

Информация на панели управления

Данные в каждой строке представлены в процентилях.

• Затронуто сеансов. Процент сеансов в день, в течение которых время формирования более 50 % кадров превысило 16 мс. Учитываются дни, когда ваше приложение использовалось. Например, если два человека пользовались приложением в течение двух дней, число сеансов равно четырем.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. Время обработки 90 % или 99 % всех фреймов в отчете было меньше указанного значения. Эти показатели рассчитываются на основе всей собранной информации о фреймах.

Нажав на запись в таблице, вы увидите диаграмму "Распределение времени отрисовки интерфейса". Для большинства фреймов время отрисовки должно составлять 16 мс или меньше.

Данные под диаграммой помогут вам выяснить причины проблем с загрузкой интерфейса. Например, высокое значение показателя "Большая задержка ввода" говорит о том, что следует внести изменения в тот раздел кода, который отвечает за события ввода. Подробную информацию о перечисленных ниже показателях вы найдете в этой статье.

• Пропущенные события Vsync. Количество пропущенных событий Vsync, разделенное на число кадров, обработка которых заняла более 16 мс.
• Большая задержка ввода. Отношение количества событий ввода, которые заняли более 24 мс, к числу кадров, обработка которых заняла свыше 16 мс.
• Медленный поток UI. Отношение количества потоков UI, выполнение которых заняло более 8 мс, к числу кадров, формирование которых заняло свыше 16 мс.
• Медленные команды на отрисовку. Отношение количества случаев, когда отправка команды на отрисовку в графический процессор заняла более 12 мс, к числу кадров, обработка которых заняла свыше 16 мс.
• Медленная загрузка растровых изображений. Отношение количества случаев, когда растровое изображение загружалось в графический процессор дольше 3,2 мс, к количеству фреймов, обработка которых заняла более 16 мс.

Устранение неполадок

Если для многих кадров время отрисовки превысило 16 мс, найдите решение этой проблемы на сайте Android для разработчиков.

На страницах Зависшие частичные запреты блокировки и Зависшие фоновые частичные запреты блокировки показаны сведения о срабатывании частичного запрета блокировки через класс PowerManager. При частичном запрете блокировки процессор продолжает работать, а подсветка клавиатуры и экран выключаются.

Сведения о сборе данных

• Для обеспечения конфиденциальности из тегов частичного запрета блокировки удаляется личная информация.
• Данные о работе частичного запрета блокировки собираются, когда экран выключен и устройство не заряжается.
• Данные о зависших фоновых частичных запретах блокировки собираются, только когда приложение работает в фоновом режиме.
• Чтобы показать количество сеансов, во время которых долго работал частичный запрет блокировки, рассчитывается максимальный период активности этой функции за сеанс без зарядки. Например, если пользователь дважды включит эту функцию на один час, то максимальный период ее действия составит час.
• Если в файлах манифеста приложений заданы идентификаторы sharedUserId, данные появятся только при условии, что идентификаторы установленных приложений не повторяются.

Сведения Android Vitals

• Затронуто сеансов. Процент сеансов без зарядки, во время которых запрет блокировки работал больше часа.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. В ходе 10 % или 1 % сеансов в день продолжительность частичных запретов блокировки превысила указанное значение.
• Порог соответствия. Если частота возникновения равна указанному порогу или выше его, приложение попадает в последние 25 % из 1000 самых популярных приложений в Google Play (по количеству установок).

Устранение неполадок

Если в вашем приложении часто возникают зависшие частичные запреты блокировки, найдите решение этой проблемы на сайте для разработчиков Android.

На странице Слишком частое пробуждение показаны сведения о пробуждении с помощью Alarm Manager. Вы увидите данные для класса ELAPSED_REALTIME_WAKEUP или RTC_WAKEUP.

Сведения о сборе данных

• Для обеспечения конфиденциальности из тегов пробуждения удаляется личная информация.
• Данные собираются, когда устройство не заряжается.
• Число активаций функции пробуждения сравнивается с длительностью сеанса без зарядки. Чтобы определить число пользователей, у которых она срабатывает слишком часто, рассчитывается количество ее активаций в час для каждого человека.
• Если в файлах манифеста приложений заданы идентификаторы sharedUserId, данные появятся только при условии, что идентификаторы установленных приложений не повторяются.

Сведения Android Vitals

• Затронуто сеансов. Процент сеансов без зарядки, во время которых пробуждение срабатывало чаще 10 раз в час. Сеанс без зарядки – это совокупность всех отчетов о работе батареи, полученных в течение 24 часов. В Android 10 отчет о работе батареи составляется для интервала между двумя зарядками от уровня ниже 20 до 80 % и выше или от любого уровня до 100 %. В Android 11 и более поздних версиях составляется отчет за фиксированный период, который длится 24 часа. Google собирает данные, когда батарея не заряжается.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. В ходе 10 % или 1 % сеансов в день частота пробуждения в час превысила указанное значение.
• Порог соответствия. Если частота возникновения равна указанному порогу или выше его, приложение попадает в последние 25 % из 1000 самых популярных приложений в Google Play (по количеству установок).

Устранение неполадок

Если пробуждение срабатывает слишком часто, найдите решение этой проблемы на сайте для разработчиков Android.

На странице Слишком частое фоновое сканирование Wi-Fi показано, когда сканирование Wi-Fi быстро разряжает батарею.

Сведения о сборе данных

Данные сканирования Wi-Fi собираются, когда устройство не заряжается, а приложение находится в фоновом режиме.

Сведения Android Vitals

• Затронуто сеансов. Процент сеансов без зарядки, во время которых выполнялось более четырех сканирований Wi-Fi в час.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. В ходе 10 % или 1 % сеансов в день частота фонового сканирования Wi-Fi в час превысила указанное значение.

Устранение неполадок

Если фоновое сканирование Wi-Fi происходит слишком часто, найдите решение этой проблемы на сайте Android для разработчиков.

На странице Избыточный мобильный трафик показано, когда большой объем мобильного трафика связан с работой в фоновом режиме. Если приложение потребляет мобильный трафик в фоновом режиме, пользователи не могут быстро остановить передачу данных.

Сведения о сборе данных

Данные об объеме мобильного трафика собираются, когда устройство не заряжается, а приложение находится в фоновом режиме.

Сведения Android Vitals

• Затронуто сеансов. Процент сеансов без зарядки, во время которых объем фонового мобильного трафика превышал 50 МБ в час за день.
• Количество сеансов. Приблизительное количество записанных сеансов.
• 90-й или 99-й процентиль. В ходе 10 или 1 % сеансов в день объем фонового мобильного трафика в час превысил указанное значение.

Устранение неполадок

Если объем фонового мобильного трафика слишком высокий, найдите решение этой проблемы на сайте для разработчиков Android.

На странице Отклоненные разрешения указан процент сеансов с разрешениями в день, в течение которых пользователи отклоняли запросы разрешений. Сеанс с разрешением – это день, в течение которого ваше приложение запрашивало у пользователя хотя бы одно разрешение.

Сведения о сборе данных

Сведения об отклоненных разрешениях собираются, когда пользователи отвечают на запросы разрешений в вашем приложении.

Сведения Android Vitals

• Отклонения. Процент сеансов с разрешениями в день, в течение которых пользователи отклоняли запросы разрешений.
• Больше не спрашивать. Процент сеансов с разрешениями в день, в течение которых пользователи отклоняли запросы разрешений и выбирали "Больше не спрашивать".
• Общее количество сеансов. Приблизительное количество записанных сеансов.

Устранение неполадок

Если в вашем приложении часто отклоняют запросы разрешений, найдите решение этой проблемы на сайте Android для разработчиков.

В Google Play определены следующие пороги соответствия для доли ошибок ANR в активном режиме:

• Существенные неполадки (в целом). Как минимум 0,47 % активных пользователей за день сталкиваются с ошибками ANR в активном режиме на любых моделях устройств.

• Существенные неполадки (по модели устройства). Как минимум 8 % активных пользователей за день сталкиваются с ошибками ANR в активном режиме на определенной модели устройства.

Чтобы улучшить показатель доли ошибок ANR, устраните неполадки из кластеров на странице Сбои и ошибки ANR. Чем выше количество затронутых пользователей в кластере, тем больше он влияет на долю ошибок ANR.

Если обнаружится, что определенные элементы аппаратного или программного обеспечения устройства могут влиять на долю ошибок ANR, вам придет уведомление от Android Vitals. Связь этих элементов с неполадками можно изучить самостоятельно на странице Общие сведения об охвате и использовании устройств (Выпуск > Охват и устройства > Общие сведения).

В Google Play определены следующие пороги соответствия для доли сбоев в активном режиме:

• Существенные неполадки (в целом). Как минимум 1,09 % активных пользователей за день сталкиваются со сбоями в активном режиме на любых моделях устройств.

• Существенные неполадки (по модели устройства). Как минимум 8 % активных пользователей за день сталкиваются со сбоями в активном режиме на определенной модели устройства.

Чтобы улучшить показатель доли сбоев, устраните неполадки из кластеров на странице Сбои и ошибки ANR. Чем выше количество затронутых пользователей в кластере, тем больше он влияет на долю сбоев.

Если обнаружится, что определенные элементы аппаратного или программного обеспечения устройства могут влиять на долю сбоев, вам придет уведомление от Android Vitals. Связь этих элементов с неполадками можно изучить самостоятельно на странице Общие сведения об охвате и использовании устройств (Выпуск > Охват и устройства > Общие сведения).