Missing Metadata App Store Connect: előfizetés feloldása

A Missing Metadata állapot az App Store Connectben azt jelenti, hogy az előfizetésedből vagy az alkalmazáson belüli vásárlásodból hiányzik legalább egy kötelező adat. Ebben a sorrendben ellenőrizd: nyelv, ár, időtartam, országok, review képernyőkép és a fizetős appokra vonatkozó szerződés. Amíg a termék ebben az állapotban van, nem küldheted review-ra, és az appod sem tudja betölteni. Az első előfizetésnek ráadásul az app egy verziójával együtt kell mennie.

2026 júliusában én is belefutottam ebbe az állapotba a TradaZennél, a trading szimulátoromnál. Az új heti előfizetésnek megvolt az időtartama, az ára, a csoportja és két nyelve. Mégis Missing Metadata állapotban ragadt. Egyetlen dolog hiányzott: a review képernyőkép. Lássuk az ellenőrizendő okokat, egy termék állapotait és azt, mi oldja fel mindegyiket, végül a kapcsolatot a RevenueCattel.

Mit jelent a Missing Metadata?

Egészen idénig az Apple súgója így írta le ezt az állapotot: a termék létrejött, de még nem töltöttél fel képernyőképet, vagy nem fejezted be a metaadatait. Az állapot soha nem mondja meg, melyik mező hiányzik. Ez a gond: keresgélni kell.

Figyelem, 2026 júliusában megváltozott a felirat. Az App Store Connect kiadási jegyzetei július 15-re új beküldési módot jelentettek be: minden alkalmazáson belüli vásárlást a saját oldaláról küldesz be, az Add for Review gombbal. Az állapotok oldala már nem sorolja fel a „Missing Metadata” állapotot. A „Prepare for Submission” állapottal kezdődik, és azt írja: ha a vásárlásodból kötelező metaadatok hiányoznak, töltsd ki őket, mielőtt hozzáadod egy beküldéshez. A RevenueCat dokumentációja ezt megerősíti: review előtt egy új termék „Prepare for Submission” állapotban jelenik meg, akkor is, ha hiányoznak metaadatai.

Az App Store Connect API viszont továbbra is MISSING_METADATA, majd READY_TO_SUBMIT értéket ad vissza. Az erre épülő eszközök tehát még mindig ezeket a szavakat mutatják. Bármi is a felirat, a diagnózis ugyanaz: egy kötelező mező üres.

Az ellenőrizendő okok, sorrendben

Ebben a sorrendben nézem át őket, a termék oldalától egészen a fiókig.

Ok	Hol javítod
Üres név vagy leírás	A termék oldala
Csoport megjelenített név nélkül	A csoport oldala
Hiányzó ár vagy időtartam	A termék oldala
Egyetlen elérhető ország sincs	Availability
Hiányzó review képernyőkép	Review Information
Inaktív fizetős szerződés	Business
Egyedül küldött első előfizetés	Beküldés

1. A termék nyelve. Az alkalmazáson belüli vásárlás adatlapja szerint a megjelenített név és a leírás legalább egy nyelven kötelező. A név 2-30 karakter, a leírás legfeljebb 45. Nyelv nélküli termék nem mehet ki.

2. A csoport nyelve. Az előfizetési csoportnak is van megjelenített neve, ezt látják az előfizetőid, amikor az iPhone-on kezelik az előfizetéseiket. A csoport oldalán adod meg, a Display Name and Description résznél, ahogy az Apple előfizetésekről szóló oldala leírja. A mező nem tűnik kötelezőnek. Egy fejlesztő mégis azt írja az Apple fórumain, hogy a csoportja összes előfizetése elakadt, amíg ez üres volt. Az állapot az előfizetésen jelenik meg, nem a csoporton, innen a zavar.

3. Az ár és az időtartam. Egy előfizetéshez kell időtartam, egy héttől egy évig, és ár. A TN3186 technikai jegyzet ezzel kezd, ha egy termék nem töltődik be: ellenőrizd az azonosítóját, az árát és a nyelveit. Jegyezd meg azt is, hogy a review-ra küldés után az időtartam már nem módosítható.

4. Az elérhetőség. Válassz ki legalább egy országot vagy régiót az Availability részben. Az Apple szerint elérhetőség nélkül az „Approved” állapot nem jelenhet meg.

5. A review képernyőkép. Nálam a TradaZennél ez volt a gond, és a fórumokon is gyakran visszatérő ok. Az „App Review Screenshot” a vásárlást mutatja úgy, ahogy az appban megjelenik, általában a paywallodat. Kizárólag a reviewernek szól, az App Store-ban sosem jelenik meg. Ugyanazokat a formátumokat követi, mint az App Store képernyőképeid. Feltöltés után cserélheted, de nem törölheted.

