Missing Metadata v App Store Connect: odblokuj predplatné

Missing Metadata v App Store Connect znamená, že tvojmu predplatnému alebo nákupu v aplikácii chýba aspoň jeden povinný údaj. Skontroluj v tomto poradí jazyk, cenu, dĺžku, krajiny, screenshot pre kontrolu a zmluvu pre platené aplikácie. Kým je produkt v tomto stave, nemôžeš ho poslať na kontrolu a tvoja appka ho nedokáže načítať. Prvé predplatné navyše musí ísť spolu s verziou appky.

Tento stav som mal v júli 2026 na TradaZen, mojom simulátore tradingu. Nové týždenné predplatné malo dĺžku, cenu, skupinu aj dva jazyky. Aj tak zostávalo v stave Missing Metadata. Jediné, čo chýbalo, bol screenshot pre kontrolu. Tu sú príčiny, ktoré treba skontrolovať, stavy produktu a čo odblokuje každý z nich, a potom súvislosť s RevenueCat.

Čo znamená Missing Metadata?

Až do tohto roka Apple v pomocníkovi definoval tento stav takto: produkt je vytvorený, ale ešte si nenahral screenshot alebo nedokončil jeho metadáta. Stav ti nikdy nepovie, ktoré pole chýba. A v tom je celý problém: musíš hľadať.

Pozor, v júli 2026 sa označenie zmenilo. Poznámky k vydaniu App Store Connect k 15. júlu ohlasujú nový spôsob odosielania: každý nákup v aplikácii sa odosiela zo svojej vlastnej stránky cez Add for Review. Stránka so stavmi už Missing Metadata neuvádza. Začína stavom Prepare for Submission a upresňuje: ak tvojmu nákupu v aplikácii chýbajú povinné metadáta, doplň ich skôr, než ho pridáš do odoslania. Dokumentácia RevenueCat to potvrdzuje: pred kontrolou sa nový produkt zobrazuje ako Prepare for Submission, aj keď mu chýbajú metadáta.

API App Store Connect však stále vracia MISSING_METADATA a potom READY_TO_SUBMIT. Nástroje, ktoré na ňom stavajú, preto tieto slová zobrazujú ďalej. Bez ohľadu na označenie je diagnóza rovnaká: nejaké povinné pole je prázdne.

Príčiny, ktoré treba skontrolovať, v poradí

Kontrolujem ich v tomto poradí, od stránky produktu až po účet.

Príčina	Kde opraviť
Prázdny názov alebo popis	Stránka produktu
Skupina bez zobrazovaného mena	Stránka skupiny
Chýba cena alebo dĺžka	Stránka produktu
Žiadna dostupná krajina	Availability
Chýba screenshot pre kontrolu	Review Information
Neaktívna platená zmluva	Business
Prvé predplatné samo	Odoslanie

1. Jazyk produktu. Podľa stránky s informáciami o nákupe v aplikácii sú zobrazovaný názov a popis povinné aspoň v jednom jazyku. Názov má 2 až 30 znakov, popis najviac 45. Produkt bez jazyka sa odoslať nedá.

2. Jazyk skupiny. Skupina predplatných má tiež zobrazované meno, ktoré tvoji predplatitelia vidia, keď spravujú predplatné na iPhone. Pridáva sa na stránke skupiny v sekcii Display Name and Description, ako vysvetľuje stránka Apple o predplatných. Pole nevyzerá ako povinné. Jeden vývojár však na fórach Apple píše, že všetky predplatné v jeho skupine zostávali zablokované, kým bolo prázdne. Stav sa zobrazuje na predplatnom, nie na skupine, preto ten zmätok.

3. Cena a dĺžka. Predplatné potrebuje dĺžku, od jedného týždňa po jeden rok, a cenu. Technická poznámka TN3186 začína práve tým, keď sa produkt nenačíta: skontrolovať jeho identifikátor, cenu a jazyky. Zapamätaj si tiež, že dĺžka sa po odoslaní na kontrolu už nedá zmeniť.

4. Dostupnosť. V Availability vyber aspoň jednu krajinu alebo región. Apple upresňuje, že bez dostupnosti sa stav Approved nemôže objaviť.

