Missing Metadata App Store Connect: atasi langganan tersekat

Missing Metadata dalam App Store Connect bermaksud langganan atau pembelian dalam aplikasi anda kekurangan sekurang-kurangnya satu maklumat wajib. Semak mengikut urutan: bahasa, harga, tempoh, negara, tangkapan skrin semakan dan perjanjian aplikasi berbayar. Selagi produk kekal dalam status ini, anda tidak boleh menghantarnya untuk semakan, dan aplikasi anda tidak dapat memuatkannya. Langganan pertama pula mesti dihantar bersama satu versi aplikasi.

Saya dapat status ini pada Julai 2026 untuk TradaZen, simulator dagangan saya. Langganan mingguan yang baru sudah ada tempoh, harga, kumpulan dan dua bahasa. Tetapi ia tetap dalam status Missing Metadata. Satu-satunya yang tiada ialah tangkapan skrin semakan. Berikut punca yang perlu disemak, status sesebuah produk dan apa yang membukanya, kemudian kaitannya dengan RevenueCat.

Apakah maksud Missing Metadata?

Sehingga tahun ini, bantuan Apple mentakrifkan status ini begini: produk sudah dicipta, tetapi anda belum menghantar tangkapan skrin atau melengkapkan metadatanya. Status ini tidak pernah memberitahu medan mana yang kosong. Itulah masalahnya: anda kena cari sendiri.

Perhatian, label ini berubah pada Julai 2026. Nota keluaran App Store Connect mengumumkan cara penghantaran baharu pada 15 Julai: setiap pembelian dalam aplikasi dihantar dari halamannya sendiri, dengan Add for Review. Halaman status tidak lagi menyenaraikan "Missing Metadata". Ia bermula dengan "Prepare for Submission" dan menyatakan: jika pembelian dalam aplikasi anda kekurangan metadata wajib, lengkapkannya sebelum menambahnya ke penghantaran. Dokumentasi RevenueCat mengesahkannya: sebelum semakan, produk baharu muncul sebagai "Prepare for Submission", walaupun metadatanya belum lengkap.

API App Store Connect pula masih memulangkan MISSING_METADATA kemudian READY_TO_SUBMIT. Jadi alat yang bergantung padanya masih memaparkan perkataan ini. Apa pun labelnya, diagnosisnya sama: ada medan wajib yang kosong.

Punca yang perlu disemak, mengikut urutan

Saya semak mengikut urutan ini, dari halaman produk hingga ke akaun.

Punca	Tempat membetulkan
Nama atau penerangan kosong	Halaman produk
Kumpulan tanpa nama paparan	Halaman kumpulan
Harga atau tempoh tiada	Halaman produk
Tiada negara tersedia	Availability
Tangkapan skrin semakan tiada	Review Information
Perjanjian berbayar tidak aktif	Business
Langganan pertama dihantar sendirian	Penghantaran

1. Bahasa produk. Menurut halaman maklumat pembelian dalam aplikasi, nama paparan dan penerangan wajib diisi dalam sekurang-kurangnya satu bahasa. Nama antara 2 hingga 30 aksara, penerangan paling banyak 45. Produk tanpa bahasa tidak boleh dihantar.

2. Bahasa kumpulan. Kumpulan langganan juga ada nama paparan, yang dilihat pelanggan anda semasa mengurus langganan mereka di iPhone. Ia ditambah di halaman kumpulan, bahagian Display Name and Description, seperti yang diterangkan dalam halaman Apple tentang langganan. Medan ini nampak macam tidak wajib. Namun, seorang pembangun bercerita di forum Apple bahawa semua langganan dalam kumpulannya tersekat selagi medan itu kosong. Status dipaparkan pada langganan, bukan pada kumpulan, sebab itu ramai keliru.

3. Harga dan tempoh. Langganan memerlukan tempoh, dari seminggu hingga setahun, dan harga. Nota teknikal TN3186 bermula di sini apabila produk tidak dapat dimuatkan: semak pengecam, harga dan bahasanya. Ingat juga, tempoh tidak boleh diubah lagi selepas dihantar untuk semakan.

4. Ketersediaan. Pilih sekurang-kurangnya satu negara atau wilayah dalam Availability. Apple menyatakan bahawa tanpa ketersediaan, status "Approved" tidak boleh muncul.

5. Tangkapan skrin semakan. Inilah kes saya untuk TradaZen, dan punca yang kerap muncul di forum. Tangkapan "App Review Screenshot" menunjukkan pembelian seperti yang dipaparkan dalam aplikasi, biasanya paywall anda. Ia hanya untuk penyemak dan tidak pernah dipaparkan di App Store. Ia mengikut format tangkapan skrin App Store anda. Selepas dihantar, anda boleh menggantinya, tetapi tidak boleh memadamnya.

