Missing Metadata v App Store Connect: odblokiraj naročnino

Missing Metadata v App Store Connect pomeni, da tvoji naročnini ali nakupu v aplikaciji manjka vsaj en obvezen podatek. Po vrsti preveri jezik, ceno, trajanje, države, posnetek za pregled in pogodbo za plačljive aplikacije. Dokler je izdelek v tem stanju, ga ne moreš poslati v pregled, tvoja aplikacija pa ga ne more naložiti. Prva naročnina mora poleg tega iti skupaj z verzijo aplikacije.

Ta status sem julija 2026 dobil na TradaZen, mojem simulatorju trgovanja. Nova tedenska naročnina je imela trajanje, ceno, skupino in dva jezika. Pa je vseeno ostala v stanju Missing Metadata. Manjkal je samo posnetek za pregled. Tukaj so vzroki, ki jih moraš preveriti, stanja izdelka in kaj odklene vsakega, nato pa še povezava z RevenueCat.

Kaj pomeni Missing Metadata?

Do letos je Applova pomoč ta status opisovala tako: izdelek je ustvarjen, vendar še nisi naložil posnetka zaslona ali dokončal njegovih metapodatkov. Status nikoli ne pove, katero polje manjka. In v tem je ves problem: iskati moraš sam.

Pozor, oznaka se je julija 2026 spremenila. Opombe ob izdaji App Store Connect 15. julija napovedujejo nov način oddaje: vsak nakup v aplikaciji se odda s svoje strani, z gumbom Add for Review. Stran s statusi „Missing Metadata“ ne navaja več. Začne se s „Prepare for Submission“ in pojasni: če tvojemu nakupu v aplikaciji manjkajo obvezni metapodatki, jih dopolni, preden ga dodaš v oddajo. Dokumentacija RevenueCat to potrjuje: pred pregledom se nov izdelek prikaže kot „Prepare for Submission“, tudi če mu manjkajo metapodatki.

API App Store Connect pa še vedno vrača MISSING_METADATA in nato READY_TO_SUBMIT. Orodja, ki temeljijo nanj, zato še vedno kažejo ti besedi. Ne glede na oznako je diagnoza enaka: eno obvezno polje je prazno.

Vzroki, ki jih preveriš, po vrsti

Preverjam jih v tem vrstnem redu, od strani izdelka do računa.

Vzrok	Kje popraviš
Prazno ime ali opis	Stran izdelka
Skupina brez prikaznega imena	Stran skupine
Manjka cena ali trajanje	Stran izdelka
Nobena država ni na voljo	Availability
Manjka posnetek za pregled	Review Information
Neaktivna plačljiva pogodba	Business
Prva naročnina poslana sama	Oddaja

1. Jezik izdelka. Po strani z informacijami o nakupu v aplikaciji sta prikazno ime in opis obvezna v vsaj enem jeziku. Ime ima od 2 do 30 znakov, opis največ 45. Izdelek brez jezika ne more na pot.

2. Jezik skupine. Skupina naročnin ima tudi prikazno ime, ki ga tvoji naročniki vidijo, ko na iPhonu upravljajo svoje naročnine. Dodaš ga na strani skupine, v razdelku Display Name and Description, kot pojasnjuje Applova stran o naročninah. Polje ne deluje obvezno. Pa vendar razvijalec na Applovih forumih piše, da so bile vse naročnine v njegovi skupini blokirane, dokler je bilo prazno. Status se prikaže na naročnini, ne na skupini, od tod zmeda.

3. Cena in trajanje. Naročnina potrebuje trajanje, od enega tedna do enega leta, in ceno. Tehnična opomba TN3186 začne prav tu, ko se izdelek ne naloži: preveri njegov identifikator, ceno in jezike. Zapomni si tudi, da trajanja po oddaji v pregled ne moreš več spremeniti.

4. Razpoložljivost. V Availability izberi vsaj eno državo ali regijo. Apple pojasnjuje, da se brez razpoložljivosti status „Approved“ ne more prikazati.

5. Posnetek za pregled. To je bil moj primer na TradaZen in vzrok, ki se na forumih pogosto ponavlja. Posnetek „App Review Screenshot“ pokaže nakup, kot je prikazan v aplikaciji, običajno tvoj paywall. Namenjen je samo pregledovalcu in se nikoli ne prikaže v App Store. Upošteva formate tvojih posnetkov za App Store. Ko ga naložiš, ga lahko zamenjaš, izbrisati pa ne.

