Missing Metadata في App Store Connect: فك حظر الاشتراك

تعني Missing Metadata في App Store Connect أن اشتراكك أو عملية الشراء داخل التطبيق ينقصها حقل إلزامي واحد على الأقل. تحقق بالترتيب من اللغة، والسعر، والمدة، والدول، ولقطة المراجعة، وعقد التطبيقات المدفوعة. ما دام المنتج في هذه الحالة، لا يمكنك إرساله للمراجعة، ولا يستطيع تطبيقك تحميله. وفوق ذلك، يجب أن يُرسَل أول اشتراك مع إصدار من التطبيق.

ظهرت لي هذه الحالة في يوليو 2026 على TradaZen، محاكي التداول الذي طورته. كان للاشتراك الأسبوعي الجديد مدته وسعره ومجموعته ولغتان. ومع ذلك بقي في حالة Missing Metadata. القطعة الوحيدة الناقصة كانت لقطة المراجعة. إليك الأسباب التي يجب التحقق منها، وحالات المنتج مع ما يفك حظر كل واحدة منها، ثم العلاقة مع RevenueCat.

ماذا تعني Missing Metadata؟

حتى هذا العام، كانت مساعدة Apple تعرّف هذه الحالة هكذا: المنتج أُنشئ، لكنك لم ترسل بعد لقطة شاشة أو لم تُكمل بياناته الوصفية. الحالة لا تقول أبدًا أي حقل ناقص. وهنا المشكلة كلها: عليك أن تبحث.

انتبه، التسمية تغيرت في يوليو 2026. تعلن ملاحظات إصدار App Store Connect بتاريخ 15 يوليو عن طريقة إرسال جديدة: كل عملية شراء داخل التطبيق تُرسَل من صفحتها الخاصة عبر Add for Review. وصفحة الحالات لم تعد تذكر "Missing Metadata". تبدأ بـ "Prepare for Submission" وتوضح: إذا كانت عملية الشراء داخل التطبيق تفتقد بيانات وصفية إلزامية، أكملها قبل إضافتها إلى إرسال. وتوثيق RevenueCat يؤكد ذلك: قبل المراجعة، يظهر المنتج الجديد في حالة "Prepare for Submission"، حتى لو كانت تنقصه بيانات وصفية.

أما API الخاصة بـ App Store Connect، فما زالت تُرجع MISSING_METADATA ثم READY_TO_SUBMIT. لذلك ما زالت الأدوات المبنية عليها تعرض هذه الكلمات. مهما كانت التسمية، التشخيص واحد: هناك حقل إلزامي فارغ.

الأسباب التي يجب التحقق منها، بالترتيب

أتحقق منها بهذا الترتيب، من صفحة المنتج حتى الحساب.

السبب	أين تصلحه
اسم أو وصف فارغ	صفحة المنتج
مجموعة بلا اسم معروض	صفحة المجموعة
سعر أو مدة ناقصة	صفحة المنتج
لا توجد أي دولة متاحة	Availability
لقطة المراجعة غائبة	Review Information
العقد المدفوع غير نشط	Business
أول اشتراك أُرسل وحده	الإرسال

1. لغة المنتج. وفقًا لـصفحة معلومات عملية الشراء داخل التطبيق، الاسم المعروض والوصف إلزاميان في لغة واحدة على الأقل. يتراوح طول الاسم بين 2 و30 حرفًا، والوصف 45 حرفًا كحد أقصى. منتج بلا لغة لا يمكن إرساله.

2. لغة المجموعة. لمجموعة الاشتراكات أيضًا اسم معروض، يراه مشتركوك عندما يديرون اشتراكاتهم على الـ iPhone. يُضاف في صفحة المجموعة، قسم Display Name and Description، كما تشرح صفحة Apple عن الاشتراكات. لا يبدو الحقل إلزاميًا. ومع ذلك، يروي مطور على منتديات Apple أن كل اشتراكات مجموعته بقيت عالقة ما دام فارغًا. الحالة تظهر على الاشتراك، لا على المجموعة، ومن هنا يأتي الالتباس.

3. السعر والمدة. يتطلب الاشتراك مدة، من أسبوع إلى سنة، وسعرًا. وتبدأ الملاحظة التقنية TN3186 من هنا عندما لا يُحمَّل منتج: التحقق من معرّفه وسعره ولغاته. وتذكّر أيضًا أن المدة لا يمكن تعديلها بعد الإرسال للمراجعة.

4. الإتاحة. اختر دولة أو منطقة واحدة على الأقل في Availability. توضح Apple أنه بدون إتاحة، لا يمكن أن تظهر حالة "Approved".

5. لقطة المراجعة. هذه كانت حالتي على TradaZen، وهي سبب يتكرر كثيرًا في المنتديات. لقطة "App Review Screenshot" تُظهر عملية الشراء كما تبدو في التطبيق، وعادةً هي شاشة الدفع (paywall). تُستخدم للمراجع فقط ولا تُعرض أبدًا على الـ App Store. تتبع مقاسات لقطات App Store الخاصة بك. بعد إرسالها، يمكنك استبدالها، لا حذفها.

