Як відстежувати технічну якість додатка за допомогою функції Android Vitals

Натисніть Переглянути деталі () біля показника, щоб дізнатися більше про нього, зокрема переглянути наведені нижче дані.

• Порогові значення шкідливих процесів
• Порівняння для категорії
• Докладне порівняння з аналогами
  • Щоб змінити власну групу аналогів, угорі сторінки на картці порівняння з іншими додатками виберіть Редагувати групу аналогів. Так ви зможете самі обрати, з якими додатками в Google Play порівнювати показники свого додатка.
• Динаміка показника

Показники частки помилок ANR дають змогу оцінити якість додатка. Вони обчислюються за допомогою нормалізації кількості користувачів із помилками ANR на основі даних про використання додатка. Ці показники реєструються як відсоток активних користувачів за день, де активний користувач за день – це користувач, який за один день запускає додаток на одному пристрої. Якщо користувач запускає ваш додаток на кількох пристроях за день, то кожний пристрій зараховується як активний користувач за цей день. Якщо додаток матиме кількох користувачів на тому самому пристрої протягом одного дня, буде зараховано лише одного активного користувача.

Є три показники частки помилок ANR. Їх описано нижче.

• Частка помилок ANR, помічених користувачами: відсоток активних користувачів за день, які помітили принаймні одну помилку ANR. Помилка ANR, помічена користувачем, – це помилка, яку користувач, імовірно, помітив. Наразі враховуються лише помилки ANR типу "час очікування надсилання введених даних минув". Цей показник завжди нижчий за загальну частку помилок ANR, оскільки він нормалізується за щоденним використанням, але не враховує всі помилки ANR.
  Частка помилок ANR, помічених користувачами, – це один з основних показників, які впливають на видимість вашого додатка в Google Play. Цей показник важливий, бо підраховує найприкріші для користувачів помилки ANR – ті, що трапляються під час активної взаємодії з додатком.
• Частка помилок ANR: відсоток користувачів за день, у яких сталася принаймні одна помилка ANR. Цей показник включає помилки ANR, які не класифікуються як помічені користувачами, однак ми не можемо гарантувати, що вони не створюють їм незручностей.
• Частка сеансів із повторними помилками ANR: відсоток користувачів за день, у яких сталося принаймні дві помилки ANR. Цей показник допомагає виявити повторювані проблеми.

Як вирішити проблему

Помилки ANR, які впливають на показники частки помилок ANR, наведено на сторінці Збої та помилки ANR. Ви можете відфільтрувати дані на цій сторінці, щоб переглянути лише помилки ANR, помічені користувачами.

На сайті для розробників Android наведено рекомендації з діагностики й виправлення помилок ANR.

Показники частки збоїв дають змогу оцінити якість додатка. Вони обчислюються за допомогою нормалізації кількості користувачів зі збоями на основі даних про використання додатка. Ці показники реєструються як відсоток користувачів за день, де користувач за день – це користувач, який за один день запускає додаток на одному пристрої. Якщо в користувача більше ніж один пристрій, то відповідно його буде зараховано більше ніж один раз. Наприклад, якщо двоє людей користуються додатком протягом двох днів (кожен на своєму пристрої), то зараховуються чотири добові сеанси.

Є три показники частки збоїв. Їх описано нижче.

• Частка збоїв, помічених користувачами: відсоток користувачів за день, які помітили принаймні один збій. Збій, помічений користувачем, – це збій, який користувач, імовірно, помітив. Наприклад, це можуть бути збої, які виникають, коли додаток демонструє активність або працює як активний сервіс. Цей показник завжди нижчий за загальну частку збоїв, оскільки він нормалізується за щоденним використанням, але не враховує всі збої.
  Частка збоїв, помічених користувачами, – це один з основних показників, які впливають на видимість вашого додатка в 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 кадрів/с забезпечує оптимальну взаємодію, іноді може бути доцільно зменшити цей показник, наприклад для користувачів, які хочуть грати у вашу гру на телефонах, що не підтримують частоту 30 кадрів/с. У таких випадках принаймні 75% кадрів за сеанс мають візуалізуватися з частотою 20 кадрів/с або більше. Відстежуйте показник частки повільних сеансів (20 кадрів/с), щоб переконатися, що він досягається.

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

Функція Android Vitals починає відстежувати частоту кадрів через 1 хвилину після запуску гри.

Докладніше про збирання даних

Показник повільних сеансів обчислюється на основі даних, отриманих із SurfaceFlinger. Загалом частота кадрів сеансу залежить від інтервалу між кадрами, відтвореними на платформах, що належать додатку, і включає кадри, візуалізовані за допомогою OpenGL, Vulkan, а також інструментів розробки інтерфейсу Android. Наразі цей показник доступний лише для ігор.

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