Ne zamenjaj ga s promocijsko sliko velikosti 1024 x 1024 pikslov. Ta je potrebna le, če nakup izpostaviš na svoji strani v trgovini ali ustvariš ponudbo za vračanje naročnikov, in ima svoja pravila. To sem se naučil z zavrnitvijo zaradi promocijske slike naročnine.

6. Pogodba za plačljive aplikacije. Za ponujanje nakupov v aplikaciji mora imetnik računa v Business podpisati Paid Apps Agreement, nato pa vnesti bančne in davčne podatke. To ni polje izdelka, a vse je odvisno od tega. Apple piše, da novega nakupa v aplikaciji ne moreš ustvariti, dokler ne sprejmeš zadnje verzije pogodbe. Njegova stran o pripravi nakupov za pregled dodaja, da plačljivi nakupi med pregledom ne delujejo, dokler ta pogodba ni aktivna. V Business morajo biti pogodba, bančni račun in davčni obrazci vsi aktivni. Ti koraki so podrobno opisani v vodiču o Applovem razvijalskem računu.

7. Prva naročnina, poslana sama. To ni manjkajoči metapodatek. Je pa najpogostejši razlog, da popoln izdelek nikoli ne gre v pregled. Podrobneje ga razložim spodaj.

Stanja izdelka in kaj odklene vsako

Tukaj je kontrolni seznam, ki ga imam vedno pred očmi. Prvi stolpec navaja stanje, ki ga vrne API, drugi oznako v Applovi pomoči od julija 2026.

Stanje (API)	Trenutna oznaka	Kaj odklene
MISSING_METADATA	Prepare for Submission	Izpolni polja
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Ni ustreznice	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Počakaj na Apple
IN_REVIEW	In Review	Počakaj na Apple
APPROVED	Approved	Države in odobrena app
REJECTED	Rejected	Popravi, Update Review

Podrobneje:

• Iz Missing Metadata v Ready to Submit. Izpolni polja iz vzrokov 1 do 5, shrani, osveži stran. Zaslon, ki sem ga imel julija, je kazal Missing Metadata, naslednje stanje pa se je imenovalo Ready to Submit.
• Iz Ready to Submit v Ready for Review. Na strani naročnine klikni Add for Review in jo dodaj v obstoječo ali novo oddajo. Postopek oddaje nakupa v aplikaciji te vpraša za platformo, verzijo aplikacije in po potrebi skupino. Od tega trenutka lahko spreminjaš le referenčno ime, ceno in razpoložljivost.
• Iz Ready for Review v Waiting for Review. Preveri, da sta verzija aplikacije in skupina v isti oddaji, nato klikni Submit for Review.
• Iz Waiting for Review v Approved. Ničesar ti ni treba narediti, le paywall naj deluje. Če nakup preide v „Accepted“ in ne v „Approved“, je bil zavrnjen drug element iste oddaje: Apple ne odobri ničesar, dokler ni sprejeto vse.
• Rejected. Razlog se prikaže v sporočilih oddaje. Popravi element, klikni Update Review, nato oddajo pošlji znova.

Prva naročnina gre skupaj z verzijo aplikacije

Pravilo je v Applovi pomoči: prvo naročnino, tako kot prvi nakup vsake vrste, moraš oddati skupaj z novo verzijo aplikacije. Nova skupina gre na pot z vsaj eno od svojih naročnin. Ko je ta prvi element odobren, lahko naslednje iste vrste oddaš brez nove verzije, dokler ima aplikacija odobreno verzijo.

Prav to se je zgodilo na TradaZen. Julijska verzija je šla z letno in mesečno naročnino. Tedenska, še v stanju Missing Metadata, je ostala zunaj oddaje. Ko je bila aplikacija odobrena, je lahko šla sama, brez novega builda.

Če aplikacijo pošlješ brez naročnine, boš za njeno potrditev potreboval novo verzijo. Vodič o času potrjevanja v App Store pokaže, koliko dni stane ta dodatni krog.

Povezava z RevenueCat: prazna ponudba