لا تخلط بينها وبين الصورة الترويجية بمقاس 1024 x 1024 بكسل. تلك لا تُستخدم إلا إذا أبرزت عملية الشراء في صفحة تطبيقك أو أنشأت عرض استعادة للمشتركين، ولها قواعدها الخاصة. تعلمت ذلك من رفض بسبب الصورة الترويجية لاشتراك.

6. عقد التطبيقات المدفوعة. لتقديم عمليات شراء داخل التطبيق، يجب على صاحب الحساب توقيع Paid Apps Agreement في Business، ثم إدخال بياناته البنكية والضريبية. هذا ليس حقلًا في المنتج، لكن كل شيء يعتمد عليه. تكتب Apple أنك لا تستطيع إنشاء عملية شراء جديدة داخل التطبيق ما لم تقبل أحدث نسخة من العقد. وتضيف صفحتها عن تجهيز عمليات الشراء للمراجعة أن عمليات الشراء المدفوعة لا تعمل أثناء المراجعة ما دام هذا العقد غير نشط. في Business، يجب أن يكون العقد والحساب البنكي والنماذج الضريبية كلها نشطة. هذه الخطوات مفصلة في دليل حساب مطور Apple.

7. أول اشتراك أُرسل وحده. هذه ليست بيانات وصفية ناقصة. ومع ذلك هي السبب الأكثر شيوعًا لمنتج مكتمل لا يُرسل أبدًا للمراجعة. أشرحه بالتفصيل أدناه.

حالات المنتج وما يفك حظر كل واحدة

إليك قائمة التحقق التي أبقيها أمام عيني. العمود الأول يعطي الحالة التي تُرجعها الـ API، والثاني التسمية في مساعدة Apple منذ يوليو 2026.

الحالة (API)	التسمية الحالية	ما يفك الحظر
MISSING_METADATA	Prepare for Submission	ملء الحقول
READY_TO_SUBMIT	Prepare for Submission	Add for Review
لا مقابل لها	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	انتظار Apple
IN_REVIEW	In Review	انتظار Apple
APPROVED	Approved	الدول وتطبيق معتمد
REJECTED	Rejected	التصحيح، Update Review

بالتفصيل:

• من Missing Metadata إلى Ready to Submit. املأ حقول الأسباب من 1 إلى 5، احفظ، ثم أعد تحميل الصفحة. الشاشة التي ظهرت لي في يوليو كانت تعرض "Missing Metadata"، وكانت الحالة التالية تسمى "Ready to Submit".
• من Ready to Submit إلى Ready for Review. في صفحة الاشتراك، اضغط على Add for Review وأضفه إلى إرسال موجود أو إلى إرسال جديد. إجراء إرسال عملية شراء داخل التطبيق يطلب منك اختيار المنصة، وإصدار التطبيق، والمجموعة عند الحاجة. من هذه اللحظة، لا يبقى قابلًا للتعديل إلا الاسم المرجعي والسعر والإتاحة.
• من Ready for Review إلى Waiting for Review. تأكد أن إصدار التطبيق والمجموعة في الإرسال نفسه، ثم اضغط على Submit for Review.
• من Waiting for Review إلى Approved. لا شيء تفعله، سوى إبقاء شاشة الدفع تعمل. إذا انتقلت عملية الشراء إلى "Accepted" وليس إلى "Approved"، فهذا يعني أن عنصرًا آخر في الإرسال نفسه رُفض: Apple لا تعتمد شيئًا ما لم يُقبل كل شيء.
• Rejected. يظهر سبب الرفض في رسائل الإرسال. صحّح العنصر، اضغط على Update Review، ثم أعد إرسال الطلب.

أول اشتراك يُرسل مع إصدار من التطبيق

القاعدة موجودة في مساعدة Apple: أول اشتراك، مثل أول عملية شراء من كل نوع، يجب أن يُرسل مع إصدار جديد من التطبيق. والمجموعة الجديدة تُرسل مع اشتراك واحد على الأقل من اشتراكاتها. بعد اعتماد هذا العنصر الأول، يمكنك إرسال العناصر التالية من النوع نفسه دون إصدار جديد، ما دام للتطبيق إصدار معتمد.

هذا ما حدث على TradaZen. أُرسل إصدار يوليو مع الاشتراك السنوي والشهري. أما الأسبوعي، الذي كان لا يزال في حالة Missing Metadata، فبقي خارج الإرسال. بعد اعتماد التطبيق، أمكن إرساله وحده، دون build جديد.

إذا أرسلت التطبيق بدون اشتراكه، ستحتاج إلى إصدار جديد لاعتماده. يوضح دليل مدة مراجعة App Store كم يكلفك هذا الدور الإضافي من أيام.

العلاقة مع RevenueCat: العرض الفارغ

