Missing Metadata App Store Connect: tilauksen avaaminen

Missing Metadata tarkoittaa App Store Connectissa, että tilauksestasi tai sovelluksen sisäisestä ostostasi puuttuu ainakin yksi pakollinen tieto. Tarkista tässä järjestyksessä kieli, hinta, kesto, maat, arviointikuvakaappaus ja maksullisten sovellusten sopimus. Niin kauan kuin tuote on tässä tilassa, et voi lähettää sitä arvioitavaksi, eikä sovelluksesi pysty lataamaan sitä. Ensimmäinen tilaus pitää lisäksi lähettää yhdessä sovelluksen version kanssa.

Sain tämän tilan heinäkuussa 2026 TradaZenissa, kaupankäyntisimulaattorissani. Uudella viikkotilauksella oli kesto, hinta, ryhmä ja kaksi kieltä. Silti se jäi tilaan Missing Metadata. Ainoa puuttuva palanen oli arviointikuvakaappaus. Tässä ovat tarkistettavat syyt, tuotteen tilat ja se, mikä kunkin avaa, sekä yhteys RevenueCatiin.

Mitä Missing Metadata tarkoittaa?

Tähän vuoteen asti Applen ohje määritteli tilan näin: tuote on luotu, mutta et ole vielä lähettänyt kuvakaappausta tai täydentänyt sen metatietoja. Tila ei koskaan kerro, mikä kenttä puuttuu. Siinä koko ongelma: sitä pitää etsiä.

Huomio, nimitys muuttui heinäkuussa 2026. App Store Connectin julkaisutiedotteet kertovat 15. heinäkuuta uudesta lähetystavasta: jokainen sovelluksen sisäinen ostos lähetetään omalta sivultaan painikkeella Add for Review. Tilasivu ei enää listaa tilaa "Missing Metadata". Se alkaa tilasta "Prepare for Submission" ja tarkentaa: jos ostoksestasi puuttuu pakollisia metatietoja, täydennä ne ennen kuin lisäät sen lähetykseen. RevenueCatin dokumentaatio vahvistaa saman: ennen arviointia uusi tuote näkyy tilassa "Prepare for Submission", vaikka siltä puuttuisi metatietoja.

App Store Connect API puolestaan palauttaa yhä MISSING_METADATA ja sitten READY_TO_SUBMIT. Siihen nojaavat työkalut näyttävät siis edelleen nämä sanat. Nimityksestä riippumatta diagnoosi on sama: jokin pakollinen kenttä on tyhjä.

Tarkistettavat syyt järjestyksessä

Tarkistan ne tässä järjestyksessä, tuotteen sivulta tiliin asti.

Syy	Missä korjataan
Nimi tai kuvaus tyhjä	Tuotteen sivu
Ryhmältä puuttuu näyttönimi	Ryhmän sivu
Hinta tai kesto puuttuu	Tuotteen sivu
Yhtään maata ei valittu	Availability
Arviointikuvakaappaus puuttuu	Review Information
Maksullinen sopimus ei voimassa	Business
Ensimmäinen tilaus lähetetty yksin	Lähetys

1. Tuotteen kieli. Sovelluksen sisäisen ostoksen tietojen sivun mukaan näyttönimi ja kuvaus ovat pakollisia vähintään yhdellä kielellä. Nimessä on 2-30 merkkiä, kuvauksessa enintään 45. Tuote ilman kieltä ei lähde.

2. Ryhmän kieli. Tilausryhmälläkin on näyttönimi, jonka tilaajasi näkevät hallitessaan tilauksiaan iPhonessa. Se lisätään ryhmän sivulla kohdassa Display Name and Description, kuten Applen tilaussivu selittää. Kenttä ei näytä pakolliselta. Silti eräs kehittäjä kertoo Applen foorumeilla, että kaikki hänen ryhmänsä tilaukset pysyivät jumissa niin kauan kuin se oli tyhjä. Tila näkyy tilauksessa, ei ryhmässä, ja siitä hämmennys.

3. Hinta ja kesto. Tilaus tarvitsee keston, viikosta vuoteen, ja hinnan. Tekninen muistio TN3186 aloittaa tästä, kun tuote ei lataudu: tarkista tunniste, hinta ja kielet. Muista myös, että kestoa ei voi enää muuttaa arvioitavaksi lähettämisen jälkeen.

4. Saatavuus. Valitse vähintään yksi maa tai alue kohdassa Availability. Apple tarkentaa, että ilman saatavuutta tila "Approved" ei voi näkyä.

5. Arviointikuvakaappaus. Tämä oli minun tapaukseni TradaZenissa, ja syy toistuu usein foorumeilla. Kuvakaappaus "App Review Screenshot" näyttää ostoksen sellaisena kuin se näkyy sovelluksessa, yleensä maksumuurisi. Se on vain arvioijaa varten eikä sitä koskaan näytetä App Storessa. Se noudattaa App Store -kuvakaappaustesi formaatteja. Kun se on lähetetty, voit vaihtaa sen, mutta et poistaa.