5. Screenshot pre kontrolu. To bol môj prípad na TradaZen a je to príčina, ktorá sa na fórach objavuje často. Screenshot App Review Screenshot ukazuje nákup tak, ako vyzerá v appke, zvyčajne tvoj paywall. Slúži iba pre kontrolóra a v App Store sa nikdy nezobrazí. Riadi sa formátmi tvojich screenshotov pre App Store. Keď ho raz nahráš, môžeš ho nahradiť, ale nie zmazať.

Nezamieňaj si ho s propagačným obrázkom 1024 x 1024 pixelov. Ten potrebuješ iba vtedy, keď nákup zvýrazníš na svojej stránke v obchode alebo vytvoríš ponuku na získanie späť (win-back), a má vlastné pravidlá. Naučilo ma to zamietnutie kvôli propagačnému obrázku predplatného.

6. Zmluva pre platené aplikácie. Aby si mohol ponúkať nákupy v aplikácii, držiteľ účtu musí v Business podpísať Paid Apps Agreement a potom vyplniť bankové a daňové údaje. Nie je to pole produktu, ale závisí od toho všetko. Apple píše, že nový nákup v aplikácii nemôžeš vytvoriť, kým neprijmeš najnovšiu verziu zmluvy. Jeho stránka o príprave nákupov na kontrolu dodáva, že platené nákupy pri kontrole nefungujú, kým táto zmluva nie je aktívna. V Business musia byť zmluva, bankový účet aj daňové formuláre aktívne. Tieto kroky podrobne opisuje návod k vývojárskemu účtu Apple.

7. Prvé predplatné odoslané samo. Nejde o chýbajúce metadáta. Napriek tomu je to najčastejší dôvod, prečo kompletný produkt nikdy neodíde na kontrolu. Podrobne to rozoberám nižšie.

Stavy produktu a čo odblokuje každý z nich

Toto je checklist, ktorý mám stále po ruke. Prvý stĺpec uvádza stav, ktorý vracia API, druhý označenie v pomocníkovi Apple od júla 2026.

Stav (API)	Aktuálne označenie	Čo odblokuje
MISSING_METADATA	Prepare for Submission	Vyplniť polia
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Bez ekvivalentu	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Čakať na Apple
IN_REVIEW	In Review	Čakať na Apple
APPROVED	Approved	Krajiny a schválená appka
REJECTED	Rejected	Opraviť, Update Review

Podrobne:

• Z Missing Metadata do Ready to Submit. Vyplň polia z príčin 1 až 5, ulož a znovu načítaj stránku. Obrazovka, ktorú som mal v júli, ukazovala Missing Metadata a ďalší stav sa volal Ready to Submit.
• Z Ready to Submit do Ready for Review. Na stránke predplatného klikni na Add for Review a pridaj ho do existujúceho alebo nového odoslania. Postup odoslania nákupu v aplikácii ťa nechá vybrať platformu, verziu appky a v prípade potreby skupinu. Od tej chvíle sa dajú meniť už iba referenčný názov, cena a dostupnosť.
• Z Ready for Review do Waiting for Review. Skontroluj, či sú verzia appky a skupina v tom istom odoslaní, a potom klikni na Submit for Review.
• Z Waiting for Review do Approved. Nemusíš nič robiť, len udržuj paywall funkčný. Ak nákup prejde do stavu Accepted a nie Approved, iná položka v tom istom odoslaní bola zamietnutá: Apple neschváli nič, kým nie je prijaté všetko.
• Rejected. Dôvod nájdeš v správach k odoslaniu. Oprav položku, klikni na Update Review a odoslanie pošli znova.

Prvé predplatné ide spolu s verziou appky

Pravidlo je v pomocníkovi Apple: prvé predplatné, rovnako ako prvý nákup každého typu, musí byť odoslané spolu s novou verziou appky. Nová skupina ide aspoň s jedným zo svojich predplatných. Keď je táto prvá položka schválená, ďalšie rovnakého typu môžeš odosielať bez novej verzie, pokiaľ má appka schválenú verziu.

Presne to sa stalo na TradaZen. Júlová verzia odišla s ročným a mesačným predplatným. Týždenné, stále v stave Missing Metadata, zostalo mimo odoslania. Keď bola appka schválená, mohlo odísť samo, bez nového buildu.

Ak pošleš appku bez jej predplatného, na jeho schválenie budeš potrebovať novú verziu. Návod o dĺžke schvaľovania v App Store ukazuje, koľko dní ťa takýto cyklus navyše stojí.

Súvislosť s RevenueCat: prázdna ponuka

