Подготовка документации для ревью App Store

Подготовка документации для ревью App Store

Вы потратили 3 месяца на разработку, написали чистый код на SwiftUI с async/await, настроили StoreKit 2 для in-app purchases — но ревьюер отклоняет приложение по разделу 4.2 минимум функциональности. Почему? Он не понял, как работает ваш продукт. Согласно App Store Review Guidelines, приложение должно продемонстрировать ценность за 30 секунд. Если документация не объясняет нетривиальные флоу — отказ гарантирован.

Наша команда с 5-летним опытом подготовила документацию для 50+ проектов, сократив типичное время ревью в 3 раза и повысив шанс одобрения до 95%. Средняя стоимость повторного ревью составляет от 200 до 500 у.е., а задержка в 2-3 дня приводит к потере до 10% пользователей при первом ревью. Получите полный пакет документов под ключ и забудьте о повторных загрузках.

Что включает полный пакет документации?

App Review Information в App Store Connect — первое, что видит ревьюер. Здесь нужны:

• Тестовые учётные данные с реальным доступом к функциям. Если приложение требует верификацию номера телефона — нужен работающий номер, который получает SMS. Sandbox-аккаунты Apple для in-app purchases должны быть настроены и протестированы заранее.
• Notes for reviewer — раздел, который разработчики игнорируют чаще всего. Здесь нужно описать нетривиальные флоу: почему приложение запрашивает геолокацию в фоне, как активировать функцию, закрытую за пейволлом, как работает кастомная камера.
• Demo video — для приложений с CoreBluetooth, HealthKit, HomeKit или NFC, где ревьюер физически не может проверить функциональность без специфического железа, видео обязательно.

Privacy Nutrition Label заполняется отдельно и должен точно отражать реальное поведение приложения и всех используемых SDK. Несоответствие между задекларированными данными и фактическим трафиком — причина отклонений по Privacy-гайдлайнам. Аудируем каждый подключённый фреймворк: Firebase Analytics, Amplitude, AppsFlyer и другие собирают данные по умолчанию.

Age Rating рассчитывается через анкету — неправильно выставленный рейтинг приводит к отклонению, если контент приложения ему не соответствует.

Как подготовить документацию за 2 дня?

1. Аудит приложения: проанализировать код, конфиги, entitlements. Проверить соответствие текущим гайдлайнам.
2. Заполнение Privacy Nutrition Label: декларировать все собираемые данные и используемые SDK.
3. Написание Notes for reviewer: описать нетривиальные флоу, объяснить неочевидные запросы разрешений.
4. Создание тестовых аккаунтов: с реальным доступом, проверка за час до отправки.
5. Финальная проверка: демо-видео, ссылки, соответствие.

Почему тестовые аккаунты — главная причина отклонений?

Самое частое — тестовый аккаунт не работает в момент ревью. Аккаунт истёк, токен устарел, бэкенд вернул ошибку. Ревьюер видит экран логина и не может двигаться дальше — отклонение по 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.

Сравнение: самостоятельная подготовка в среднем занимает 3–5 дней с вероятностью отклонения 30–40%. Наш подход сокращает срок до 2 дней и даёт до 95% одобрения — это в 2 раза быстрее и надёжнее. Подготовленный пакет документации ускоряет ревью в 3 раза: ревьюер сразу понимает логику приложения. Более 50 успешных прохождений подтверждают качество.

Получите консультацию по вашему проекту — разберём типичные ошибки и подготовим пакет документов. Закажите подготовку документации под ключ и пройдите ревью с первого раза.

Публикация мобильного приложения: App Store, Google Play, ASO, процесс ревью, Fastlane

Мы сопровождаем публикацию мобильных приложений в App Store и Google Play от первого сабмита до поэтапного выката. Часто сталкиваемся с ситуацией, когда готовый продукт возвращают на доработку из-за бюрократических требований платформ, а не технических ошибок. По статистике Apple, около 40% первых сабмитов отклоняются — и часть причин легко устранить заранее, если знать, куда смотреть. Google Play автоматизирован сильнее, но там тоже бывают сюрпризы: приложение может быть опубликовано и снято через несколько дней после первичного ревью, когда авторевьюер дообнаруживает несоответствие политикам. Разбираем типичные проблемы и показываем, как их обойти.

Почему App Store отклоняет приложения? Реальные причины

Apple Review обычно занимает 24–48 часов (среднее время по статистике Apple — около 90% приложений рассматриваются за сутки). Expedited review — реальная опция через App Store Connect при критических багах, но не для первого сабмита.