Ne keverd össze az 1024 x 1024 pixeles promóciós képpel. Az csak akkor kell, ha kiemeled a vásárlást az adatlapodon, vagy visszanyerő ajánlatot hozol létre, és saját szabályai vannak. Ezt egy elutasításból tanultam meg, ami egy előfizetés promóciós képére vonatkozott.

6. A fizetős appok szerződése. Alkalmazáson belüli vásárlások kínálásához a fiók tulajdonosának alá kell írnia a Paid Apps Agreementet a Business részben, majd meg kell adnia a banki és adózási adatait. Ez nem a termék egy mezője, de minden ezen múlik. Az Apple azt írja, hogy nem hozhatsz létre új vásárlást, amíg nem fogadtad el a szerződés legújabb verzióját. A vásárlások review-ra való előkészítéséről szóló oldala hozzáteszi, hogy a fizetős vásárlások nem működnek review alatt, amíg ez a szerződés nem aktív. A Business részben a szerződésnek, a bankszámlának és az adóűrlapoknak is aktívnak kell lennie. Ezeket a lépéseket az Apple fejlesztői fiókról szóló útmutató részletezi.

7. Az egyedül beküldött első előfizetés. Ez nem hiányzó metaadat. Mégis ez a leggyakoribb oka annak, hogy egy kész termék sosem jut el a review-ig. Lejjebb részletezem.

Egy termék állapotai és ami mindegyiket feloldja

Ezt a checklistet tartom mindig szem előtt. Az első oszlop az API által visszaadott állapot, a második az Apple súgójának felirata 2026 júliusa óta.

Állapot (API)	Jelenlegi felirat	Mi oldja fel
MISSING_METADATA	Prepare for Submission	A mezők kitöltése
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Nincs megfelelője	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Várni az Apple-re
IN_REVIEW	In Review	Várni az Apple-re
APPROVED	Approved	Országok és jóváhagyott app
REJECTED	Rejected	Javítás, Update Review

Részletesen:

• Missing Metadata-ból Ready to Submit. Töltsd ki az 1-5. okoknál felsorolt mezőket, mentsd, töltsd újra az oldalt. A júliusi képernyőmön a Missing Metadata állapot szerepelt, a következő pedig a Ready to Submit volt.
• Ready to Submit-ból Ready for Review. Az előfizetés oldalán kattints az Add for Review gombra, és add hozzá egy meglévő vagy egy új beküldéshez. A vásárlás beküldésének menete során kiválasztod a platformot, az app verzióját és szükség esetén a csoportot. Ettől kezdve csak a referencianév, az ár és az elérhetőség módosítható.
• Ready for Review-ból Waiting for Review. Ellenőrizd, hogy az app verziója és a csoport ugyanabban a beküldésben van, majd kattints a Submit for Review gombra.
• Waiting for Review-ból Approved. Nincs teendőd, csak tartsd működőképesen a paywallodat. Ha a vásárlás „Accepted” és nem „Approved” állapotba kerül, akkor ugyanannak a beküldésnek egy másik elemét elutasították: az Apple semmit nem hagy jóvá, amíg minden el nem lett fogadva.
• Rejected. Az indoklás a beküldés üzeneteiben jelenik meg. Javítsd az elemet, kattints az Update Review gombra, majd küldd be újra.

Az első előfizetés az app egy verziójával megy

A szabály az Apple súgójában van: az első előfizetést, akárcsak minden típus első vásárlását, az app egy új verziójával együtt kell beküldeni. Egy új csoport legalább az egyik előfizetésével együtt megy. Miután ez az első elem jóváhagyást kapott, az azonos típusú továbbiakat új verzió nélkül is beküldheted, amíg az appnak van jóváhagyott verziója.

A TradaZennél pontosan ez történt. A júliusi verzió az éves és a havi előfizetéssel ment ki. A heti, ami még Missing Metadata állapotban volt, kimaradt a beküldésből. Miután az appot jóváhagyták, már egyedül is mehetett, új build nélkül.

Ha az appot az előfizetése nélkül küldöd be, új verzió kell majd ahhoz, hogy jóváhagyják. Az App Store jóváhagyási időről szóló útmutató megmutatja, hány napba kerül ez a plusz kör.

A kapcsolat a RevenueCattel: az üres offering

