Devoria
Missing Metadata a App Store Connect: com desbloquejar-ho
Per Mehdi Azizi
Publicat el , 9 min
Missing Metadata vol dir que falta un camp obligatori. Revisa idioma, preu, durada, països, captura de revisió i contracte de pagament.
Missing Metadata, a App Store Connect, vol dir que a la teva subscripció o compra integrada li falta com a mínim una dada obligatòria. Revisa per ordre l'idioma, el preu, la durada, els països, la captura de revisió i el contracte de les apps de pagament. Mentre el producte es quedi en aquest estat, no el pots enviar a revisió i la teva app no el pot carregar. A més, la primera subscripció ha de sortir amb una versió de l'app.
Vaig tenir aquest estat el juliol del 2026 a TradaZen, el meu simulador de trading. La nova subscripció setmanal tenia la durada, el preu, el grup i dos idiomes. Tot i així, es quedava en «Missing Metadata». L'única peça que faltava era la captura de revisió. Aquí tens les causes que cal revisar, els estats d'un producte amb què desbloqueja cadascun i, després, la relació amb RevenueCat.
Què vol dir Missing Metadata?
Fins aquest any, l'ajuda d'Apple definia aquest estat així: el producte està creat, però encara no has enviat cap captura de pantalla o no n'has acabat les metadades. L'estat no diu mai quin camp falta. Aquest és tot el problema: l'has de buscar.
Compte, l'etiqueta va canviar el juliol del 2026. Les notes de versió d'App Store Connect anuncien el 15 de juliol una nova manera d'enviar: cada compra integrada s'envia des de la seva pròpia pàgina, amb Add for Review. La pàgina dels estats ja no inclou «Missing Metadata». Comença per «Prepare for Submission» i precisa: si a la teva compra integrada li falten metadades obligatòries, completa-les abans d'afegir-la a un enviament. La documentació de RevenueCat ho confirma: abans de la revisió, un producte nou apareix com a «Prepare for Submission», encara que li faltin metadades.
L'API d'App Store Connect, en canvi, continua retornant MISSING_METADATA i després READY_TO_SUBMIT. Per tant, les eines que s'hi basen encara mostren aquestes paraules. Sigui quina sigui l'etiqueta, el diagnòstic és el mateix: hi ha un camp obligatori buit.
Les causes que cal revisar, per ordre
Les reviso en aquest ordre, des de la pàgina del producte fins al compte.
| Causa | On es corregeix |
|---|---|
| Nom o descripció buits | Pàgina del producte |
| Grup sense nom visible | Pàgina del grup |
| Falta el preu o la durada | Pàgina del producte |
| Cap país disponible | Availability |
| Falta la captura de revisió | Review Information |
| Contracte de pagament inactiu | Business |
| Primera subscripció sola | Enviament |
1. L'idioma del producte. Segons la fitxa d'informació d'una compra integrada, el nom visible i la descripció són obligatoris com a mínim en un idioma. El nom té de 2 a 30 caràcters, i la descripció 45 com a màxim. Un producte sense idioma no pot sortir.
2. L'idioma del grup. El grup de subscripcions també té un nom visible, que els teus subscriptors veuen quan gestionen les subscripcions a l'iPhone. S'afegeix a la pàgina del grup, a l'apartat Display Name and Description, tal com explica la pàgina d'Apple sobre les subscripcions. El camp no sembla obligatori. Però un desenvolupador explica als fòrums d'Apple que totes les subscripcions del seu grup es quedaven bloquejades mentre estava buit. L'estat es mostra a la subscripció, no al grup, i d'aquí ve la confusió.
3. El preu i la durada. Una subscripció necessita una durada, d'una setmana a un any, i un preu. La nota tècnica TN3186 comença per aquí quan un producte no es carrega: revisar-ne l'identificador, el preu i els idiomes. Tingues present també que la durada ja no es pot modificar un cop enviada a revisió.
4. La disponibilitat. Tria com a mínim un país o regió a Availability. Apple precisa que, sense disponibilitat, l'estat «Approved» no pot aparèixer.
5. La captura de revisió. És el meu cas a TradaZen, i una causa que surt sovint als fòrums. La captura «App Review Screenshot» mostra la compra tal com apareix a l'app, normalment el teu paywall. Només serveix per al revisor i no es mostra mai a l'App Store. Segueix els formats de les teves captures de l'App Store. Un cop enviada, la pots substituir, però no esborrar.
No la confonguis amb la imatge promocional de 1024 x 1024 píxels. Aquesta només serveix si destaques la compra a la teva fitxa o si crees una oferta de recuperació, i té les seves pròpies normes. Ho vaig aprendre amb un rebuig per la imatge promocional d'una subscripció.
6. El contracte de les apps de pagament. Per oferir compres integrades, el titular del compte ha de signar el Paid Apps Agreement a Business i després introduir les dades bancàries i fiscals. No és un camp del producte, però tot en depèn. Apple escriu que no pots crear cap compra integrada nova mentre no hagis acceptat l'última versió del contracte. La seva pàgina sobre la preparació de les compres per a la revisió afegeix que les compres de pagament no funcionen en revisió mentre aquest contracte no estigui actiu. A Business, el contracte, el compte bancari i els formularis fiscals han d'estar tots actius. Aquests passos estan detallats a la guia del compte de desenvolupador d'Apple.
7. La primera subscripció enviada sola. No és una metadada que falti. Però és el motiu més habitual pel qual un producte complet no arriba mai a revisió. T'ho explico més avall.
Els estats d'un producte i què desbloqueja cadascun
Aquesta és la checklist que tinc sempre a mà. La primera columna dona l'estat que retorna l'API, i la segona l'etiqueta de l'ajuda d'Apple des del juliol del 2026.
| Estat (API) | Etiqueta actual | Què el desbloqueja |
|---|---|---|
| MISSING_METADATA | Prepare for Submission | Omplir els camps |
| READY_TO_SUBMIT | Prepare for Submission | Add for Review |
| Sense equivalent | Ready for Review | Submit for Review |
| WAITING_FOR_REVIEW | Waiting for Review | Esperar Apple |
| IN_REVIEW | In Review | Esperar Apple |
| APPROVED | Approved | Països i app validada |
| REJECTED | Rejected | Corregir, Update Review |
En detall:
- De Missing Metadata a Ready to Submit. Omple els camps de les causes 1 a 5, desa i recarrega la pàgina. A la pantalla que tenia el juliol hi sortia «Missing Metadata», i l'estat següent es deia «Ready to Submit».
- De Ready to Submit a Ready for Review. A la pàgina de la subscripció, fes clic a Add for Review i afegeix-la a un enviament existent o a un de nou. El procediment d'enviament d'una compra integrada et fa triar la plataforma, la versió de l'app i, si cal, el grup. A partir d'aquí, només es poden modificar el nom de referència, el preu i la disponibilitat.
- De Ready for Review a Waiting for Review. Comprova que la versió de l'app i el grup són al mateix enviament, i fes clic a Submit for Review.
- De Waiting for Review a Approved. No has de fer res, només mantenir el paywall funcionant. Si la compra passa a «Accepted» i no a «Approved», s'ha rebutjat un altre element del mateix enviament: Apple no aprova res fins que tot està acceptat.
- Rejected. El motiu apareix als missatges de l'enviament. Corregeix l'element, fes clic a Update Review i torna a enviar.
La primera subscripció surt amb una versió de l'app
La norma és a l'ajuda d'Apple: la primera subscripció, igual que la primera compra de cada tipus, s'ha d'enviar amb una versió nova de l'app. Un grup nou surt amb almenys una de les seves subscripcions. Un cop aprovat aquest primer element, pots enviar els següents del mateix tipus sense versió nova, sempre que l'app tingui una versió aprovada.
És el que va passar a TradaZen. La versió de juliol va sortir amb l'anual i la mensual. La setmanal, encara en «Missing Metadata», es va quedar fora de l'enviament. Un cop aprovada l'app, ja podia sortir sola, sense build nou.
Si envies l'app sense la subscripció, necessitaràs una versió nova per validar-la. La guia sobre el temps de validació de l'App Store mostra quants dies et costa aquest cicle de més.
La relació amb RevenueCat: l'oferta buida
RevenueCat no ven res per si mateix. L'SDK llegeix els identificadors dels teus productes als seus servidors i després demana els productes a l'App Store, des de l'iPhone. Si l'App Store no els retorna, l'oferta arriba buida i el teu paywall no té res a mostrar. Llavors els registres de l'SDK mostren: «There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store.»
Segons RevenueCat, un producte amb les metadades completes es carrega a sandbox fins i tot abans de la revisió. Un d'incomplet, no. Les altres pistes que donen RevenueCat i Apple:
- el contracte de les apps de pagament i el banc, que poden trigar fins a 24 hores a propagar-se segons RevenueCat;
- una modificació del producte, que pot trigar fins a una hora a arribar a sandbox segons Apple;
- un identificador de producte diferent entre App Store Connect, RevenueCat i el teu codi.
A TradaZen, el codi amaga la targeta d'una subscripció si el producte no es retorna, sense trencar el paywall. L'octubre del 2026 vaig veure un paywall sense oferta per un altre motiu: l'oferta llegida des de la memòria cau de l'SDK era buida. Des d'aleshores, si l'oferta és buida, el codi de l'app demana els productes directament a StoreKit, i proposa tornar-ho a provar si la botiga no respon.
Un paywall sense oferta no ha de ser mai un carreró sense sortida, ni per a l'usuari ni per al revisor, que ha de poder comprar. El muntatge complet és a la meva guia RevenueCat per a una subscripció iOS, i els paranys de visualització a els errors de paywall. Un cop el producte estigui llest, comprova també que el teu paywall compleix la guideline 3.1.2.
Connectar la subscripció sense passar-t'hi la setmana
L'iOS & Android Kit parteix del codi base de les meves apps: l'onboarding, el paywall i les subscripcions ja estan programats, i el tercer pas, «connectar els diners», et guia per configurar-los. Tota la cadena, dels productes d'App Store Connect a la verificació de la compra, està descrita a la pàgina subscripció in-app iOS.
Si prepares el teu primer llançament, fes el teu diagnòstic gratuït: posa els passos en ordre i t'envia la meva checklist antirebuig d'Apple. Si la subscripció continua bloquejada malgrat tot això, reserva una hora amb mi: obrim el teu App Store Connect junts i busquem el camp buit.
Preguntes freqüents
Per què la meva subscripció es queda en Missing Metadata si ho tinc tot omplert?
Revisa primer la captura de revisió i després el nom visible del grup de subscripcions, que no sembla obligatori. Comprova després el preu, la durada, almenys un país i el contracte de les apps de pagament a Business. Després de cada correcció, desa i recarrega la pàgina abans de treure conclusions.
Cal una captura de pantalla per a una subscripció?
Sí, la captura de revisió, anomenada App Review Screenshot. Mostra la compra dins l'app, normalment el paywall, i només serveix per al revisor. No es mostra a l'App Store. No la confonguis amb la imatge promocional de 1024 x 1024 píxels, que només serveix per destacar la compra o per a una oferta de recuperació.
Es pot enviar una subscripció sense una versió nova de l'app?
La primera, no. La primera subscripció i el seu grup surten amb una versió nova de l'app. Un cop aprovada aquesta primera subscripció, les següents poden sortir soles, sempre que l'app tingui una versió aprovada.
Què vol dir Prepare for Submission en una compra integrada?
És l'etiqueta de l'ajuda d'Apple des del juliol del 2026 per a un producte que encara no s'ha afegit a cap enviament. Apareix encara que faltin metadades. L'API d'App Store Connect encara distingeix els dos casos, amb MISSING_METADATA i READY_TO_SUBMIT.
Per què RevenueCat retorna una oferta buida?
Perquè l'App Store no ha retornat cap producte a l'iPhone. Les causes més habituals: metadades incompletes, contracte de les apps de pagament inactiu, identificador de producte diferent o una modificació recent que encara no s'ha propagat. El teu paywall ha de gestionar aquest cas sense bloquejar l'usuari.
