Missing Metadata App Store Connect: aboneliği kurtarmak

App Store Connect'te Missing Metadata durumu, aboneliğinde ya da uygulama içi satın alımında en az bir zorunlu bilginin eksik olduğu anlamına gelir. Sırasıyla dili, fiyatı, süreyi, ülkeleri, inceleme ekran görüntüsünü ve ücretli uygulamalar sözleşmesini kontrol et. Ürün bu durumda kaldığı sürece onu incelemeye gönderemezsin, uygulaman da onu yükleyemez. Ayrıca ilk abonelik, uygulamanın bir sürümüyle birlikte gönderilmek zorunda.

Bu durumu Temmuz 2026'da trading simülatörüm TradaZen'de yaşadım. Yeni haftalık aboneliğin süresi, fiyatı, grubu ve iki dili vardı. Yine de Missing Metadata'da takılı kalıyordu. Eksik olan tek parça inceleme ekran görüntüsüydü. Aşağıda kontrol etmen gereken nedenleri, bir ürünün durumlarını ve her birini neyin açtığını, ardından RevenueCat ile bağlantısını bulacaksın.

Missing Metadata ne demek?

Bu yıla kadar Apple'ın yardım sayfası bu durumu şöyle tanımlıyordu: ürün oluşturuldu ama henüz ekran görüntüsü göndermedin ya da meta verilerini tamamlamadın. Durum hangi alanın eksik olduğunu asla söylemez. Bütün sorun da bu: aramak zorundasın.

Dikkat, etiket Temmuz 2026'da değişti. App Store Connect sürüm notları 15 Temmuz'da yeni bir gönderim yöntemi duyuruyor: her uygulama içi satın alım artık kendi sayfasından, Add for Review ile gönderiliyor. Durumlar sayfası artık "Missing Metadata"yı listelemiyor. "Prepare for Submission" ile başlıyor ve şunu belirtiyor: uygulama içi satın alımında zorunlu meta veriler eksikse, onu bir gönderime eklemeden önce tamamla. RevenueCat dokümantasyonu da bunu doğruluyor: incelemeden önce yeni bir ürün, meta verileri eksik olsa bile "Prepare for Submission" olarak görünür.

App Store Connect API ise hâlâ MISSING_METADATA, ardından READY_TO_SUBMIT döndürüyor. Ona dayanan araçlar da bu yüzden bu kelimeleri göstermeye devam ediyor. Etiket ne olursa olsun teşhis aynı: zorunlu bir alan boş.

Kontrol edilecek nedenler, sırasıyla

Bunları ürün sayfasından hesaba kadar bu sırayla kontrol ediyorum.

Neden	Nerede düzeltilir
Ad veya açıklama boş	Ürün sayfası
Grubun görünen adı yok	Grup sayfası
Fiyat veya süre eksik	Ürün sayfası
Hiç ülke seçilmemiş	Availability
İnceleme ekran görüntüsü yok	Review Information
Ücretli sözleşme aktif değil	Business
İlk abonelik tek başına	Gönderim

1. Ürünün dili. Uygulama içi satın alım bilgileri sayfasına göre görünen ad ve açıklama en az bir dilde zorunlu. Ad 2 ile 30 karakter arası, açıklama en fazla 45 karakter. Dili olmayan bir ürün gönderilemez.

2. Grubun dili. Abonelik grubunun da bir görünen adı var; abonelerin iPhone'da aboneliklerini yönetirken bunu görür. Apple'ın abonelik sayfasında anlatıldığı gibi grup sayfasında, Display Name and Description bölümünden eklenir. Alan zorunlu gibi görünmüyor. Yine de bir geliştirici Apple forumlarında bu alan boş kaldığı sürece grubundaki tüm aboneliklerin takılı kaldığını anlatıyor. Durum grupta değil abonelikte görünüyor, kafa karışıklığı da buradan geliyor.

3. Fiyat ve süre. Bir abonelik bir hafta ile bir yıl arasında bir süre ve bir fiyat ister. TN3186 teknik notu, bir ürün yüklenmediğinde işe buradan başlıyor: kimliğini, fiyatını ve dillerini kontrol etmek. Şunu da unutma: süre, incelemeye gönderildikten sonra artık değiştirilemiyor.

4. Kullanılabilirlik. Availability'de en az bir ülke ya da bölge seç. Apple, kullanılabilirlik olmadan "Approved" durumunun görünemeyeceğini belirtiyor.

5. İnceleme ekran görüntüsü. TradaZen'deki durumum buydu ve forumlarda sık geçen bir neden. "App Review Screenshot", satın alımı uygulamada göründüğü haliyle, genelde paywall'unla gösterir. Sadece inceleyen kişi için kullanılır, App Store'da asla gösterilmez. App Store ekran görüntülerinin formatlarına uyar. Bir kez gönderdikten sonra değiştirebilirsin ama silemezsin.