Jangan keliru dengan imej promosi 1024 x 1024 piksel. Imej itu hanya diperlukan jika anda mempromosikan pembelian di halaman App Store anda atau mencipta tawaran win-back, dan ia ada peraturannya sendiri. Saya belajar perkara ini selepas ditolak kerana imej promosi langganan.

6. Perjanjian aplikasi berbayar. Untuk menawarkan pembelian dalam aplikasi, pemegang akaun mesti menandatangani Paid Apps Agreement dalam Business, kemudian mengisi maklumat bank dan cukai. Ini bukan medan produk, tetapi semuanya bergantung padanya. Apple menulis bahawa anda tidak boleh mencipta pembelian dalam aplikasi baharu selagi anda belum menerima versi terkini perjanjian itu. Halamannya tentang penyediaan pembelian untuk semakan menambah bahawa pembelian berbayar tidak berfungsi semasa semakan selagi perjanjian ini tidak aktif. Dalam Business, perjanjian, akaun bank dan borang cukai mesti semuanya aktif. Langkah-langkah ini diperincikan dalam panduan akaun pembangun Apple.

7. Langganan pertama dihantar sendirian. Ini bukan metadata yang hilang. Tetapi inilah sebab paling biasa produk yang lengkap tidak pernah sampai ke semakan. Saya terangkan di bawah.

Status produk dan apa yang membuka setiap satu

Ini senarai semak yang saya simpan dekat. Lajur pertama ialah status yang dipulangkan oleh API, lajur kedua ialah label bantuan Apple sejak Julai 2026.

Status (API)	Label semasa	Apa yang membukanya
MISSING_METADATA	Prepare for Submission	Isi medan
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Tiada padanan	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Tunggu Apple
IN_REVIEW	In Review	Tunggu Apple
APPROVED	Approved	Negara dan aplikasi diluluskan
REJECTED	Rejected	Betulkan, Update Review

Secara terperinci:

• Missing Metadata ke Ready to Submit. Isi medan untuk punca 1 hingga 5, simpan, muat semula halaman. Skrin yang saya lihat pada Julai memaparkan "Missing Metadata", dan status seterusnya ialah "Ready to Submit".
• Ready to Submit ke Ready for Review. Di halaman langganan, klik Add for Review dan tambahkannya ke penghantaran sedia ada atau yang baharu. Prosedur penghantaran pembelian dalam aplikasi meminta anda memilih platform, versi aplikasi dan, jika perlu, kumpulan. Mulai saat itu, hanya nama rujukan, harga dan ketersediaan yang masih boleh diubah.
• Ready for Review ke Waiting for Review. Pastikan versi aplikasi dan kumpulan berada dalam penghantaran yang sama, kemudian klik Submit for Review.
• Waiting for Review ke Approved. Tiada apa perlu dibuat, cuma pastikan paywall anda berfungsi. Jika pembelian bertukar ke "Accepted" dan bukan "Approved", ada elemen lain dalam penghantaran yang sama telah ditolak: Apple tidak meluluskan apa-apa selagi semuanya belum diterima.
• Rejected. Sebabnya muncul dalam mesej penghantaran. Betulkan elemen itu, klik Update Review, kemudian hantar semula.

Langganan pertama dihantar bersama versi aplikasi

Peraturannya ada dalam bantuan Apple: langganan pertama, sama seperti pembelian pertama bagi setiap jenis, mesti dihantar bersama versi baharu aplikasi. Kumpulan baharu dihantar bersama sekurang-kurangnya satu langganannya. Selepas elemen pertama ini diluluskan, anda boleh menghantar yang seterusnya daripada jenis yang sama tanpa versi baharu, asalkan aplikasi ada versi yang diluluskan.

Itulah yang berlaku pada TradaZen. Versi Julai dihantar bersama langganan tahunan dan bulanan. Langganan mingguan, yang masih dalam Missing Metadata, tidak termasuk dalam penghantaran. Selepas aplikasi diluluskan, ia boleh dihantar sendirian, tanpa build baharu.

Jika anda menghantar aplikasi tanpa langganannya, anda perlukan versi baharu untuk mendapatkan kelulusannya. Panduan tentang tempoh semakan App Store menunjukkan berapa hari kitaran tambahan ini makan.

Kaitan dengan RevenueCat: offering kosong

