Missing Metadata App Store Connect: แก้สถานะซับสคริปชันค้าง

Missing Metadata ใน App Store Connect หมายความว่าซับสคริปชันหรือ in-app purchase ของคุณยังขาดข้อมูลบังคับอย่างน้อยหนึ่งช่อง ให้เช็กตามลำดับนี้: ภาษา ราคา ระยะเวลา ประเทศ ภาพสำหรับรีวิว และสัญญาแอปแบบเสียเงิน ตราบใดที่สินค้ายังอยู่ในสถานะนี้ คุณจะส่งรีวิวไม่ได้ และแอปของคุณก็โหลดสินค้านั้นไม่ได้ นอกจากนี้ ซับสคริปชันตัวแรกต้องส่งไปพร้อมกับเวอร์ชันของแอปด้วย

ผมเจอสถานะนี้เมื่อเดือนกรกฎาคม 2026 กับ TradaZen แอปจำลองการเทรดของผม ซับสคริปชันรายสัปดาห์ตัวใหม่มีระยะเวลา ราคา กลุ่ม และสองภาษาครบแล้ว แต่ก็ยังค้างอยู่ที่ Missing Metadata ชิ้นเดียวที่ขาดไปคือภาพสำหรับรีวิว ในบทความนี้มีสาเหตุที่ต้องเช็ก สถานะต่างๆ ของสินค้าพร้อมวิธีปลดล็อกแต่ละสถานะ และความเกี่ยวข้องกับ RevenueCat

Missing Metadata หมายความว่าอะไร?

จนถึงปีนี้ หน้าช่วยเหลือของ Apple นิยามสถานะนี้ไว้ว่า สินค้าถูกสร้างแล้ว แต่คุณยังไม่ได้อัปโหลดภาพหน้าจอหรือกรอกเมทาดาทาให้ครบ สถานะนี้ไม่เคยบอกว่าขาดช่องไหน ปัญหาอยู่ตรงนี้แหละ คุณต้องหาเอง

ระวัง ชื่อสถานะเปลี่ยนไปเมื่อเดือนกรกฎาคม 2026 บันทึกประจำเวอร์ชันของ App Store Connect ประกาศวิธีส่งแบบใหม่เมื่อวันที่ 15 กรกฎาคม: in-app purchase แต่ละตัวส่งจากหน้าของตัวเอง ด้วยปุ่ม Add for Review ส่วนหน้ารายการสถานะ ไม่มี "Missing Metadata" อีกแล้ว แต่เริ่มต้นที่ "Prepare for Submission" และระบุว่า ถ้า in-app purchase ของคุณขาดเมทาดาทาบังคับ ให้กรอกให้ครบก่อนเพิ่มเข้าไปในการส่ง เอกสารของ RevenueCat ก็ยืนยันว่า ก่อนรีวิว สินค้าใหม่จะแสดงเป็น "Prepare for Submission" แม้จะยังขาดเมทาดาทาก็ตาม

ส่วน App Store Connect API ยังคงส่งค่า MISSING_METADATA แล้วตามด้วย READY_TO_SUBMIT เครื่องมือที่ใช้ API นี้จึงยังแสดงคำเหล่านี้อยู่ ไม่ว่าจะเห็นชื่อแบบไหน การวินิจฉัยก็เหมือนกัน: มีช่องบังคับที่ยังว่างอยู่

สาเหตุที่ต้องเช็ก ตามลำดับ

ผมเช็กตามลำดับนี้ ไล่จากหน้าสินค้าไปจนถึงระดับบัญชี

สาเหตุ	แก้ที่ไหน
ชื่อหรือคำอธิบายว่าง	หน้าสินค้า
กลุ่มไม่มีชื่อที่แสดง	หน้ากลุ่ม
ไม่มีราคาหรือระยะเวลา	หน้าสินค้า
ไม่มีประเทศที่เปิดขาย	Availability
ไม่มีภาพสำหรับรีวิว	Review Information
สัญญาแบบเสียเงินยังไม่ active	Business
ส่งซับสคริปชันตัวแรกแยกเดี่ยว	การส่ง (Submission)