RevenueCat لا يبيع شيئًا بنفسه. يقرأ الـ SDK معرّفات منتجاتك من خوادمه، ثم يطلب المنتجات من الـ App Store انطلاقًا من الـ iPhone. إذا لم يُرجعها الـ App Store، يصل العرض فارغًا ولا تجد شاشة الدفع ما تعرضه. عندها تعرض سجلات الـ SDK: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

وفقًا لـ RevenueCat، المنتج ذو البيانات الوصفية المكتملة يُحمَّل في بيئة sandbox حتى قبل المراجعة. أما المنتج غير المكتمل، فلا. المسارات الأخرى التي تقدمها RevenueCat وApple:

• عقد التطبيقات المدفوعة والبنك، وقد يستغرق انتشارهما حتى 24 ساعة وفقًا لـ RevenueCat؛
• تعديل على المنتج، قد يستغرق حتى ساعة ليصل إلى sandbox وفقًا لـ Apple؛
• معرّف منتج مختلف بين App Store Connect وRevenueCat والكود الخاص بك.

على TradaZen، يُخفي الكود بطاقة الاشتراك الذي لم يُرجَع منتجه، دون أن تتعطل شاشة الدفع. في أكتوبر 2026، رأيت شاشة دفع بلا عرض لسبب آخر: العرض المقروء من ذاكرة التخزين المؤقت للـ SDK كان فارغًا. منذ ذلك الحين، إذا كان العرض فارغًا، يطلب كود التطبيق المنتجات مباشرة من StoreKit، ويقترح إعادة المحاولة إذا لم يستجب المتجر.

شاشة دفع بلا عرض يجب ألا تكون أبدًا طريقًا مسدودًا، لا للمستخدم ولا للمراجع، الذي يجب أن يتمكن من الشراء. الإعداد الكامل موجود في دليلي RevenueCat لاشتراك iOS، وفخاخ العرض في أخطاء شاشة الدفع. بعد تجهيز المنتج، تحقق أيضًا من أن شاشة الدفع تحترم الإرشاد 3.1.2.

اربط اشتراكك دون أن تقضي أسبوعًا كاملًا

ينطلق iOS & Android Kit من الكود الأساسي لتطبيقاتي: شاشة الترحيب وشاشة الدفع والاشتراكات مبرمجة مسبقًا، وخطوته الثالثة، "ربط المال"، ترشدك لضبطها. السلسلة كاملة، من منتجات App Store Connect إلى التحقق من الشراء، موصوفة في صفحة الاشتراك داخل تطبيق iOS.

إذا كنت تحضّر إطلاقك الأول، قم بالتشخيص المجاني: يعيد ترتيب الخطوات ويرسل لك قائمتي لتجنب رفض Apple. وإذا بقي اشتراكك عالقًا رغم كل هذا، احجز ساعة معي: نفتح App Store Connect الخاص بك معًا ونبحث عن الحقل الفارغ.

الأسئلة الشائعة

لماذا يبقى اشتراكي في حالة Missing Metadata مع أن كل شيء مملوء؟

تحقق أولًا من لقطة المراجعة، ثم من الاسم المعروض لمجموعة الاشتراكات، الذي لا يبدو إلزاميًا. ثم راجع السعر، والمدة، ووجود دولة واحدة على الأقل، وعقد التطبيقات المدفوعة في Business. بعد كل تصحيح، احفظ وأعد تحميل الصفحة قبل أن تحكم.

هل يحتاج الاشتراك إلى لقطة شاشة؟

نعم، لقطة المراجعة المسماة App Review Screenshot. تُظهر عملية الشراء داخل التطبيق، وعادةً شاشة الدفع، وتُستخدم للمراجع فقط. لا تظهر على الـ App Store. لا تخلط بينها وبين الصورة الترويجية بمقاس 1024 x 1024 بكسل، المفيدة فقط لإبراز عملية الشراء أو لعرض استعادة المشتركين.

هل يمكن إرسال اشتراك دون إصدار جديد من التطبيق؟

ليس الاشتراك الأول. أول اشتراك ومجموعته يُرسلان مع إصدار جديد من التطبيق. بعد اعتماد هذا الاشتراك الأول، يمكن إرسال الاشتراكات التالية وحدها، ما دام للتطبيق إصدار معتمد.

ماذا تعني Prepare for Submission لعملية شراء داخل التطبيق؟

هي التسمية في مساعدة Apple منذ يوليو 2026 لمنتج لم يُضف بعد إلى إرسال. تظهر حتى لو كانت هناك بيانات وصفية ناقصة. أما API الخاصة بـ App Store Connect فما زالت تميّز بين الحالتين، بـ MISSING_METADATA وREADY_TO_SUBMIT.

لماذا يُرجع RevenueCat عرضًا فارغًا؟

لأن الـ App Store لم يُرجع أي منتج إلى الـ iPhone. الأسباب الأكثر شيوعًا: بيانات وصفية غير مكتملة، أو عقد تطبيقات مدفوعة غير نشط، أو معرّف منتج مختلف، أو تعديل حديث لم ينتشر بعد. يجب أن تتعامل شاشة الدفع مع هذه الحالة دون أن تعطّل المستخدم.