Guideline 2.3.2: ảnh quảng bá gói đăng ký bị từ chối

Guideline 2.3.2 liên quan đến trang thông tin các giao dịch mua trong ứng dụng của bạn. Một lỗi bị từ chối rất dễ gặp với guideline này: dùng icon của app làm ảnh quảng bá cho gói đăng ký. Apple muốn mỗi giao dịch mua có một ảnh riêng, hoặc không có ảnh nào cả.

Mình đã dính lỗi này với Nolera, app tủ quần áo của mình, trên hai gói đăng ký cùng lúc. Dưới đây là những gì quy định yêu cầu và cách sửa, kể cả khi lượt gửi bị khóa.

Guideline 2.3.2 nói gì?

Guideline 2.3.2 thuộc mục 2.3 "Accurate Metadata" trong App Review Guidelines, mục yêu cầu trang thông tin phải chính xác. Nó nói ba điều:

• mô tả, ảnh chụp màn hình và video xem trước của bạn phải ghi rõ những gì cần mua thêm;
• nếu bạn chọn quảng bá giao dịch mua trong ứng dụng trên App Store, tên, hình ảnh ("Screenshot" trong văn bản quy định) và mô tả của chúng phải phù hợp với mọi lứa tuổi và tuân theo hướng dẫn của Apple;
• app của bạn phải hoàn tất được giao dịch mua bắt đầu từ App Store.

Phần thứ hai là cái bẫy. Trong App Store Connect, mỗi gói đăng ký và mỗi giao dịch mua trong ứng dụng có một trường "ảnh quảng bá" (Promotional Image). Người ta điền nhanh, bằng thứ có sẵn trong tay. Và thứ có sẵn trong tay chính là icon.

Apple mong đợi gì ở ảnh quảng bá

Hướng dẫn nằm ở trang Promoting Your In-App Purchases.

• Định dạng: PNG hoặc JPEG chất lượng tốt, 1024 × 1024 pixel.
• Nội dung: một ảnh riêng, đại diện cho đúng giao dịch mua đó.
• Ảnh chụp màn hình: không, ảnh không được là ảnh chụp màn hình.
• Icon của app: không, ảnh không được dễ bị nhầm với icon.
• Chữ trên ảnh: không nên.
• Góc dưới bên trái: không đặt gì quan trọng, Apple sẽ đặt một khung và đôi khi cả icon của app ở đó.

Theo mình, điểm cuối giải thích quy định về icon. Khi một giao dịch mua hiển thị bên ngoài trang của bạn, ví dụ trong kết quả tìm kiếm, Apple đã tự thêm icon app vào góc ảnh. Nếu bản thân ảnh lại là icon, hình ảnh đó chẳng nói được gì về giao dịch mua nữa.

Lần bị từ chối 2.3.2 của mình với Nolera

Ngày 17 tháng 9 năm 2026, Nolera bị từ chối sau một lượt review trên iPad Air. Thông báo nêu nhiều quy định, trong đó có 2.3.2: ảnh quảng bá của các gói đăng ký không hợp lệ.

Nguyên nhân: trên hai gói đăng ký, ảnh quảng bá là bản sao icon của app.

Cách sửa: gỡ ảnh khỏi cả hai gói đăng ký, rồi tạo lại lượt gửi.

Bài học: mọi thành phần trên trang thông tin đều được kiểm tra, kể cả những thứ bạn điền mà không để ý. Một trường không bắt buộc để trống chẳng tốn gì. Một trường điền sai sẽ tốn bạn một vòng review.

Có thật sự cần ảnh quảng bá không?

Không, trong trường hợp thông thường. Theo trợ giúp của App Store Connect, ảnh chỉ bắt buộc trong hai trường hợp: nếu bạn quảng bá giao dịch mua trên trang của mình, hoặc nếu bạn thiết lập ưu đãi giành lại người dùng (win-back offers). Ngoài các trường hợp đó, bạn có thể để trống. Mình đã làm vậy với Nolera.

Nếu bạn muốn quảng bá một gói đăng ký, hãy tạo một ảnh thật sự: hình ảnh không có chữ, nhìn rõ khi thu nhỏ, thể hiện những gì gói đăng ký mở khóa.

Sửa một lượt gửi bị khóa