Älä sekoita sitä 1024 x 1024 pikselin mainoskuvaan. Sitä tarvitaan vain, jos nostat ostoksen esiin sivullasi tai luot takaisinvoittotarjouksen, ja sillä on omat sääntönsä. Opin tämän hylkäyksestä, joka koski tilauksen mainoskuvaa.

6. Maksullisten sovellusten sopimus. Jotta voit tarjota sovelluksen sisäisiä ostoksia, tilin haltijan pitää allekirjoittaa Paid Apps Agreement kohdassa Business ja sitten täyttää pankki- ja verotiedot. Tämä ei ole tuotteen kenttä, mutta kaikki riippuu siitä. Apple kirjoittaa, ettet voi luoda uutta sovelluksen sisäistä ostosta ennen kuin olet hyväksynyt sopimuksen uusimman version. Sen sivu ostosten valmistelusta arviointiin lisää, että maksulliset ostokset eivät toimi arvioinnissa ennen kuin sopimus on voimassa. Kohdassa Business sopimuksen, pankkitilin ja verolomakkeiden pitää kaikkien olla aktiivisia. Vaiheet on käyty läpi oppaassa Applen kehittäjätilistä.

7. Ensimmäinen tilaus lähetetty yksin. Tämä ei ole puuttuva metatieto. Silti se on yleisin syy siihen, että valmis tuote ei koskaan lähde arviointiin. Kerron siitä tarkemmin alempana.

Tuotteen tilat ja mikä kunkin avaa

Tässä tarkistuslista, jota pidän silmien edessä. Ensimmäinen sarake on API:n palauttama tila, toinen Applen ohjeen nimitys heinäkuusta 2026 alkaen.

Tila (API)	Nykyinen nimitys	Mikä avaa
MISSING_METADATA	Prepare for Submission	Kenttien täyttäminen
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Ei vastinetta	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Odota Applea
IN_REVIEW	In Review	Odota Applea
APPROVED	Approved	Maat ja hyväksytty sovellus
REJECTED	Rejected	Korjaa, Update Review

Tarkemmin:

• Missing Metadata tilaan Ready to Submit. Täytä syiden 1-5 kentät, tallenna ja lataa sivu uudelleen. Heinäkuussa näkemäni ranskankielinen näkymä näytti tilan Missing Metadata, ja seuraava tila oli Ready to Submit.
• Ready to Submit tilaan Ready for Review. Klikkaa tilauksen sivulla Add for Review ja lisää se olemassa olevaan tai uuteen lähetykseen. Sovelluksen sisäisen ostoksen lähetysohje pyytää valitsemaan alustan, sovelluksen version ja tarvittaessa ryhmän. Tästä hetkestä alkaen vain viitenimeä, hintaa ja saatavuutta voi muokata.
• Ready for Review tilaan Waiting for Review. Tarkista, että sovelluksen versio ja ryhmä ovat samassa lähetyksessä, ja klikkaa Submit for Review.
• Waiting for Review tilaan Approved. Ei mitään tehtävää, kunhan maksumuurisi toimii. Jos ostos menee tilaan "Accepted" eikä "Approved", jokin muu saman lähetyksen osa on hylätty: Apple ei hyväksy mitään ennen kuin kaikki on hyväksytty.
• Rejected. Syy näkyy lähetyksen viesteissä. Korjaa kohta, klikkaa Update Review ja lähetä lähetys uudelleen.

Ensimmäinen tilaus lähtee sovelluksen version mukana

Sääntö löytyy Applen ohjeesta: ensimmäinen tilaus, kuten jokaisen tyypin ensimmäinen ostos, pitää lähettää sovelluksen uuden version kanssa. Uusi ryhmä lähtee vähintään yhden tilauksensa kanssa. Kun tämä ensimmäinen on hyväksytty, voit lähettää saman tyypin seuraavat ilman uutta versiota, kunhan sovelluksella on hyväksytty versio.

Näin kävi TradaZenissa. Heinäkuun versio lähti vuosi- ja kuukausitilauksen kanssa. Viikkotilaus, joka oli yhä tilassa Missing Metadata, jäi lähetyksen ulkopuolelle. Kun sovellus oli hyväksytty, se pystyi lähtemään yksin ilman uutta buildia.

Jos lähetät sovelluksen ilman tilausta, tarvitset uuden version sen hyväksyttämiseen. Opas App Store -hyväksynnän kestosta näyttää, montako päivää tämä ylimääräinen kierros maksaa.

Yhteys RevenueCatiin: tyhjä tarjous