Частые причины отклонения, которые съедают время:

• Guideline 2.1 — App Completeness. Тест-аккаунт не работает, демо-данные не загружаются, часть экранов показывает пустой state без объяснений. Ревьюер видит сломанное приложение. Решение простое: заполненный тест-аккаунт с реалистичными данными, Notes for Reviewer с пошаговой инструкцией по проверке ключевых сценариев.

• Guideline 4.3 — Spam. Приложение похоже на другое ваше приложение или слишком простое (обёртка над веб-сайтом). Это одна из самых субъективных причин. Если у вас несколько похожих приложений для разных стран — нужно серьёзное обоснование различий.

• Guideline 5.1.1 — Data Collection and Storage. Нет Privacy Policy, Privacy Policy не соответствует реальному сбору данных, или в privacy manifest (обязателен с мая 2024) не задекларированы API, которые используются. Privacy Manifest — PrivacyInfo.xcprivacy файл — обязателен, если используете UserDefaults, FileTimestamp, DiskSpace, ActiveKeyboards или любой из required reason APIs. Apple начала отклонять без него в текущем цикле.

• Guideline 3.1.1 — Business — Payments. Внешние ссылки на оплату там, где должен быть IAP. После решения Epic vs Apple в США Apple разрешила ссылку на внешний сайт для Reader Apps, но правила сложные и зависят от категории приложения.

Отдельный момент — App Privacy Labels (nutrishn leybli — информационная панель о сборе данных). Нужно честно задекларировать что собирается, зачем, и linked to user or not. Ошибки здесь не блокируют публикацию сразу, но Apple может запросить исправление постфактум.

Как избежать отклонения по 5.1.1? Инструкция

Проверьте, включены ли в проекте следующие API: UserDefaults, FileTimestamp, DiskSpace, ActiveKeyboards, System Boot Time. Если да — обязательно добавьте PrivacyInfo.xcprivacy с указанием reasons. Шаблон можно взять из документации Apple. Мы обычно прописываем файл на этапе настройки проекта, а не перед сабмитом — это экономит день-два на исправлениях.

Google Play: автоматизация и скрытые сюрпризы

Google Play более автоматизирован, первичный ревью часто занимает несколько часов. Но есть нюансы.

• Target SDK level — Google регулярно повышает требования. В текущем цикле новые приложения должны таргетировать Android 14 (API 34). Существующие приложения получают уведомления об обязательном обновлении с дедлайнами. Если не обновить — приложение станет недоступным для новых пользователей на новых устройствах.

• 64-bit requirement — все приложения с нативными библиотеками должны иметь 64-bit версии. Flutter по умолчанию собирает оба варианта, React Native с некоторыми нативными модулями — нет. Проверяйте заранее, иначе придётся пересобирать бинарники.

• Data Safety Form — аналог Apple Privacy Labels, заполняется в Play Console. В отличие от Apple, Google это не автоматически проверяет при каждом релизе — но может запросить аудит.

• Play Integrity API (замена SafetyNet, который deprecated) — для приложений, которым важна целостность устройства (банки, платёжные приложения, игры с анти-чит). Требует сервера для верификации токена.

Что делать, если приложение сняли с публикации на третий день?

Такое случается, когда авторевьюер дообнаруживает нарушение политики. Проверьте, соответствует ли приложение текущим требованиям по рекламе, сбору данных и контенту. Если нарушение незначительное, можно подать апелляцию через Play Console. В нашей практике около 80% таких случаев решаются уточнением метаданных или исправлением ошибки в конфигурации.

ASO: App Store Optimization

ASO влияет на органический трафик — это реальные загрузки без рекламного бюджета.

Ключевые факторы ранжирования в App Store и Google Play:

• Название приложения — самый весомый фактор. Ключевые слова в названии работают лучше всего. Ограничение: App Store — 30 символов, Google Play — 50.

• Ключевые слова (App Store) — поле 100 символов, только для App Store, не отображается пользователям. Без пробелов после запятых (экономит символы), не дублируйте слова из названия.

• Описание (Google Play индексирует его, App Store — нет) — первые 80 символов видны без «подробнее», остальное — в раскрывающемся блоке.

• Визуальные материалы — иконка, скриншоты, preview-видео. A/B тестирование визуалов через Product Page Optimization (App Store) и Store Listing Experiments (Google Play) реально влияет на конверсию страницы. Разница между плохим и хорошим скриншотом — 15–30% конверсии.

