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. השפה של הקבוצה. גם לקבוצת המנויים יש שם תצוגה, שהמנויים שלכם רואים כשהם מנהלים את המנויים שלהם באייפון. מוסיפים אותו בעמוד הקבוצה, באזור 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 פיקסלים. היא נחוצה רק אם אתם מקדמים את הרכישה בדף האפליקציה או יוצרים הצעת win-back, ויש לה כללים משלה. למדתי את זה מדחייה על התמונה הקידומית של מנוי.

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. אין מה לעשות, חוץ מלשמור על ה-paywall עובד. אם הרכישה עוברת ל-"Accepted" ולא ל-"Approved", רכיב אחר באותה הגשה נדחה: Apple לא מאשרת כלום עד שהכול מתקבל.
• Rejected. הסיבה מופיעה בהודעות של ההגשה. תקנו את הרכיב, לחצו על Update Review, ושלחו שוב את ההגשה.

המנוי הראשון יוצא עם גרסה של האפליקציה

הכלל כתוב בעזרה של Apple: המנוי הראשון, כמו הרכישה הראשונה מכל סוג, חייב להישלח עם גרסה חדשה של האפליקציה. קבוצה חדשה יוצאת עם לפחות אחד מהמנויים שלה. אחרי שהרכיב הראשון הזה אושר, אפשר לשלוח את הבאים מאותו סוג בלי גרסה חדשה, כל עוד לאפליקציה יש גרסה מאושרת.

זה מה שקרה ב-TradaZen. הגרסה של יולי יצאה עם המנוי השנתי והחודשי. השבועי, שעדיין היה ב-Missing Metadata, נשאר מחוץ להגשה. אחרי שהאפליקציה אושרה, הוא יכל לצאת לבד, בלי build חדש.

אם תשלחו את האפליקציה בלי המנוי שלה, תצטרכו גרסה חדשה כדי לאשר אותו. המדריך על זמן האישור ב-App Store מראה כמה ימים עולה הסבב הנוסף הזה.

הקשר ל-RevenueCat: offering ריק

RevenueCat לא מוכר כלום בעצמו. ה-SDK קורא את מזהי המוצרים שלכם מהשרתים שלו, ואז מבקש את המוצרים מה-App Store, מהאייפון. אם ה-App Store לא מחזיר אותם, ה-offering מגיע ריק ול-paywall אין מה להציג. הלוגים של ה-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, הקוד מסתיר את הכרטיס של מנוי שהמוצר שלו לא הוחזר, בלי לשבור את ה-paywall. באוקטובר 2026 ראיתי paywall בלי הצעה מסיבה אחרת: ה-offering שנקרא מהמטמון של ה-SDK היה ריק. מאז, אם ה-offering ריק, הקוד של האפליקציה מבקש את המוצרים ישירות מ-StoreKit, ומציע לנסות שוב אם החנות לא עונה.

paywall בלי הצעה אף פעם לא אמור להיות מבוי סתום, לא למשתמש ולא לבודק, שחייב להיות מסוגל לקנות. כל ההרכבה נמצאת במדריך שלי RevenueCat למנוי iOS, ומלכודות התצוגה בטעויות paywall. כשהמוצר מוכן, בדקו גם שה-paywall שלכם עומד בguideline 3.1.2.

לחבר את המנוי בלי לבזבז על זה שבוע

ה-iOS & Android Kit מבוסס על קוד הבסיס של האפליקציות שלי: onboarding, paywall ומנויים כבר כתובים, והשלב השלישי שלו, "לחבר את הכסף", מדריך אתכם בהגדרה שלהם. כל השרשרת, מהמוצרים ב-App Store Connect ועד אימות הרכישה, מתוארת בעמוד מנוי in-app ב-iOS.

אם אתם מכינים את ההשקה הראשונה שלכם, עשו את האבחון החינמי: הוא מסדר את השלבים ושולח לכם את הצ'קליסט שלי נגד דחיות של Apple. אם המנוי עדיין תקוע אחרי כל זה, קבעו איתי שעה: נפתח יחד את ה-App Store Connect שלכם ונחפש את השדה הריק.

שאלות נפוצות

למה המנוי שלי נשאר ב-Missing Metadata למרות שהכול מלא?

קודם בדקו את צילום המסך לבדיקה, ואז את שם התצוגה של קבוצת המנויים, שלא נראה חובה. אחר כך בדקו מחיר, משך, לפחות מדינה אחת, ואת חוזה האפליקציות בתשלום ב-Business. אחרי כל תיקון, שמרו וטענו מחדש את העמוד לפני שאתם מסיקים משהו.

צריך צילום מסך בשביל מנוי?

כן, צילום המסך לבדיקה, שנקרא App Review Screenshot. הוא מראה את הרכישה באפליקציה, בדרך כלל ה-paywall, ומשמש רק את הבודק. הוא לא מוצג ב-App Store. אל תבלבלו אותו עם התמונה הקידומית בגודל 1024 x 1024 פיקסלים, שנחוצה רק כדי לקדם את הרכישה או להצעת win-back.

אפשר לשלוח מנוי בלי גרסה חדשה של האפליקציה?

לא את הראשון. המנוי הראשון והקבוצה שלו יוצאים עם גרסה חדשה של האפליקציה. אחרי שהמנוי הראשון אושר, הבאים יכולים לצאת לבד, כל עוד לאפליקציה יש גרסה מאושרת.

מה זה Prepare for Submission ברכישה מתוך האפליקציה?

זו התווית בעזרה של Apple מאז יולי 2026 למוצר שעוד לא נוסף להגשה. היא מוצגת גם אם חסרה מטא-דאטה. ה-API של App Store Connect עדיין מבדיל בין שני המקרים, עם MISSING_METADATA ו-READY_TO_SUBMIT.

למה RevenueCat מחזיר offering ריק?

כי ה-App Store לא החזיר אף מוצר לאייפון. הסיבות הנפוצות: מטא-דאטה לא מלאה, חוזה אפליקציות בתשלום לא פעיל, מזהה מוצר שונה, או שינוי אחרון שעוד לא התעדכן. ה-paywall שלכם צריך לטפל במקרה הזה בלי לחסום את המשתמש.