Missing Metadata App Store Connect: розблокувати підписку

Missing Metadata в App Store Connect означає, що твоїй підписці або вбудованій покупці бракує щонайменше однієї обов'язкової інформації. Перевір по черзі мову, ціну, тривалість, країни, скріншот для рев'ю та договір для платних застосунків. Поки продукт у цьому статусі, ти не можеш відправити його на рев'ю, а твій застосунок не може його завантажити. До того ж першу підписку треба відправляти разом із версією застосунку.

У мене був цей статус у липні 2026 на TradaZen, моєму симуляторі трейдингу. Нова тижнева підписка мала тривалість, ціну, групу та дві мови. І все одно вона лишалася в «Missing Metadata». Єдиним відсутнім елементом був скріншот для рев'ю. Нижче: причини, які варто перевірити, стани продукту та що розблоковує кожен із них, а потім зв'язок із RevenueCat.

Що означає Missing Metadata?

До цього року довідка Apple визначала цей статус так: продукт створено, але ти ще не надіслав скріншот або не заповнив його метадані. Статус ніколи не каже, якого саме поля бракує. У цьому вся проблема: доводиться шукати.

Увага, у липні 2026 назва змінилася. Примітки до випуску App Store Connect оголошують 15 липня новий спосіб відправлення: кожна вбудована покупка подається зі своєї сторінки, через Add for Review. Сторінка статусів більше не містить «Missing Metadata». Вона починається з «Prepare for Submission» і уточнює: якщо твоїй вбудованій покупці бракує обов'язкових метаданих, заповни їх, перш ніж додавати її до подання. Документація RevenueCat це підтверджує: до рев'ю новий продукт показується як «Prepare for Submission», навіть якщо йому бракує метаданих.

А от API App Store Connect досі повертає MISSING_METADATA, а потім READY_TO_SUBMIT. Тож інструменти, які на ньому працюють, і далі показують ці слова. Хай яка назва, діагноз той самий: якесь обов'язкове поле порожнє.

Причини, які треба перевірити, по черзі

Я перевіряю їх у такому порядку, від сторінки продукту до акаунта.

Причина	Де виправити
Порожня назва або опис	Сторінка продукту
Група без відображуваної назви	Сторінка групи
Немає ціни або тривалості	Сторінка продукту
Жодної доступної країни	Availability
Немає скріншота для рев'ю	Review Information
Неактивний платний договір	Business
Перша підписка відправлена сама	Подання

1. Мова продукту. Згідно з довідкою про інформацію вбудованої покупки, відображувана назва й опис обов'язкові щонайменше однією мовою. Назва має від 2 до 30 символів, опис не більше 45. Продукт без мови відправити не вийде.

2. Мова групи. Група підписок теж має відображувану назву, яку твої підписники бачать, коли керують підписками на iPhone. Вона додається на сторінці групи, у розділі Display Name and Description, як пояснює сторінка Apple про підписки. Поле не виглядає обов'язковим. Проте один розробник розповідає на форумах Apple, що всі підписки його групи були заблоковані, поки воно лишалося порожнім. Статус показується на підписці, а не на групі, звідси й плутанина.

3. Ціна й тривалість. Підписці потрібні тривалість, від тижня до року, і ціна. Технічна нотатка TN3186 починає саме з цього, коли продукт не завантажується: перевірити його ідентифікатор, ціну й мови. Запам'ятай також, що тривалість не можна змінити після відправлення на рев'ю.

4. Доступність. Вибери щонайменше одну країну чи регіон в Availability. Apple уточнює, що без доступності статус «Approved» не з'явиться.

5. Скріншот для рев'ю. Це мій випадок на TradaZen і причина, яка часто трапляється на форумах. Скріншот «App Review Screenshot» показує покупку так, як вона виглядає в застосунку, зазвичай твій paywall. Він потрібен лише рев'юеру і ніколи не показується в App Store. Він має ті самі формати, що й твої скріншоти App Store. Після завантаження його можна замінити, але не видалити.

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

6. Договір для платних застосунків. Щоб пропонувати вбудовані покупки, власник акаунта має підписати Paid Apps Agreement у Business, а потім указати банківські та податкові дані. Це не поле продукту, але від нього залежить усе. Apple пише, що ти не можеш створити нову вбудовану покупку, поки не приймеш останню версію договору. Її сторінка про підготовку покупок до рев'ю додає, що платні покупки не працюють на рев'ю, поки цей договір неактивний. У Business договір, банківський рахунок і податкові форми мають бути активні. Ці кроки детально описані в гайді про акаунт розробника Apple.

7. Першу підписку відправлено саму. Це не відсутні метадані. Але це найпоширеніша причина, чому заповнений продукт так і не потрапляє на рев'ю. Детальніше нижче.

Стани продукту і що розблоковує кожен

Ось чекліст, який я тримаю перед очима. Перша колонка показує стан, який повертає API, друга: назву в довідці Apple з липня 2026.