RevenueCat sám nič nepredáva. SDK si načíta identifikátory tvojich produktov z jeho serverov a potom si produkty vypýta z App Store, priamo z iPhonu. Ak ich App Store nevráti, ponuka príde prázdna a tvoj paywall nemá čo zobraziť. Logy SDK vtedy ukážu: „There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.“

Podľa RevenueCat sa produkt s kompletnými metadátami načíta v sandboxe ešte pred kontrolou. Nekompletný nie. Ďalšie stopy od RevenueCat a Apple:

• zmluva pre platené aplikácie a banka, ktorých prenesenie môže podľa RevenueCat trvať až 24 hodín;
• zmena produktu, ktorej prenesenie do sandboxu môže podľa Apple trvať až hodinu;
• iný identifikátor produktu v App Store Connect, v RevenueCat a v tvojom kóde.

Na TradaZen kód skryje kartu predplatného, ktorého produkt sa nevráti, bez toho, aby rozbil paywall. V októbri 2026 som videl paywall bez ponuky z iného dôvodu: ponuka načítaná z cache SDK bola prázdna. Odvtedy, ak je ponuka prázdna, kód appky si produkty vypýta priamo zo StoreKitu a ak obchod neodpovedá, ponúkne opakovanie.

Paywall bez ponuky nesmie byť nikdy slepou uličkou, ani pre používateľa, ani pre kontrolóra, ktorý musí mať možnosť nakúpiť. Celé zapojenie nájdeš v mojom návode RevenueCat pre predplatné na iOS a chyby v zobrazení v článku chyby paywallu. Keď je produkt pripravený, skontroluj aj, či tvoj paywall spĺňa guideline 3.1.2.

Zapoj predplatné bez toho, aby ti to zabralo celý týždeň

iOS & Android Kit vychádza zo štartovacieho kódu mojich apiek: onboarding, paywall a predplatné sú už naprogramované a jeho tretí krok, „zapojiť peniaze“, ťa prevedie ich nastavením. Celý reťazec, od produktov v App Store Connect až po overenie nákupu, je opísaný na stránke predplatné v aplikácii na iOS.

Ak pripravuješ svoje prvé vydanie, urob si bezplatnú diagnostiku: zoradí ti kroky a pošle ti môj checklist proti zamietnutiu od Apple. Ak tvoje predplatné aj tak zostáva zablokované, rezervuj si so mnou hodinu: spolu otvoríme tvoj App Store Connect a nájdeme to prázdne pole.

Často kladené otázky

Prečo moje predplatné zostáva v stave Missing Metadata, aj keď je všetko vyplnené?

Najprv skontroluj screenshot pre kontrolu, potom zobrazované meno skupiny predplatných, ktoré nevyzerá ako povinné. Potom over cenu, dĺžku, aspoň jednu krajinu a zmluvu pre platené aplikácie v Business. Po každej oprave ulož a znovu načítaj stránku, až potom rob závery.

Potrebuje predplatné screenshot?

Áno, screenshot pre kontrolu, nazývaný App Review Screenshot. Ukazuje nákup v appke, zvyčajne paywall, a slúži iba pre kontrolóra. V App Store sa nezobrazuje. Nezamieňaj si ho s propagačným obrázkom 1024 x 1024 pixelov, ktorý je užitočný iba na zvýraznenie nákupu alebo pre ponuku na získanie späť.

Dá sa predplatné odoslať bez novej verzie appky?

Prvé nie. Prvé predplatné a jeho skupina idú spolu s novou verziou appky. Keď je toto prvé predplatné schválené, ďalšie môžu ísť samostatne, pokiaľ má appka schválenú verziu.

Čo znamená Prepare for Submission pri nákupe v aplikácii?

Je to označenie v pomocníkovi Apple od júla 2026 pre produkt, ktorý ešte nebol pridaný do odoslania. Zobrazuje sa, aj keď chýbajú metadáta. API App Store Connect oba prípady stále rozlišuje, pomocou MISSING_METADATA a READY_TO_SUBMIT.

Prečo RevenueCat vracia prázdnu ponuku?

Pretože App Store nevrátil iPhonu žiadny produkt. Najčastejšie príčiny: nekompletné metadáta, neaktívna zmluva pre platené aplikácie, iný identifikátor produktu alebo nedávna zmena, ktorá sa ešte nepreniesla. Tvoj paywall musí tento prípad zvládnuť bez toho, aby používateľa zablokoval.