Bunu 1024 x 1024 piksellik tanıtım görseliyle karıştırma. O görsel yalnızca satın alımı mağaza sayfanda öne çıkarıyorsan ya da bir geri kazanma teklifi oluşturuyorsan kullanılır ve kendi kuralları var. Bunu bir aboneliğin tanıtım görseli yüzünden aldığım bir retle öğrendim.

6. Ücretli uygulamalar sözleşmesi. Uygulama içi satın alım sunmak için hesap sahibinin Business'ta Paid Apps Agreement'ı imzalaması, ardından banka ve vergi bilgilerini girmesi gerekir. Bu ürünün bir alanı değil ama her şey buna bağlı. Apple, sözleşmenin son sürümünü kabul etmeden yeni bir uygulama içi satın alım oluşturamayacağını yazıyor. Satın alımları incelemeye hazırlama sayfası da bu sözleşme aktif olmadığı sürece ücretli satın alımların incelemede çalışmadığını ekliyor. Business'ta sözleşme, banka hesabı ve vergi formlarının hepsi aktif olmalı. Bu adımlar Apple geliştirici hesabı rehberinde ayrıntılı anlatılıyor.

7. Tek başına gönderilen ilk abonelik. Bu eksik bir meta veri değil. Yine de eksiksiz bir ürünün bir türlü incelemeye gitmemesinin en yaygın nedeni bu. Aşağıda ayrıntılı anlatıyorum.

Bir ürünün durumları ve her birini ne açar

Hep gözümün önünde tuttuğum kontrol listesi bu. İlk sütun API'nin döndürdüğü durumu, ikincisi Temmuz 2026'dan beri Apple yardım sayfasındaki etiketi gösteriyor.

Durum (API)	Güncel etiket	Ne açar
MISSING_METADATA	Prepare for Submission	Alanları doldurmak
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Karşılığı yok	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Apple'ı beklemek
IN_REVIEW	In Review	Apple'ı beklemek
APPROVED	Approved	Ülke ve onaylı uygulama
REJECTED	Rejected	Düzelt, Update Review

Ayrıntılı olarak:

• Missing Metadata'dan Ready to Submit'e. 1 ile 5 arasındaki nedenlerin alanlarını doldur, kaydet, sayfayı yenile. Temmuz'da gördüğüm ekranda Missing Metadata yazıyordu, sonraki durumun adı da Ready to Submit'ti.
• Ready to Submit'ten Ready for Review'a. Abonelik sayfasında Add for Review'a tıkla ve onu mevcut bir gönderime ya da yenisine ekle. Uygulama içi satın alım gönderme prosedürü senden platformu, uygulama sürümünü ve gerekirse grubu seçmeni ister. Bu andan itibaren yalnızca referans adı, fiyat ve kullanılabilirlik değiştirilebilir.
• Ready for Review'dan Waiting for Review'a. Uygulama sürümünün ve grubun aynı gönderimde olduğunu kontrol et, sonra Submit for Review'a tıkla.
• Waiting for Review'dan Approved'a. Paywall'unu çalışır halde tutmak dışında yapacak bir şey yok. Satın alım "Approved" yerine "Accepted" olursa, aynı gönderimdeki başka bir öğe reddedilmiştir: her şey kabul edilmeden Apple hiçbir şeyi onaylamaz.
• Rejected. Neden, gönderimin mesajlarında görünür. Öğeyi düzelt, Update Review'a tıkla, sonra gönderimi yeniden gönder.

İlk abonelik uygulamanın bir sürümüyle gider

Kural Apple'ın yardım sayfasında: ilk abonelik, her türün ilk satın alımı gibi, uygulamanın yeni bir sürümüyle birlikte gönderilmeli. Yeni bir grup, aboneliklerinden en az biriyle gider. Bu ilk öğe onaylandıktan sonra, uygulamanın onaylı bir sürümü olduğu sürece aynı türden sonrakileri yeni sürüm olmadan gönderebilirsin.

TradaZen'de olan tam olarak buydu. Temmuz sürümü yıllık ve aylık abonelikle gitti. Hâlâ Missing Metadata'da olan haftalık abonelik gönderimin dışında kaldı. Uygulama onaylandıktan sonra yeni bir build olmadan tek başına gidebildi.

Uygulamayı aboneliği olmadan gönderirsen, onu onaylatmak için yeni bir sürüm gerekecek. App Store onay süresi rehberi bu fazladan döngünün kaç güne mal olduğunu gösteriyor.

RevenueCat ile bağlantı: boş teklif