A RevenueCat maga nem ad el semmit. Az SDK kiolvassa a termékazonosítóidat a szervereiről, majd az iPhone-ról lekéri a termékeket az App Store-tól. Ha az App Store nem adja vissza őket, az offering üresen érkezik, és a paywallodnak nincs mit megjelenítenie. Az SDK naplóiban ekkor ez áll: „There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.”

A RevenueCat szerint egy teljes metaadatokkal rendelkező termék már review előtt betöltődik sandboxban. Egy hiányos nem. A RevenueCat és az Apple további tippjei:

• a fizetős appok szerződése és a bank, amelyek a RevenueCat szerint akár 24 óra alatt terjednek szét;
• a termék módosítása, amely az Apple szerint akár egy óra alatt jut el a sandboxba;
• eltérő termékazonosító az App Store Connect, a RevenueCat és a kódod között.

A TradaZennél a kód elrejti annak az előfizetésnek a kártyáját, amelynek a termékét nem kapta vissza, anélkül hogy a paywall elromlana. 2026 októberében egy másik okból láttam ajánlat nélküli paywallt: az SDK gyorsítótárából olvasott offering üres volt. Azóta, ha az offering üres, az app kódja közvetlenül a StoreKittől kéri le a termékeket, és újrapróbálást kínál, ha a store nem válaszol.

Egy ajánlat nélküli paywall soha nem lehet zsákutca, sem a felhasználónak, sem a reviewernek, akinek tudnia kell vásárolni. A teljes összeállítás a RevenueCat iOS előfizetéshez című útmutatómban van, a megjelenítési csapdák pedig a paywall hibákról szóló cikkben. Ha a termék kész, ellenőrizd azt is, hogy a paywallod megfelel-e a 3.1.2-es guideline-nak.

Kösd be az előfizetésed anélkül, hogy egy heted rámenne

Az iOS & Android Kit az appjaim kiinduló kódjára épül: az onboarding, a paywall és az előfizetések már le vannak kódolva, a harmadik lépése, a „bekötni a pénzt”, pedig végigvezet a beállításukon. A teljes lánc, az App Store Connect termékeitől a vásárlás ellenőrzéséig, az iOS alkalmazáson belüli előfizetés oldalon van leírva.

Ha az első megjelenésedre készülsz, csináld meg az ingyenes diagnosztikát: sorba rendezi a lépéseket, és elküldi neked az Apple-elutasítás elleni checklistemet. Ha az előfizetésed mindezek ellenére elakad, foglalj velem egy órát: együtt megnyitjuk az App Store Connectedet, és megkeressük az üres mezőt.

Gyakori kérdések

Miért marad az előfizetésem Missing Metadata állapotban, ha minden ki van töltve?

Először a review képernyőképet nézd meg, aztán az előfizetési csoport megjelenített nevét, ami nem tűnik kötelezőnek. Ezután ellenőrizd az árat, az időtartamot, legalább egy országot és a fizetős appok szerződését a Business részben. Minden javítás után ments, és töltsd újra az oldalt, mielőtt következtetést vonsz le.

Kell képernyőkép egy előfizetéshez?

Igen, a review képernyőkép, vagyis az App Review Screenshot. A vásárlást mutatja az appban, általában a paywallt, és csak a reviewernek szól. Az App Store-ban nem jelenik meg. Ne keverd össze az 1024 x 1024 pixeles promóciós képpel, amely csak a vásárlás kiemeléséhez vagy egy visszanyerő ajánlathoz kell.

Beküldhető egy előfizetés az app új verziója nélkül?

Az első nem. Az első előfizetés és a csoportja az app egy új verziójával együtt megy. Miután ez az első előfizetés jóváhagyást kapott, a többi már egyedül is mehet, amíg az appnak van jóváhagyott verziója.

Mit jelent a Prepare for Submission egy alkalmazáson belüli vásárlásnál?

Ez az Apple súgójának felirata 2026 júliusa óta egy olyan termékre, amelyet még nem adtál hozzá beküldéshez. Akkor is megjelenik, ha hiányoznak metaadatok. Az App Store Connect API még megkülönbözteti a két esetet, MISSING_METADATA és READY_TO_SUBMIT értékkel.

Miért ad vissza a RevenueCat üres offeringet?

Mert az App Store egyetlen terméket sem adott vissza az iPhone-nak. A leggyakoribb okok: hiányos metaadatok, inaktív fizetős szerződés, eltérő termékazonosító, vagy egy friss módosítás, ami még nem terjedt szét. A paywallodnak úgy kell kezelnie ezt az esetet, hogy ne blokkolja a felhasználót.