Дані на інформаційній панелі

• Типова частота кадрів: частота кадрів для гри на пристроях з Android 9 або новіших версій, обчислена в 75-му процентилі. Це означає, що 75% сеансів мали таку або вищу частоту кадрів протягом 75% часу.
• Частка повільних сеансів за період: це часовий ряд, що показує відсоток сеансів, які вважаються повільними.
• Розподіл частоти кадрів: гістограма, що показує частоту кадрів, обчислену в 75-му процентилі для всіх сеансів. Це означає, що на гістограмі сеанс відноситься до частоти кадрів, яка перевищувалася для 75% кадрів у цьому сеансі.

Як вирішити проблему

Якщо в додатку часто виникають повільні сеанси, перегляньте рекомендовані рішення на сайті для розробників Android.

Що означають ці дані

На сторінці "Забагато повільних кадрів" показано дані про відсоток добових сеансів, під час яких понад 50% кадрів не було оброблено за встановлений на пристрої час візуалізації. Взаємодія користувачів із додатком має відбуватись із частотою 60 кадрів на секунду без пропущених або затриманих кадрів.

Докладніше про збирання даних

Google фіксує час візуалізації тільки для кадрів, які візуалізуються через фреймворк інструментів для розробки інтерфейсу. Дані про кадри, візуалізовані за допомогою OpenGL або Vulkan, не збираються.

Дані на інформаційній панелі

Якщо вибрати рядок, відобразяться дані, розбиті за процентилями.

• Сеанси, що відповідають критеріям: відсоток добових сеансів, під час яких понад 50% кадрів візуалізувалися довше ніж за 16 мс. Добовий сеанс – це день, коли використовувався додаток. Наприклад, якщо двоє людей користуються додатком протягом двох днів, зараховуються чотири добові сеанси.
• Кількість сеансів: приблизна кількість записаних сеансів.
• 90/99-й процентиль: 90/99% усіх кадрів візуалізувалися швидше за вказане значення. Ці показники ґрунтуються на даних усіх зібраних кадрів.

Якщо натиснути запис у таблиці, з’явиться діаграма "Розподіл часу візуалізації інтерфейсу". На ній показник для більшості кадрів додатка не має перевищувати 16 мс.

Дані, наведені під діаграмою, показують ефективність візуалізації додатка. Крім того, завдяки цим даним можна виявити причину проблем із часом візуалізації. Наприклад, якщо показник "Велика затримка вводу" високий, варто перевірити код додатка, що відповідає за обробку введених користувачем даних. Дізнатися більше про ці показники можна в статті про перевірку продуктивності інтерфейсу.

• Пропущені події Vsync: для всіх кадрів із часом візуалізації понад 16 мс це кількість пропущених подій Vsync, поділена на кількість кадрів.
• Велика затримка вводу: для всіх кадрів із часом візуалізації понад 16 мс це кількість подій вводу тривалістю понад 24 мс, поділена на кількість кадрів.
• Повільний потік інтерфейсу: для всіх кадрів із часом візуалізації понад 16 мс це кількість потоків інтерфейсу тривалістю понад 8 мс, поділена на кількість кадрів.
• Повільна реакція на команди відрисовки: для всіх кадрів із часом візуалізації понад 16 мс це кількість випадків, коли команди відрисовки надсилалися на графічний процесор довше ніж за 12 мс, поділена на кількість кадрів.
• Повільні завантаження бітових карт: для всіх кадрів із часом візуалізації понад 16 мс це кількість випадків, коли бітова карта завантажувалась у графічний процесор довше ніж за 3,2 мс, поділена на кількість кадрів.

Як вирішити проблему

Якщо в додатку багато кадрів із часом візуалізації понад 16 мс, перегляньте рекомендовані рішення на сайті для розробників Android.

Що означають ці дані

На сторінці "Забагато повільних кадрів" показано дані про відсоток добових сеансів, під час яких понад 50% кадрів не було оброблено за встановлений на пристрої час візуалізації. Взаємодія користувачів із додатком має відбуватись із частотою 60 кадрів на секунду без пропущених або затриманих кадрів.

Докладніше про збирання даних

Google фіксує час візуалізації тільки для кадрів, які візуалізуються через фреймворк інструментів для розробки інтерфейсу. Дані про кадри, візуалізовані за допомогою OpenGL або Vulkan, не збираються.

Дані на інформаційній панелі

Якщо вибрати рядок, відобразяться дані, розбиті за процентилями.