RevenueCat sam ničesar ne prodaja. SDK prebere identifikatorje tvojih izdelkov na njegovih strežnikih, nato pa z iPhona zahteva izdelke od App Store. Če jih App Store ne vrne, je ponudba prazna in tvoj paywall nima česa prikazati. Dnevniki SDK takrat izpišejo: „There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.“

Po navedbah RevenueCat se izdelek s popolnimi metapodatki v sandboxu naloži že pred pregledom. Nepopoln pa ne. Druge možnosti, ki jih navajata RevenueCat in Apple:

• pogodba za plačljive aplikacije in banka, ki se lahko po navedbah RevenueCat razširita v do 24 urah;
• sprememba izdelka, ki lahko po navedbah Appla do sandboxa pride v do eni uri;
• različen identifikator izdelka v App Store Connect, RevenueCat in tvoji kodi.

Na TradaZen koda skrije kartico naročnine, katere izdelek ni vrnjen, ne da bi pokvarila paywall. Oktobra 2026 sem videl paywall brez ponudbe iz drugega razloga: ponudba, prebrana iz predpomnilnika SDK, je bila prazna. Od takrat koda aplikacije, če je ponudba prazna, izdelke zahteva neposredno od StoreKit in ponudi ponoven poskus, če trgovina ne odgovori.

Paywall brez ponudbe nikoli ne sme biti slepa ulica, ne za uporabnika ne za pregledovalca, ki mora imeti možnost nakupa. Celotna postavitev je v mojem vodiču RevenueCat za iOS naročnino, pasti pri prikazu pa v napakah pri paywallu. Ko je izdelek pripravljen, preveri še, ali tvoj paywall upošteva guideline 3.1.2.

Poveži naročnino, ne da bi ti vzelo cel teden

iOS & Android Kit izhaja iz začetne kode mojih aplikacij: onboarding, paywall in naročnine so že sprogramirani, njegov tretji korak, „priklopi denar“, pa te vodi skozi nastavitev. Celotna veriga, od izdelkov v App Store Connect do preverjanja nakupa, je opisana na strani iOS naročnina v aplikaciji.

Če pripravljaš svojo prvo izdajo, naredi brezplačno diagnozo: uredi korake po vrsti in ti pošlje moj kontrolni seznam proti Applovim zavrnitvam. Če naročnina kljub vsemu ostane blokirana, rezerviraj uro z mano: skupaj odpreva tvoj App Store Connect in poiščeva prazno polje.

Pogosta vprašanja

Zakaj moja naročnina ostaja v Missing Metadata, čeprav je vse izpolnjeno?

Najprej preveri posnetek za pregled, nato prikazno ime skupine naročnin, ki ne deluje obvezno. Potem preveri ceno, trajanje, vsaj eno državo in pogodbo za plačljive aplikacije v Business. Po vsakem popravku shrani in osveži stran, preden kaj sklepaš.

Ali naročnina potrebuje posnetek zaslona?

Da, posnetek za pregled, imenovan App Review Screenshot. Pokaže nakup v aplikaciji, običajno paywall, in je namenjen samo pregledovalcu. V App Store se ne prikaže. Ne zamenjaj ga s promocijsko sliko 1024 x 1024 pikslov, ki je uporabna le za izpostavitev nakupa ali za ponudbo za vračanje naročnikov.

Ali lahko naročnino oddam brez nove verzije aplikacije?

Prve ne. Prva naročnina in njena skupina gresta z novo verzijo aplikacije. Ko je ta prva naročnina odobrena, lahko naslednje gredo same, dokler ima aplikacija odobreno verzijo.

Kaj pomeni Prepare for Submission pri nakupu v aplikaciji?

To je oznaka v Applovi pomoči od julija 2026 za izdelek, ki še ni dodan v oddajo. Prikaže se tudi, če manjkajo metapodatki. API App Store Connect oba primera še vedno loči, z MISSING_METADATA in READY_TO_SUBMIT.

Zakaj RevenueCat vrne prazno ponudbo?

Ker App Store iPhonu ni vrnil nobenega izdelka. Najpogostejši vzroki: nepopolni metapodatki, neaktivna pogodba za plačljive aplikacije, različen identifikator izdelka ali nedavna sprememba, ki se še ni razširila. Tvoj paywall mora ta primer obvladati, ne da bi blokiral uporabnika.