Стан (API)	Поточна назва	Що розблоковує
MISSING_METADATA	Prepare for Submission	Заповнити поля
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Немає відповідника	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Чекати на Apple
IN_REVIEW	In Review	Чекати на Apple
APPROVED	Approved	Країни й схвалений застосунок
REJECTED	Rejected	Виправити, Update Review

Детально:

• Від Missing Metadata до Ready to Submit. Заповни поля з причин 1-5, збережи, перезавантаж сторінку. Екран, який я бачив у липні, показував «Missing Metadata», а наступний стан називався «Ready to Submit».
• Від Ready to Submit до Ready for Review. На сторінці підписки натисни Add for Review і додай її до наявного подання або до нового. Процедура відправлення вбудованої покупки просить вибрати платформу, версію застосунку і, за потреби, групу. Відтоді можна змінювати лише референсну назву, ціну й доступність.
• Від Ready for Review до Waiting for Review. Перевір, що версія застосунку і група в одному поданні, потім натисни Submit for Review.
• Від Waiting for Review до Approved. Нічого робити не треба, лише тримай свій paywall робочим. Якщо покупка перейшла в «Accepted», а не в «Approved», значить, інший елемент того самого подання відхилено: Apple нічого не схвалює, поки все не прийнято.
• Rejected. Причина з'являється в повідомленнях подання. Виправ елемент, натисни Update Review, потім відправ подання знову.

Перша підписка йде разом із версією застосунку

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

Саме так було з TradaZen. Липнева версія пішла з річною та місячною підписками. Тижнева, ще в «Missing Metadata», лишилася поза поданням. Після схвалення застосунку вона могла піти сама, без нового білда.

Якщо відправиш застосунок без підписки, для її схвалення знадобиться нова версія. Гайд про терміни перевірки в App Store показує, скільки днів коштує цей додатковий цикл.

Зв'язок із RevenueCat: порожня пропозиція

RevenueCat сам нічого не продає. SDK читає ідентифікатори твоїх продуктів зі своїх серверів, а потім запитує продукти в App Store з iPhone. Якщо App Store їх не повертає, пропозиція (offering) приходить порожньою, і твоєму paywall нічого показати. Тоді в журналах SDK з'являється: «There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.»

За словами RevenueCat, продукт із заповненими метаданими завантажується в sandbox ще до рев'ю. Незаповнений не завантажується. Інші підказки від RevenueCat і Apple:

• договір для платних застосунків і банк, поширення яких може зайняти до 24 годин, за даними RevenueCat;
• зміна продукту, яка може дійти до sandbox протягом години, за даними Apple;
• різний ідентифікатор продукту в App Store Connect, RevenueCat і твоєму коді.

На TradaZen код ховає картку підписки, чий продукт не повернувся, не ламаючи paywall. У жовтні 2026 я бачив paywall без пропозиції з іншої причини: пропозиція, прочитана з кешу SDK, була порожня. Відтоді, якщо пропозиція порожня, код застосунку запитує продукти напряму в StoreKit і пропонує спробувати ще раз, якщо стор не відповідає.

Paywall без пропозиції ніколи не має бути глухим кутом, ні для користувача, ні для рев'юера, який має змогти купити. Повне налаштування є в моєму гайді RevenueCat для підписки iOS, а пастки відображення в помилках paywall. Коли продукт готовий, перевір також, що твій paywall відповідає guideline 3.1.2.

Підключи підписку, не витративши на це тиждень

iOS & Android Kit побудований на стартовому коді моїх застосунків: onboarding, paywall і підписки вже написані, а його третій крок, «підключити гроші», веде тебе через їх налаштування. Увесь ланцюжок, від продуктів App Store Connect до перевірки покупки, описано на сторінці підписка in-app iOS.

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

Поширені запитання

Чому моя підписка лишається в Missing Metadata, хоча все заповнено?

Спершу перевір скріншот для рев'ю, потім відображувану назву групи підписок, яка не виглядає обов'язковою. Далі перевір ціну, тривалість, щонайменше одну країну і договір для платних застосунків у Business. Після кожного виправлення збережи й перезавантаж сторінку, перш ніж робити висновки.

Чи потрібен скріншот для підписки?

Так, скріншот для рев'ю, який називається App Review Screenshot. Він показує покупку в застосунку, зазвичай paywall, і потрібен лише рев'юеру. В App Store він не показується. Не плутай його з промо-зображенням 1024 x 1024 пікселі, яке потрібне лише для просування покупки або для пропозиції повернення користувачів.

Чи можна подати підписку без нової версії застосунку?

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

Що означає Prepare for Submission для вбудованої покупки?

Це назва в довідці Apple з липня 2026 для продукту, ще не доданого до подання. Вона показується навіть тоді, коли бракує метаданих. API App Store Connect досі розрізняє ці два випадки: MISSING_METADATA і READY_TO_SUBMIT.

Чому RevenueCat повертає порожню пропозицію?

Тому що App Store не повернув iPhone жодного продукту. Найпоширеніші причини: незаповнені метадані, неактивний договір для платних застосунків, інший ідентифікатор продукту або недавня зміна, яка ще не поширилася. Твій paywall має обробляти цей випадок, не блокуючи користувача.