• Сеанси, що відповідають критеріям: відсоток добових сеансів, під час яких понад 50% кадрів візуалізувалися довше ніж за 16 мс. Добовий сеанс – це день, коли використовувався додаток. Наприклад, якщо двоє людей користуються додатком протягом двох днів, зараховуються чотири добові сеанси.
• Кількість сеансів: приблизна кількість записаних сеансів.
• 90/99-й процентиль: 90/99% усіх кадрів візуалізувалися швидше за вказане значення. Ці показники ґрунтуються на даних усіх зібраних кадрів.

Якщо натиснути запис у таблиці, з’явиться діаграма "Розподіл часу візуалізації інтерфейсу". На ній показник для більшості кадрів додатка не має перевищувати 16 мс.

Дані, наведені під діаграмою, показують ефективність візуалізації додатка. Крім того, завдяки цим даним можна виявити причину проблем із часом візуалізації. Наприклад, якщо показник "Велика затримка вводу" високий, варто перевірити код додатка, що відповідає за обробку введених користувачем даних. Дізнатися більше про ці показники можна в статті про перевірку продуктивності інтерфейсу.

• Пропущені події Vsync: для всіх кадрів із часом візуалізації понад 16 мс це кількість пропущених подій Vsync, поділена на кількість кадрів.
• Велика затримка вводу: для всіх кадрів із часом візуалізації понад 16 мс це кількість подій вводу тривалістю понад 24 мс, поділена на кількість кадрів.
• Повільний потік інтерфейсу: для всіх кадрів із часом візуалізації понад 16 мс це кількість потоків інтерфейсу тривалістю понад 8 мс, поділена на кількість кадрів.
• Повільна реакція на команди відрисовки: для всіх кадрів із часом візуалізації понад 16 мс це кількість випадків, коли команди відрисовки надсилалися на графічний процесор довше ніж за 12 мс, поділена на кількість кадрів.
• Повільні завантаження бітових карт: для всіх кадрів із часом візуалізації понад 16 мс це кількість випадків, коли бітова карта завантажувалась у графічний процесор довше ніж за 3,2 мс, поділена на кількість кадрів.

Як вирішити проблему

Якщо в додатку багато кадрів із часом візуалізації понад 16 мс, перегляньте рекомендовані рішення на сайті для розробників Android.

На сторінках Тривалі часткові блокування переходу в режим сну та Тривалі часткові блокування переходу в режим сну (у фоновому режимі) містяться дані про часткові блокування переходу в режим сну, які додаток застосував через клас PowerManager. Під час часткового блокування переходу в режим сну ЦП працює, однак підсвічування екрана й клавіатури може вимикатися.

Докладніше про збирання даних

• З міркувань конфіденційності з ідентифікаційних тегів часткового блокування переходу в режим сну вилучаються особисті дані.
• Дані про часткові блокування переходу в режим сну збираються, коли пристрій не заряджається й вимкнено екран.
• Дані про тривалі часткові блокування переходу в режим сну (у фоновому режимі) збираються, лише коли додаток працює у фоновому режимі.
• Щоб показати кількість сеансів із тривалим блокуванням, система Google обчислює максимальну тривалість цієї проблеми на сеанс роботи акумулятора. Наприклад, якщо за сеанс відбулося два блокування по одній годині, система Google зарахує як максимальне значення тривалості проблеми одну годину.
• Якщо у файлі маніфесту додатків задано sharedUserId, дані відображатимуться за умови, що ідентифікатори sharedUserId встановлених додатків не повторюються.

Докладніше про показники Android Vitals

• Проблемні сеанси: відсоток сеансів роботи акумулятора, під час яких принаймні одне блокування переходу в режим сну тривало понад годину.
• Кількість сеансів: приблизна кількість записаних сеансів.
• 90/99-й процентиль: тривалість часткового блокування переходу в режим сну, що перевищувалася в 10%/1% добових сеансів.
• Поріг шкідливого процесу: частота проблеми, що перевищується тільки у 25% із 1000 найпопулярніших у Google Play додатків (за кількістю встановлень). Якщо цей показник для вашого додатка не менший, це вимагає негайної уваги.

Як вирішити проблему

Якщо в додатку часто трапляються тривалі часткові блокування переходу в режим сну, перегляньте рекомендовані рішення на сайті розробників Android.

На сторінці Часті виведення з режиму сну відображаються дані про виведення з режиму сну методом Alarm Manager, ініційовані вашим додатком. Дані наводяться для класів ELAPSED_REALTIME_WAKEUP або RTC_WAKEUP.

Докладніше про збирання даних