RevenueCat kendisi hiçbir şey satmaz. SDK ürün kimliklerini RevenueCat sunucularından okur, sonra ürünleri iPhone üzerinden App Store'dan ister. App Store onları döndürmezse teklif boş gelir ve paywall'unun gösterecek bir şeyi olmaz. SDK günlüklerinde o zaman şu görünür: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

RevenueCat'e göre meta verileri eksiksiz bir ürün, incelemeden önce bile sandbox'ta yüklenir. Eksik bir ürün yüklenmez. RevenueCat ve Apple'ın verdiği diğer ipuçları:

• ücretli uygulamalar sözleşmesi ve banka; RevenueCat'e göre yayılmaları 24 saate kadar sürebilir;
• üründe yapılan bir değişiklik; Apple'a göre sandbox'a ulaşması bir saate kadar sürebilir;
• App Store Connect, RevenueCat ve kodun arasında farklı bir ürün kimliği.

TradaZen'de kod, ürünü döndürülmeyen bir aboneliğin kartını paywall'u bozmadan gizliyor. Ekim 2026'da başka bir nedenle teklifsiz bir paywall gördüm: SDK önbelleğinden okunan teklif boştu. O zamandan beri teklif boşsa uygulamanın kodu ürünleri doğrudan StoreKit'ten istiyor ve mağaza yanıt vermezse yeniden denemeyi öneriyor.

Teklifsiz bir paywall asla çıkmaz sokak olmamalı, ne kullanıcı için ne de satın alabilmesi gereken inceleyen kişi için. Kurulumun tamamı iOS aboneliği için RevenueCat rehberimde, görüntüleme tuzakları da paywall hataları yazısında. Ürün hazır olduğunda paywall'unun guideline 3.1.2'ye uyduğunu da kontrol et.

Aboneliğini bir haftanı harcamadan bağla

iOS & Android Kit, uygulamalarımın başlangıç kodundan yola çıkıyor: onboarding, paywall ve abonelikler hazır kodlanmış durumda, üçüncü adımı olan "parayı bağlamak" da bunları ayarlamanda sana rehberlik ediyor. App Store Connect ürünlerinden satın alma doğrulamasına kadar tüm zincir iOS uygulama içi abonelik sayfasında anlatılıyor.

İlk yayınına hazırlanıyorsan ücretsiz teşhisini yap: adımları sıraya koyar ve sana Apple retlerine karşı kontrol listemi gönderir. Tüm bunlara rağmen aboneliğin takılı kalıyorsa benimle bir saat ayır: App Store Connect'ini birlikte açar, boş alanı ararız.

Sık sorulan sorular

Her şey dolu olduğu halde aboneliğim neden Missing Metadata'da kalıyor?

Önce inceleme ekran görüntüsünü, sonra zorunlu gibi görünmeyen abonelik grubunun görünen adını kontrol et. Ardından fiyatı, süreyi, en az bir ülkeyi ve Business'taki ücretli uygulamalar sözleşmesini kontrol et. Her düzeltmeden sonra bir sonuca varmadan önce kaydet ve sayfayı yenile.

Bir abonelik için ekran görüntüsü gerekir mi?

Evet, App Review Screenshot denen inceleme ekran görüntüsü. Satın alımı uygulamada, genelde paywall'da gösterir ve yalnızca inceleyen kişi için kullanılır. App Store'da gösterilmez. Onu sadece satın alımı öne çıkarmak ya da bir geri kazanma teklifi için işe yarayan 1024 x 1024 piksellik tanıtım görseliyle karıştırma.

Bir abonelik uygulamanın yeni sürümü olmadan gönderilebilir mi?

İlki gönderilemez. İlk abonelik ve grubu, uygulamanın yeni bir sürümüyle gider. Bu ilk abonelik onaylandıktan sonra, uygulamanın onaylı bir sürümü olduğu sürece sonrakiler tek başına gidebilir.

Bir uygulama içi satın alım için Prepare for Submission ne demek?

Temmuz 2026'dan beri Apple yardım sayfasında henüz bir gönderime eklenmemiş bir ürün için kullanılan etiket. Meta veriler eksik olsa bile görünür. App Store Connect API ise iki durumu hâlâ MISSING_METADATA ve READY_TO_SUBMIT ile ayırıyor.

RevenueCat neden boş bir teklif döndürüyor?

Çünkü App Store iPhone'a hiçbir ürün döndürmedi. En yaygın nedenler: eksik meta veriler, aktif olmayan ücretli uygulamalar sözleşmesi, farklı bir ürün kimliği ya da henüz yayılmamış yeni bir değişiklik. Paywall'un bu durumu kullanıcıyı engellemeden yönetmeli.