Sau khi bị từ chối, lượt gửi của bạn chuyển sang trạng thái "Unresolved Issues". Ở trạng thái này, các gói đăng ký nằm trong lượt gửi bị khóa: không thể xóa ảnh quảng bá của chúng.

Đây là cách đã hiệu quả với mình, dùng API của App Store Connect qua dòng lệnh. Mình chưa kiểm tra cách tương đương trên giao diện web.

1. Ghi lại mọi thành phần của lượt gửi: phiên bản app, từng gói đăng ký, nhóm gói đăng ký, từng giao dịch mua trong ứng dụng.
2. Gỡ gói đăng ký bị lỗi khỏi lượt gửi. Cẩn thận, thao tác gỡ này không hoàn tác được, và sau đó bạn không thể thêm gì vào lượt gửi này nữa.
3. Sửa gói đăng ký, giờ đã chỉnh sửa được: xóa hoặc thay ảnh.
4. Hủy lượt gửi, đợi việc hủy hoàn tất, rồi tạo một lượt gửi mới.
5. Thêm lại từng thành phần đã ghi ở bước 1, gắn build của bạn và gửi lại tất cả.

Nếu lý do từ chối chỉ là một điểm bạn sửa được mà không đụng đến gói đăng ký, chính lượt gửi đó có thể gửi lại. Chi tiết trao đổi với Apple có trong hướng dẫn về guideline 2.1.

Checklist 2.3.2 trước khi gửi

• Mỗi giao dịch mua trong ứng dụng có tên và mô tả phù hợp với mọi lứa tuổi.
• Không ảnh quảng bá nào là icon của app hay ảnh chụp màn hình.
• Giao dịch mua bạn không quảng bá thì không cần ảnh: để trống trường đó.
• Mô tả và ảnh chụp màn hình của bạn nói rõ những gì phải trả phí.
• Các gói đăng ký gửi lần đầu đã được đính kèm đúng vào phiên bản app.

Để thiết lập đầy đủ gói đăng ký, hãy đọc gói đăng ký in-app với RevenueCat.

Tránh bị từ chối 2.3.2 trước lần gửi tiếp theo

Apple Review Kit gồm checklist trước khi gửi của mình, các lần bị Apple từ chối mình đã sửa, và các skill Claude Code đọc lại dự án và trang thông tin của bạn. Nếu lượt gửi của bạn bị kẹt và bạn muốn có người xem giúp, đặt một giờ với mình: chúng ta cùng xem lại qua video call, trên màn hình của bạn. Quy trình đầy đủ có ở trang ứng dụng bị Apple từ chối, và các lý do phổ biến khác có trong vì sao Apple từ chối app.

Nếu bạn đang chuẩn bị ra mắt app đầu tiên, làm bài chẩn đoán miễn phí: nó sắp xếp lại các bước theo thứ tự và gửi bạn checklist chống bị Apple từ chối của mình.

Câu hỏi thường gặp

Có thể dùng icon của app làm ảnh quảng bá không?

Không. Apple yêu cầu ảnh không được dễ bị nhầm với icon của app. Bên ngoài trang của bạn, Apple đã thêm icon vào một góc ảnh: lặp lại nó chẳng có ích gì. Đó là lý do mình bị từ chối 2.3.2 với Nolera.

Ảnh quảng bá của gói đăng ký cần kích thước bao nhiêu?

Apple yêu cầu file PNG hoặc JPEG 1024 × 1024 pixel, hệ màu RGB, đã làm phẳng (flatten) và không bo góc. Ảnh thường hiển thị nhỏ: nó phải dễ nhìn khi thu nhỏ, không có chi tiết quan trọng ở góc dưới bên trái.

Có cần ảnh quảng bá cho từng gói đăng ký không?

Không. Ảnh chỉ bắt buộc nếu bạn quảng bá gói đăng ký trên trang của mình hoặc thiết lập ưu đãi giành lại người dùng. Khi đó mỗi giao dịch mua được quảng bá có ảnh riêng. Nếu không, hãy để trống thay vì đặt icon vào.

Có cần build mới sau khi bị từ chối 2.3.2 không?

Không, nếu chỉ vì lý do này. Ảnh quảng bá thuộc về trang thông tin, không phải file nhị phân. Bạn sửa trong App Store Connect rồi gửi lại. Trường hợp của mình phải tạo lại lượt gửi, vì các gói đăng ký bị khóa.