1. ภาษาของสินค้า ตามหน้าข้อมูลของ in-app purchase ชื่อที่แสดงและคำอธิบายเป็นข้อมูลบังคับอย่างน้อยหนึ่งภาษา ชื่อยาว 2 ถึง 30 ตัวอักษร คำอธิบายไม่เกิน 45 ตัวอักษร สินค้าที่ไม่มีภาษาเลยจะส่งไม่ได้

2. ภาษาของกลุ่ม กลุ่มซับสคริปชันก็มีชื่อที่แสดงเหมือนกัน ซึ่งผู้สมัครสมาชิกจะเห็นตอนจัดการซับสคริปชันบน iPhone เพิ่มได้ในหน้ากลุ่ม หัวข้อ Display Name and Description ตามที่หน้าของ Apple เรื่องซับสคริปชันอธิบายไว้ ช่องนี้ดูเหมือนไม่บังคับ แต่มีนักพัฒนาคนหนึ่งเล่าไว้ในฟอรัมของ Appleว่า ซับสคริปชันทุกตัวในกลุ่มของเขาค้างอยู่ตราบที่ช่องนี้ยังว่าง สถานะไปแสดงที่ซับสคริปชัน ไม่ได้แสดงที่กลุ่ม เลยทำให้งงกัน

3. ราคาและระยะเวลา ซับสคริปชันต้องมีระยะเวลา ตั้งแต่หนึ่งสัปดาห์ถึงหนึ่งปี และต้องมีราคา บันทึกทางเทคนิค TN3186 เริ่มจากจุดนี้เมื่อสินค้าโหลดไม่ขึ้น: เช็ก identifier ราคา และภาษา และจำไว้ด้วยว่าระยะเวลาจะแก้ไม่ได้อีกหลังส่งรีวิวแล้ว

4. การเปิดขาย เลือกประเทศหรือภูมิภาคอย่างน้อยหนึ่งแห่งใน Availability Apple ระบุว่า ถ้าไม่ได้เปิดขายที่ไหนเลย สถานะ "Approved" จะไม่ขึ้น

5. ภาพสำหรับรีวิว นี่คือกรณีของผมกับ TradaZen และเป็นสาเหตุที่เจอบ่อยในฟอรัม ภาพ "App Review Screenshot" แสดงการซื้อตามที่ปรากฏในแอป ปกติก็คือหน้า paywall ของคุณ ภาพนี้ใช้สำหรับผู้รีวิวเท่านั้น และจะไม่แสดงบน App Store ใช้ขนาดเดียวกับภาพหน้าจอ App Store ของคุณ เมื่ออัปโหลดแล้ว คุณเปลี่ยนภาพได้ แต่ลบไม่ได้

อย่าสับสนกับภาพโปรโมตขนาด 1024 x 1024 พิกเซล ภาพนั้นใช้เฉพาะเมื่อคุณโปรโมตการซื้อบนหน้าแอป หรือสร้างข้อเสนอดึงผู้ใช้กลับ (win-back offer) และมีกฎของมันเอง ผมเรียนรู้เรื่องนี้จากการโดนปฏิเสธเรื่องภาพโปรโมตของซับสคริปชัน