• З міркувань конфіденційності з ідентифікаційних тегів виведення з режиму сну вилучаються особисті дані.
• Дані про виведення з режиму сну збираються, коли пристрій не заряджається.
• Для нормалізації показника кількість виведень із режиму сну порівнюється з тривалістю сеансу роботи акумулятора пристрою. Google обчислює кількість виведень із режиму сну на годину на одного користувача, щоб показати кількість користувачів із високим значенням цього показника.
• Якщо у файлі маніфесту додатків задано sharedUserId, дані відображатимуться за умови, що ідентифікатори sharedUserId встановлених додатків не повторюються.

Докладніше про показники Android Vitals

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

Як вирішити проблему

Якщо в додатку часто трапляються виведення з режиму сну, перегляньте рекомендовані рішення на сайті розробників Android.

На сторінці Часті пошуки Wi-Fi (у фоновому режимі) відображаються дані про пошуки Wi-Fi, під час яких використовується багато заряду акумулятора.

Докладніше про збирання даних

Дані про пошуки Wi-Fi збираються, коли пристрій не заряджається, а додаток працює у фоновому режимі.

Докладніше про показники Android Vitals

• Проблемні сеанси: відсоток сеансів роботи акумулятора, під час яких пристрій шукав мережі Wi-Fi понад 4 рази на годину.
• Кількість сеансів: приблизна кількість записаних сеансів.
• 90/99-й процентиль: кількість пошуків мереж Wi-Fi у фоновому режимі за годину, що перевищувалася в 10%/1% добових сеансів.

Як вирішити проблему

Якщо додаток часто шукає мережі Wi-Fi у фоновому режимі, перегляньте рекомендовані рішення на сайті для розробників Android.

На сторінці Надмірне використання мобільної мережі можна дізнатися, коли фоновий сервіс передає або приймає великий обсяг даних через мобільну мережу. Якщо дані передаються через мобільну мережу у фоновому режимі, користувачі не можуть легко отримати доступ до елементів керування, щоб зупинити цей процес.

Докладніше про збирання даних

Дані про використання мобільної мережі збираються, коли пристрій не заряджається, а додаток працює у фоновому режимі.

Докладніше про показники Android Vitals

• Проблемні сеанси: відсоток сеансів роботи акумулятора, під час яких додаток у фоновому режимі використовував понад 50 МБ мобільного трафіку на день.
• Кількість сеансів: приблизна кількість записаних сеансів.
• 90/99-й процентиль: рівень використання мобільної мережі у фоновому режимі, що перевищувався в 10%/1% добових сеансів.

Як вирішити проблему

Якщо додаток використовує багато мобільного трафіку у фоновому режимі, перегляньте рекомендовані рішення на сайті розробників Android.

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

Докладніше про збирання даних

Дані про відхилені дозволи збираються, коли користувачі відповідають на запити щодо дозволів у додатку.

Докладніше про показники Android Vitals

• Відмови в дозволах: відсоток добових сеансів із дозволами, під час яких користувачі відмовилиcь надати дозволи.
• Більше не запитувати: відсоток добових сеансів із дозволами, під час яких користувачі відмовились надати дозволи, вибравши опцію "Більше не запитувати".
• Загальна кількість сеансів: приблизна кількість записаних сеансів.

Як вирішити проблему

Якщо додатку часто відмовляють у дозволах, перегляньте рекомендовані рішення на сайті для розробників Android.

У Google Play визначено пороги відповідності для помилок ANR, помічених користувачами.

• Суттєві несправності загалом: принаймні 0,47% активних користувачів за день помічають помилки ANR на всіх моделях пристроїв.

• Суттєві несправності на пристрої: принаймні 8% активних користувачів за день помічають помилку ANR на одній моделі пристрою.

Щоб зменшити частку помилок ANR, усуньте найбільші кластери помилок ANR, наведені на сторінці Збої та помилки ANR. Що більше користувачів стикається з помилкою, то більше кластер впливає на частку помилок ANR.

Якщо певні типи апаратного чи програмного забезпечення пристрою впливають на частку помилок ANR, ви отримаєте сповіщення від Android Vitals. Ви також можете самостійно ознайомитися зі зв’язками на сторінці Огляд охоплення й пристроїв (Випуск > Охоплення й пристрої > Огляд).

У Google Play визначено пороги відповідності для збоїв, помічених користувачами.

• Суттєві несправності загалом: принаймні 1,09% користувачів за день помічають збій на всіх моделях пристроїв.

• Суттєві несправності на пристрої: принаймні 8% користувачів за день помічають збій на одній моделі пристрою.

Щоб зменшити частку збоїв, усуньте найбільші кластери збоїв, наведені на сторінці Збої та помилки ANR. Що більше користувачів стикається зі збоєм, то більше кластер впливає на частку збоїв.

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