RevenueCat ei itse myy mitään. SDK lukee tuotetunnisteesi sen palvelimilta ja pyytää sitten tuotteet App Storesta iPhonesta käsin. Jos App Store ei palauta niitä, tarjous saapuu tyhjänä eikä maksumuurillasi ole mitään näytettävää. SDK:n lokit näyttävät silloin: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

RevenueCatin mukaan tuote, jonka metatiedot ovat täydelliset, latautuu sandboxissa jo ennen arviointia. Puutteellinen ei lataudu. RevenueCatin ja Applen muut vihjeet:

• maksullisten sovellusten sopimus ja pankki, joiden leviäminen voi RevenueCatin mukaan kestää jopa 24 tuntia;
• tuotteen muutos, jonka saapuminen sandboxiin voi Applen mukaan kestää jopa tunnin;
• eri tuotetunniste App Store Connectissa, RevenueCatissa ja koodissasi.

TradaZenissa koodi piilottaa sellaisen tilauksen kortin, jonka tuotetta ei palauteta, rikkomatta maksumuuria. Lokakuussa 2026 näin maksumuurin ilman tarjousta toisesta syystä: SDK:n välimuistista luettu tarjous oli tyhjä. Siitä lähtien, jos tarjous on tyhjä, sovelluksen koodi pyytää tuotteet suoraan StoreKitiltä ja tarjoaa uutta yritystä, jos kauppa ei vastaa.

Maksumuuri ilman tarjousta ei saa koskaan olla umpikuja, ei käyttäjälle eikä arvioijalle, jonka pitää pystyä ostamaan. Koko kokoonpano on oppaassani RevenueCat iOS-tilaukselle, ja näyttämisen sudenkuopat jutussa maksumuurin virheistä. Kun tuote on valmis, tarkista myös, että maksumuurisi noudattaa guidelinea 3.1.2.

Kytke tilauksesi ilman, että siihen menee viikko

iOS & Android Kit perustuu sovellusteni aloituskoodiin: onboarding, maksumuuri ja tilaukset on jo koodattu, ja sen kolmas vaihe, "kytke raha", opastaa sinut säätämään ne. Koko ketju App Store Connectin tuotteista oston tarkistukseen on kuvattu sivulla iOS:n sovelluksen sisäinen tilaus.

Jos valmistelet ensimmäistä julkaisuasi, tee ilmainen diagnoosi: se laittaa vaiheet järjestykseen ja lähettää sinulle Apple-hylkäysten vastaisen tarkistuslistani. Jos tilauksesi on kaikesta huolimatta jumissa, varaa tunti kanssani: avaamme App Store Connectisi yhdessä ja etsimme tyhjän kentän.

Usein kysytyt kysymykset

Miksi tilaukseni on yhä tilassa Missing Metadata, vaikka kaikki on täytetty?

Tarkista ensin arviointikuvakaappaus ja sitten tilausryhmän näyttönimi, joka ei näytä pakolliselta. Tarkista sen jälkeen hinta, kesto, vähintään yksi maa ja maksullisten sovellusten sopimus kohdassa Business. Tallenna jokaisen korjauksen jälkeen ja lataa sivu uudelleen ennen johtopäätöksiä.

Tarvitaanko tilaukselle kuvakaappaus?

Kyllä, arviointikuvakaappaus eli App Review Screenshot. Se näyttää ostoksen sovelluksessa, yleensä maksumuurin, ja on vain arvioijaa varten. Sitä ei näytetä App Storessa. Älä sekoita sitä 1024 x 1024 pikselin mainoskuvaan, jota tarvitaan vain ostoksen esiin nostamiseen tai takaisinvoittotarjoukseen.

Voiko tilauksen lähettää ilman sovelluksen uutta versiota?

Ensimmäistä ei. Ensimmäinen tilaus ja sen ryhmä lähtevät sovelluksen uuden version kanssa. Kun ensimmäinen tilaus on hyväksytty, seuraavat voivat lähteä yksin, kunhan sovelluksella on hyväksytty versio.

Mitä Prepare for Submission tarkoittaa sovelluksen sisäiselle ostokselle?

Se on Applen ohjeen nimitys heinäkuusta 2026 alkaen tuotteelle, jota ei ole vielä lisätty lähetykseen. Se näkyy, vaikka metatietoja puuttuisi. App Store Connect API erottaa yhä nämä kaksi tapausta arvoilla MISSING_METADATA ja READY_TO_SUBMIT.

Miksi RevenueCat palauttaa tyhjän tarjouksen?

Koska App Store ei palauttanut iPhonelle yhtään tuotetta. Yleisimmät syyt: puutteelliset metatiedot, maksullisten sovellusten sopimus ei voimassa, eri tuotetunniste tai tuore muutos, joka ei ole vielä levinnyt. Maksumuurisi pitää käsitellä tämä tilanne estämättä käyttäjää.