6. สัญญาแอปแบบเสียเงิน ถ้าจะเสนอ in-app purchase เจ้าของบัญชีต้องเซ็น Paid Apps Agreement ใน Business แล้วกรอกข้อมูลธนาคารและภาษี นี่ไม่ใช่ช่องของสินค้า แต่ทุกอย่างขึ้นอยู่กับมัน Apple เขียนไว้ว่า คุณจะสร้าง in-app purchase ใหม่ไม่ได้จนกว่าจะยอมรับสัญญาเวอร์ชันล่าสุด หน้าการเตรียมการซื้อสำหรับรีวิว ยังเสริมว่า การซื้อแบบเสียเงินจะใช้งานไม่ได้ระหว่างรีวิวจนกว่าสัญญานี้จะ active ใน Business สัญญา บัญชีธนาคาร และแบบฟอร์มภาษี ต้อง active ทั้งหมด ขั้นตอนเหล่านี้อธิบายละเอียดไว้ในคู่มือบัญชีนักพัฒนา 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 แล้วเพิ่มเข้าไปในการส่งที่มีอยู่หรือสร้างใหม่ ขั้นตอนการส่ง in-app purchase จะให้คุณเลือกแพลตฟอร์ม เวอร์ชันของแอป และกลุ่ม (ถ้าจำเป็น) ตั้งแต่ตอนนี้ จะแก้ได้แค่ชื่ออ้างอิง ราคา และการเปิดขายเท่านั้น
• จาก 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 จะอ่าน product identifier ของคุณจากเซิร์ฟเวอร์ของมัน แล้วขอสินค้าจาก App Store จากบน iPhone ถ้า App Store ไม่ส่งสินค้ากลับมา offering จะว่างเปล่า และ paywall ก็ไม่มีอะไรให้แสดง log ของ 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 บอก
• product identifier ไม่ตรงกันระหว่าง App Store Connect, RevenueCat และโค้ดของคุณ

ใน TradaZen โค้ดจะซ่อนการ์ดของซับสคริปชันที่สินค้าไม่ถูกส่งกลับมา โดยไม่ทำให้ paywall พัง ในเดือนตุลาคม 2026 ผมเจอ paywall ที่ไม่มี offering ด้วยเหตุผลอื่น: offering ที่อ่านจากแคชของ SDK ว่างเปล่า ตั้งแต่นั้น ถ้า offering ว่าง โค้ดของแอปจะขอสินค้าจาก StoreKit โดยตรง และให้ลองใหม่ได้ถ้า store ไม่ตอบ

paywall ที่ไม่มี offering ต้องไม่เป็นทางตัน ทั้งสำหรับผู้ใช้และผู้รีวิว ซึ่งต้องซื้อได้ การตั้งค่าทั้งหมดอยู่ในคู่มือ 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 พิกเซล ซึ่งใช้เฉพาะตอนโปรโมตการซื้อหรือทำข้อเสนอดึงผู้ใช้กลับ

ส่งซับสคริปชันโดยไม่มีเวอร์ชันใหม่ของแอปได้ไหม?

ตัวแรกไม่ได้ ซับสคริปชันตัวแรกและกลุ่มของมันต้องส่งไปพร้อมเวอร์ชันใหม่ของแอป เมื่อตัวแรกผ่านแล้ว ตัวถัดไปส่งเดี่ยวได้ ตราบใดที่แอปมีเวอร์ชันที่ผ่านแล้ว

Prepare for Submission ของ in-app purchase หมายความว่าอะไร?

เป็นชื่อสถานะในหน้าช่วยเหลือของ Apple ตั้งแต่กรกฎาคม 2026 สำหรับสินค้าที่ยังไม่ได้เพิ่มเข้าไปในการส่ง และจะแสดงแม้ยังขาดเมทาดาทา ส่วน App Store Connect API ยังแยกสองกรณีนี้อยู่ ด้วย MISSING_METADATA และ READY_TO_SUBMIT

ทำไม RevenueCat ส่ง offering ว่างเปล่ากลับมา?

เพราะ App Store ไม่ได้ส่งสินค้าใดๆ กลับมาที่ iPhone สาเหตุที่พบบ่อยที่สุด: เมทาดาทาไม่ครบ สัญญาแอปแบบเสียเงินยังไม่ active product identifier ไม่ตรงกัน หรือการแก้ไขล่าสุดยังไม่มีผล paywall ของคุณต้องรับมือกับกรณีนี้ได้โดยไม่ทำให้ผู้ใช้ติดค้าง