RevenueCat sendiri tidak menjual apa-apa. SDK membaca pengecam produk anda dari pelayannya, kemudian meminta produk daripada App Store, dari iPhone. Jika App Store tidak memulangkannya, offering sampai dalam keadaan kosong dan paywall anda tiada apa untuk dipaparkan. Log SDK akan memaparkan: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

Menurut RevenueCat, produk dengan metadata lengkap boleh dimuatkan dalam sandbox walaupun sebelum semakan. Produk yang tidak lengkap, tidak boleh. Petunjuk lain yang diberikan oleh RevenueCat dan Apple:

• perjanjian aplikasi berbayar dan bank, yang boleh mengambil masa sehingga 24 jam untuk disebarkan menurut RevenueCat;
• perubahan pada produk, yang boleh mengambil masa sehingga sejam untuk sampai ke sandbox menurut Apple;
• pengecam produk yang berbeza antara App Store Connect, RevenueCat dan kod anda.

Dalam TradaZen, kod menyembunyikan kad langganan yang produknya tidak dipulangkan, tanpa merosakkan paywall. Pada Oktober 2026, saya nampak paywall tanpa offering atas sebab lain: offering yang dibaca dari cache SDK kosong. Sejak itu, jika offering kosong, kod aplikasi meminta produk terus daripada StoreKit, dan menawarkan untuk mencuba semula jika store tidak membalas.

Paywall tanpa offering tidak boleh menjadi jalan buntu, sama ada untuk pengguna atau penyemak, yang mesti boleh membuat pembelian. Persediaan penuh ada dalam panduan saya RevenueCat untuk langganan iOS, dan perangkap paparan dalam kesilapan paywall. Apabila produk sudah sedia, pastikan juga paywall anda mematuhi guideline 3.1.2.

Sambungkan langganan anda tanpa menghabiskan seminggu

iOS & Android Kit bermula daripada kod permulaan aplikasi saya: onboarding, paywall dan langganan sudah siap dikod, dan langkah ketiganya, "sambungkan wang", membimbing anda untuk menetapkannya. Seluruh rantaian, dari produk App Store Connect hingga pengesahan pembelian, diterangkan di halaman langganan dalam aplikasi iOS.

Jika anda sedang menyediakan keluaran pertama, buat diagnostik percuma anda: ia menyusun semula langkah mengikut urutan dan menghantar senarai semak anti-penolakan Apple saya. Jika langganan anda masih tersekat selepas semua ini, tempah sejam bersama saya: kita buka App Store Connect anda bersama-sama dan cari medan yang kosong.

Soalan lazim

Kenapa langganan saya kekal dalam Missing Metadata walaupun semuanya sudah diisi?

Semak dulu tangkapan skrin semakan, kemudian nama paparan kumpulan langganan, yang nampak macam tidak wajib. Selepas itu semak harga, tempoh, sekurang-kurangnya satu negara, dan perjanjian aplikasi berbayar dalam Business. Selepas setiap pembetulan, simpan dan muat semula halaman sebelum membuat kesimpulan.

Adakah langganan memerlukan tangkapan skrin?

Ya, tangkapan skrin semakan, dipanggil App Review Screenshot. Ia menunjukkan pembelian dalam aplikasi, biasanya paywall, dan hanya untuk penyemak. Ia tidak dipaparkan di App Store. Jangan keliru dengan imej promosi 1024 x 1024 piksel, yang hanya berguna untuk mempromosikan pembelian atau untuk tawaran win-back.

Bolehkah langganan dihantar tanpa versi baharu aplikasi?

Bukan yang pertama. Langganan pertama dan kumpulannya dihantar bersama versi baharu aplikasi. Selepas langganan pertama ini diluluskan, yang seterusnya boleh dihantar sendirian, asalkan aplikasi ada versi yang diluluskan.

Apakah maksud Prepare for Submission untuk pembelian dalam aplikasi?

Ini label bantuan Apple sejak Julai 2026 untuk produk yang belum ditambah ke penghantaran. Ia dipaparkan walaupun metadata belum lengkap. API App Store Connect masih membezakan kedua-dua kes, dengan MISSING_METADATA dan READY_TO_SUBMIT.

Kenapa RevenueCat memulangkan offering kosong?

Kerana App Store tidak memulangkan sebarang produk kepada iPhone. Punca paling biasa: metadata tidak lengkap, perjanjian aplikasi berbayar tidak aktif, pengecam produk berbeza, atau perubahan terkini yang belum disebarkan. Paywall anda mesti mengendalikan kes ini tanpa menyekat pengguna.