Підготовка документації для рев'ю App Store
Ви витратили 3 місяці на розробку, написали чистий код на SwiftUI з async/await, налаштували StoreKit 2 для in-app purchases — але рев'ювер відхиляє додаток за розділом 4.2 мінімум функціональності. Чому? Він не зрозумів, як працює ваш продукт. Згідно з App Store Review Guidelines, додаток має продемонструвати цінність за 30 секунд. Якщо документація не пояснює нетривіальні флоу — відмова гарантована.
Наша команда з 5-річним досвідом підготувала документацію для 50+ проєктів, скоротивши типовий час рев'ю в 3 рази та підвищивши шанс схвалення до 95%. Затримка в 2-3 дні при повторному рев'ю призводить до втрати до 10% користувачів. Отримайте повний пакет документів під ключ і забудьте про повторні завантаження.
Що включає повний пакет документації?
App Review Information в App Store Connect — перше, що бачить рев'ювер. Тут потрібні:
- Тестові облікові дані з реальним доступом до функцій. Якщо додаток вимагає верифікацію номера телефону — потрібен робочий номер, який отримує SMS. Sandbox-акаунти Apple для in-app purchases мають бути налаштовані та протестовані заздалегідь.
- Notes for reviewer — розділ, який розробники ігнорують найчастіше. Тут потрібно описати нетривіальні флоу: чому додаток запитує геолокацію в фоні, як активувати функцію, закриту за пейволлом, як працює кастомна камера.
- Demo video — для додатків із CoreBluetooth, HealthKit, HomeKit або NFC, де рев'ювер фізично не може перевірити функціональність без специфічного заліза, відео обов'язкове.
| Документ | Призначення | Обов'язковість |
|---|---|---|
| App Review Information | Інструкція для рев'ювера | Обов'язково |
| Privacy Nutrition Label | Декларація збору даних | Обов'язково |
| Age Rating | Віковий рейтинг | Обов'язково |
| Demo Video | Демонстрація роботи із залізом | Якщо потрібно |
Privacy Nutrition Label заповнюється окремо і має точно відображати реальну поведінку додатку та всіх використовуваних SDK. Невідповідність між задекларованими даними та фактичним трафіком — причина відхилень за Privacy-гайдлайнами. Аудируємо кожен підключений фреймворк: Firebase Analytics, Amplitude, AppsFlyer та інші збирають дані за замовчуванням.
Age Rating розраховується через анкету — неправильно виставлений рейтинг призводить до відхилення, якщо контент додатку йому не відповідає.
Як підготувати документацію за 2 дні?
- Аудит додатку: проаналізувати код, конфіги, entitlements. Перевірити відповідність поточним гайдлайнам.
- Заповнення Privacy Nutrition Label: декларувати всі дані, що збираються, та використовувані SDK.
- Написання Notes for reviewer: описати нетривіальні флоу, пояснити неочевидні запити дозволів.
- Створення тестових акаунтів: з реальним доступом, перевірка за годину до відправки.
- Фінальна перевірка: демо-відео, посилання, відповідність.
Чому тестові акаунти — головна причина відхилень?
Найчастіше — тестовий акаунт не працює в момент рев'ю. Акаунт закінчився, токен застарів, бекенд повернув помилку. Рев'ювер бачить екран логіну і не може рухатися далі — відхилення за 2.1 (App Completeness). За нашою статистикою, 80% відмов пов'язані з недоліками документації, з них половина — через несправні акаунти. Перевіряємо акаунт за годину до відправки та використовуємо довгоживучі токени.
Типові провали в документації
Друге за частотою — додаток потребує зовнішнє залізо (BLE-пристрій, NFC-мітку, специфічний QR-код) і немає ні відео, ні пояснення. Рев'ювер не зобов'язаний вгадувати. Наприклад, один клієнт — додаток для розумного дому на CoreBluetooth — отримав відмову через відсутність демо-відео. Ми додали відео та Notes, після чого додаток пройшов рев'ю з першого разу.
Третє — не задокументовано використання камери або мікрофона поза очевидним контекстом. Якщо додаток — не месенджер і не відеоредактор, а десь углибині є запис аудіо для аналітики — це потрібно пояснити в Notes.
Як ми готуємо документацію
До пакету входить аудит додатку на відповідність поточним App Store Review Guidelines. Перевіряємо всі entitlements в Entitlements.plist та відповідність задекларованим capabilities в App Store Connect. Складаємо Notes for reviewer з описом кожного нестандартного поведінки.
Окремо — перевірка NSPrivacyAccessedAPITypes в PrivacyInfo.xcprivacy, який став обов'язковим з iOS 17 для використання ряду системних API, включаючи UserDefaults, FileTimestamp, SystemBootTime.
| Етап | Тривалість | Що робимо |
|---|---|---|
| Аналіз додатку | 1 день | Вивчаємо код, конфіги, entitlements |
| Аудит документації | 0.5 дня | Звіряємо наявні документи з вимогами |
| Підготовка пакету | 1 день | Пишемо Notes, збираємо Privacy Label, тестуємо |
| Фінальна перевірка | 0.5 дня | Перевіряємо акаунти, відео, відповідність |
Порівняння: самостійна підготовка в середньому займає 3–5 днів з імовірністю відхилення 30–40%. Наш підхід скорочує термін до 2 днів і дає до 95% схвалення — це в 2 рази швидше та надійніше. Підготовлений пакет документації прискорює рев'ю в 3 рази: рев'ювер одразу розуміє логіку додатку. Понад 50 успішних проходжень підтверджують якість.
Отримайте консультацію щодо вашого проєкту — розберемо типові помилки та підготуємо пакет документів. Замовте підготовку документації під ключ і пройдіть рев'ю з першого разу.