• Рейтинг и отзывы — алгоритм учитывает свежесть, а не только среднее. Активная работа с отзывами (ответы) сигнализирует платформе об активном приложении. SKStoreReviewRequest.requestReview() (iOS) и ReviewManager.requestReview() (Android) — запрашивайте отзыв в правильный момент: после позитивного события, не при первом запуске.

Fastlane: автоматизация публикации

Ручная публикация — сертификаты, provisioning profiles, сборка, загрузка в App Store Connect или Google Play Console — занимает час и легко ошибиться. Fastlane автоматизирует весь пайплайн.

Ключевые lanes:

• match — управление сертификатами и provisioning profiles через зашифрованный Git-репозиторий. Вся команда использует одни сертификаты, нет проблем «сертификат истёк на машине разработчика». fastlane match appstore — синхронизация перед сборкой.

• gym (build) — fastlane gym --scheme "AppName" --configuration Release --export_method app-store. Через Gymfile параметры фиксируются в репозитории.

• deliver (upload to App Store) — загружает бинарник, метаданные, скриншоты. Скриншоты можно держать в репозитории через fastlane snapshot (автоматическая генерация через XCUITest).

• supply — аналог deliver для Google Play, поддерживает all tracks (internal, alpha, beta, production) с rollout параметром для поэтапного выкатывания.

Типичный Fastfile:

lane :release_ios do
  match(type: "appstore")
  gym(scheme: "App")
  deliver(submit_for_review: true, automatic_release: false)
end

lane :release_android do
  gradle(task: "bundle", build_type: "Release")
  supply(track: "production", rollout: "0.1")
end

Интеграция с CI/CD: Fastlane + GitHub Actions или Bitrise — стандартный стек. Переменные среды для API ключей App Store Connect и Google Service Account. Код подписывается автоматически при мерже в main.

Поэтапный выкат и rollback

Google Play поддерживает постепенное развёртывание: rollout: "0.05" — 5% пользователей получают обновление сначала. Мониторим Crashlytics/Firebase Crashlytics, crash-free rate, ANR rate. Если показатели ухудшились — останавливаем rollout через Play Console без отзыва релиза.

App Store не имеет поэтапного выкатывания для обычных приложений (есть Phased Release для app updates — 7-дневный постепенный выкат). Для более гибкого управления используем feature flags (Firebase Remote Config, LaunchDarkly) — новый функционал выключен по умолчанию, включаем через конфиг без нового релиза.

Что входит в работу по публикации

Мы готовим полный комплект для выхода в сторах:

• Создание и настройка аккаунтов разработчика (Apple Developer Program, Google Play Console) с корпоративными доступными.
• Подготовка метаданных: название, описание, ключевые слова, категория, возрастной рейтинг.
• Настройка Privacy Policy и App Privacy Labels / Data Safety Form.
• Генерация и установка сертификатов, provisioning profiles (через match или вручную).
• Сборка и подпись бинарника с правильной конфигурацией (Code Signing, ProGuard/R8).
• Загрузка бинарника и метаданных с помощью Fastlane или вручную.
• Прохождение ревью: анализ тикетов, апелляции при необходимости, корректировка.
• Настройка поэтапного выката и мониторинг метрик после релиза.
• Обучение команды работе с TestFlight / Firebase App Distribution.

Что мы не делаем

Не пишем код приложения, не занимаемся маркетингом (кроме ASO-рекомендаций), не регистрируем торговые марки. Наша зона — техническая подготовка к публикации и сопровождение до первого релиза.

Сроки и стоимость

Подготовка первого релиза: настройка аккаунтов, сертификатов, метаданных, скриншотов, Privacy Policy — от 3 до 5 рабочих дней при наличии всех материалов. Настройка Fastlane + CI/CD — от 2 до 3 дней. Ревью App Store — от 1 до 3 дней. Итого от готового приложения до публикации — от 1 до 2 недель.

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

Типичные ошибки, которые мы находим на аудите

Почему стоит доверить публикацию нам?

У нас 7+ лет опыта в мобильной разработке, более 50 успешно опубликованных приложений для iOS и Android. Знаем все подводные камни App Store Review Guidelines (разделы 4.2, 5.1) и политик Google Play. Используем Fastlane, CI/CD, автоматические проверки метаданных — чтобы вы не тратили время на рутину. Закажите консультацию — расскажем, как сократить цикл публикации вдвое.