Pedoman Ulasan App Store iOS untuk IAP

Copikan prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Mengapa Anda perlu memperhatikan peraturan Apple dengan teliti untuk mendapatkan aplikasi Anda disetujui di App Store, terutama ketika mengimplementasikan pembelian dalam aplikasi dan langganan.

Proses Tinjauan App Store iOS

Sebelum Anda Mengirimkan

Selesai Mengatur Setup App Store Connect

Sebelum Apple meninjau aliran pembelian Anda, pastikan catatan aplikasi itu sendiri sudah lengkap:

Tambahkan URL Kebijakan Privasi di App Store Connect
Tambahkan sebuah URL Bantuan yang mengarah ke informasi kontak nyata bagi pengguna
Selesaikan penilaian usia context: Halaman/area: Halaman contoh aplikasi solusi. Peran: Label UI pendek atau item navigasi. Dilihat di: komponen solusi/SolutionAppExample.astro. Kunci pesan `solution_app_examples_rating` (Penilaian Aplikasi Solusi).
soal survei sehingga aplikasi dapat dipublikasikan Tambahkan Detail Kontak Ulasan Aplikasi
dan catatan reviewer yang jelas akun demo yang tidak berakhir selama tinjauan

Metadata daftar aplikasi App Store dengan tautan ke kebijakan dan dukungan

Siapkan Screenshot Nyata

Gunakan screenshot saat ini dari build asli yang sedang di tinjau
Untuk iPhone 1290 x 2796 (6,7 inci) adalah ukuran default yang paling mudah
Jika aplikasi Anda dapat menjalankan di iPad, unggah screenshot iPad juga
Ukuran iPad yang diterima saat ini termasuk 2064 x 2752 (13-inch) dan 2048 x 2732 (12.9-inch)
Tidak perlu memanjang layar iPhone untuk memalsukan dukungan iPad

Melakukan Uji Coba Perjalanan Penilai di TestFlight

Jalankan jalur yang tepat yang akan diikuti oleh Apple pada perangkat nyata:

Pasang versi terbaru dari TestFlight
Masuk dengan akun penilaian yang Anda rencanakan untuk menyediakannya
Capai paywall tanpa gerakan tersembunyi atau menu debug
Lakukan alur pembelian, pengembalian, dan pengelolaan langganan
Verifikasi aplikasi masih berperilaku dengan benar jika izin di tolak

Persyaratan Pembelian Aplikasi

Pengungkapan Harga Transparan (Kritis)

Apple memerlukan pengungkapan harga yang jelas sebelum pembelian apa pun:

Elemen Wajib:

Tampilkan harga yang tepat sebelum tombol pembelian
Tampilkan frekuensi pembayaran (misalnya “$9.99/bulan”)
Jelaskan dengan jelas apa yang didapatkan oleh pengguna dengan uang mereka
Indikasikan kapan biaya akan terjadi

Penolakan Umum:

“Harga langganan harus jelas dan terbuka.”

:::peringatan Konsistensi Harga Semua harga harus sesuai di:

Daftar Metadata App Store
Antarmuka Pembelian Aplikasi
Antarmuka Pengelolaan Langganan

Ketidaksesuaian sekecil $1 antara daftar toko ($4.99) dan aplikasi ($5.99) akan memicu penolakan otomatis.

Pengenalan Paket Langganan

Klarifikasi yang Diperlukan:

Tunjukkan semua tingkat langganan yang tersedia secara bersamaan
Perbandingan yang jelas fitur per tingkat
Tidak ada pengaturan otomatis ke tingkat premium melalui trik UI
Instruksi pembatalan yang mudah ditemukan

Petunjuk Desain UI yang Baik dan Benar

Paywall dengan fitur pembelian ulang dan tautan hukum

Contoh UI yang Patuh:

import { NativePurchases } from '@capgo/native-purchases';

function SubscriptionScreen() {
  return (
    <div>
      <h2>Choose Your Plan</h2>

      {/* Show all tiers equally */}
      <PlanCard
        title="Basic"
        price="$4.99/month"
        features={['Feature A', 'Feature B']}
      />
      <PlanCard
        title="Premium"
        price="$9.99/month"
        features={['All Basic', 'Feature C', 'Feature D']}
        highlighted={false} // Don't force premium
      />

      {/* Clear cancellation info */}
      <Text>
        Cancel anytime in Settings > Subscriptions.
        No refunds for partial periods.
      </Text>
    </div>
  );
}

Pembelian Ulang

Pengimplementasian yang Diperlukan:

Setiap aplikasi dengan IAP harus menyediakan cara untuk pengguna untuk memulihkan pembelian sebelumnya tanpa menghubungi dukungan.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function restorePurchases() {
  try {
    await NativePurchases.restorePurchases();

    const { purchases } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.SUBS,
    });

    const activeSub = purchases.find(
      (purchase) => purchase.isActive && purchase.expirationDate,
    );

    if (activeSub) {
      unlockPremiumFeatures();
      showMessage('Purchases restored successfully!');
      return;
    }

    const { purchases: iaps } = await NativePurchases.getPurchases({
      productType: PURCHASE_TYPE.INAPP,
    });
    const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');

    showMessage(
      hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
    );
  } catch (error) {
    showError('Failed to restore purchases. Please try again.');
  }
}

// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
  Restore Purchases
</Button>

Alasan Penolakan yang Umum

1. Aplikasi Bajik atau Fungsi yang Rusak

Why Ini Gagal:

Applikasi mengalami crash saat dijalankan
Aliran pembelian gagal untuk diselesaikan
Fasilitas yang ditampilkan dalam screenshot tidak berfungsi

Pencegahan:

Uji coba pada perangkat nyata (bukan hanya simulator)
Uji coba semua aliran langganan secara end-to-end
Verifikasi validasi strukturnya berfungsi
Periksa penanganan kesalahan jaringan

2. Kesalahan Metadata

Why Ini Gagal:

Gambar tangkapan menampilkan fitur yang tidak ada di build saat ini
Deskripsi menyebutkan fungsi yang tidak ada
Harga di metadata berbeda dari harga di aplikasi

Daftar Periksa Metadata

Pencegahan:

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
  basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
  premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};

// Use these in both your app AND App Store description

3. Penjelasan Izin yang Hilang

Mengapa Gagal:

Mengajukan kamera/lokasi/kesehatan tanpa penjelasan
Mengajukan izin yang disembunyikan di beberapa layar
Penjelasan izin yang kabur atau umum

Pencegahan:

Perbarui dengan penjelasan yang jelas: Info.plist Salinan izin yang terlalu umum untuk tinjauan

Salinan izin dengan penjelasan yang lebih jelas

<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

Bab yang berjudul “4. Pemasaran yang Menipu”

Klaim seperti “Aplikasi #1 di dunia” tanpa bukti

Fitur “Tidak Terbatas” yang memiliki batasan rahasia
Taktik kebutuhan darurat palsu (“Hanya 2 tempat yang tersedia!”)
Section titled “4. Pemasaran yang Menipu”

Pedoman Deskripsi Contoh

Pedoman Deskripsi Tambahan

Pencegahan:

Deskripsikan secara spesifik dan faktual
Hindari superlatif tanpa bukti
Jangan memaksa pengguna dengan kekurangan palsu

5. Proses Pembatalan Tersembunyi

Mengapa Gagal:

Tidak ada penjelasan tentang cara pembatalan
Tombol pembatalan disembunyikan atau tertutup
Proses pembatalan multi-langkah tanpa alur native Apple

Pencegahan:

// Always inform users about cancellation
function SubscriptionInfo() {
  return (
    <div>
      <h3>How to Cancel</h3>
      <ol>
        <li>Open iPhone Settings</li>
        <li>Tap your name at the top</li>
        <li>Tap Subscriptions</li>
        <li>Select this app and tap Cancel</li>
      </ol>

      <p>Or manage directly in the App Store app.</p>

      <Button onClick={openSubscriptionManagement}>
        Manage Subscription in Settings
      </Button>
    </div>
  );
}

async function openSubscriptionManagement() {
  // Direct link to iOS subscription management
  await NativePurchases.showManageSubscriptions();
}

Privasi & Penggunaan Data (Bagian 5.1.1)

Apple telah memperketat persyaratan privasi pada tahun 2025.

Penyataan yang Diperlukan

Untuk Setiap Izin:

Mengapa Anda membutuhkannya (penggunaan kasus spesifik)
Kapan akan digunakan
Bagaimana data disimpan/dibagikan
Apakah itu opsional atau wajib

Contoh: Alur Izin yang Tepat

async function requestCameraPermission() {
  // Show explanation BEFORE requesting
  await showDialog({
    title: 'Camera Access',
    message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
    buttons: ['Not Now', 'Allow']
  });

  // Then request permission
  const result = await Camera.requestPermissions();
  return result.camera === 'granted';
}

Label Gizi Privasi

Pastikan label privasi App Store Anda akurat menggambarkan:

Sejarah Pembelian
Alamat Email (untuk bukti pembelian)
ID Perangkat (untuk pencegahan penipuan)
Data Penggunaan (untuk analisis)

Label privasi yang tidak akurat merupakan alasan penolakan umum pada tahun 2025. Audit dengan hati-hati pengumpulan data Anda.

Daftar Periksa Sebelum Pengiriman

Pemeriksaan Sebelum Pengiriman

Tes Semua Aliran Pembelian
- Belilah setiap tingkat langganan
- Tes uji coba gratis
- Pastikan penawaran promosi berlaku dengan benar
- Tes pembelian kembali
- Pastikan Bagian Keluarga Berbagi (jika diaktifkan)
- Tes pada perangkat yang berbeda
Pastikan Konsistensi Harga
- Periksa metadata App Store sesuai dengan harga dalam aplikasi
- Pastikan semua mata uang benar
- Konfirmasi durasi percobaan gratis sesuai dengan deskripsi
- Periksa syarat-syarat penawaran introdusif yang akurat
Ulas Semua Konten
- Hapus teks tempat
- Pastikan klaim dapat diuji
- Periksa tata bahasa dan ejaan
- Pastikan deskripsi sesuai dengan build saat ini
- Hapus pengacuan kompetitor
Test Hak Akses
- Hanya minta izin yang diperlukan
- Tunjukkan penjelasan yang jelas sebelum meminta izin
- Test aliran
- Verifikasi Deskripsi Info.plist yang Jelas
Siapkan Akun Uji
- Buat Akun Tinjauan yang Tetap Aktif Selama Tinjauan
- Dokumentasi Kredensial Login di Informasi Tinjauan Aplikasi
- Verifikasi Pengguna Tinjauan dapat Mencapai Paywall dan Menyelesaikan Alur Pembelian
- Termasuk Akun Tambahan atau Switch Aplikasi Khusus di Bidang Catatan jika Diperlukan
Periksa Metadata
- Gambar Layar Cocok dengan UI Saat Ini
- URL Support Termasuk Informasi Kontak yang Nyata
- URL Kebijakan Privasi Terisi
- Rating Usia Cocok dengan Konten di Build
- Video Pratinjau Aplikasi (jika ada) Menampilkan Versi Saat Ini
- Deskripsi akurat menggambarkan fitur-fitur
- Kebijakan privasi dapat diakses dalam aplikasi dan dari daftar aplikasi

Tulis Catatan Ulasan Rinci

Contact:
Name: Jane Developer
Email: review@yourapp.com
Phone: +1 555-0100

Test Account:
Email: reviewer@test.com
Password: TestPass123!
This account does not expire during review.

Testing Instructions:
1. Log in with test account above
2. Tap "Upgrade to Premium" button
3. Select "Monthly Premium" subscription
4. Complete purchase (no charge in sandbox)
5. Verify premium features unlock

Note: Subscription pricing is clearly shown before purchase.
Cancellation instructions are in Settings > Account.

Jadwal Ulasan

Jadwal Ulasan App Store

Review Standar: 24-48 jam Masa Sibuk: 3-5 hari (rilis aplikasi hari libur App Store) Mingguan: No review yang diproses Ulasan Cepat: Tersedia untuk perbaikan bug kritikal (permintaan melalui App Store Connect)

Status umum yang akan Anda lihat di App Store Connect:

Waiting for Review
In Review
Pending Developer Release
Rejected

Fokus Pengiriman 2026

Daerah Fokus Saat Ini

1. Klarifikasi Langganan

Perbandingan rencana samping-samping yang diperlukan
Tidak ada “pola gelap” yang menyembunyikan opsi yang lebih murah
Rute penurunan/peningkatan yang jelas

2. Akurasi Metadata

Gambar layar harus sesuai dengan versi yang sedang direview
Gambar layar iPad diperlukan jika dukungan iPad diaktifkan
URL dukungan dan kebijakan privasi harus sudah aktif sebelum pengajuan

3. Kualitas Detail Ulasan dan Privasi

Penyataan privasi harus sesuai dengan apa yang dikumpulkan oleh SDK Anda
Info kontak dan catatan App Review harus lengkap pada pengajuan pertama
Kredensial demo harus tetap valid selama jendela ulasan penuh

4. Kesiapan Pengajuan

Apple memperbarui persyaratan minimum SDK secara teratur, jadi pastikan tanggal yang berlaku saat ini sebelum mengunggah rilis build
TestFlight adalah tempat yang paling aman untuk memverifikasi jalur reviewer yang tepat sebelum Anda mengirimkan

Praktik Terbaik untuk Plugin Pembelian Asli

Implementasikan Pengelolaan Kesalahan yang Tepat

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

async function handlePurchase(productId: string) {
  try {
    const transaction = await NativePurchases.purchaseProduct({
      productIdentifier: productId,
      productType: PURCHASE_TYPE.SUBS,
    });

    // Success
    await validateReceiptOnServer(transaction.receipt);
    showSuccess('Subscription activated!');
    unlockFeatures();

  } catch (error: any) {
    // Handle specific error cases
    if (error.code === 'USER_CANCELLED') {
      // User cancelled - don't show error
      console.log('Purchase cancelled by user');
    } else if (error.code === 'PAYMENT_PENDING') {
      showInfo('Payment is pending. Please check back later.');
    } else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
      // Restore instead
      await NativePurchases.restorePurchases();
    } else {
      // Show user-friendly error
      showError('Unable to complete purchase. Please try again.');
    }
  }
}

Tampilkan Status Menggunakan

function PurchaseButton({ productId }: { productId: string }) {
  const [loading, setLoading] = useState(false);

  const handlePurchase = async () => {
    setLoading(true);
    try {
      await NativePurchases.purchaseProduct({ productIdentifier: productId });
    } finally {
      setLoading(false);
    }
  };

  return (
    <button onClick={handlePurchase} disabled={loading}>
      {loading ? 'Processing...' : 'Subscribe Now'}
    </button>
  );
}

Tampilkan Ketentuan dengan Jelas

function SubscriptionTerms() {
  return (
    <div className="terms">
      <p>
        Subscription automatically renews unless cancelled at least 24 hours
        before the end of the current period.
      </p>
      <p>
        Your account will be charged for renewal within 24 hours prior to
        the end of the current period.
      </p>
      <p>
        Subscriptions may be managed by the user and auto-renewal may be
        turned off in Account Settings after purchase.
      </p>
      <p>
        <a href="/terms">Terms of Service</a> |
        <a href="/privacy/">Privacy Policy</a>
      </p>
    </div>
  );
}

Jika Aplikasi Anda Ditolak

Langkah untuk Menyelesaikan

Baca penolakan dengan teliti
- Catat pedoman spesifik yang disebutkan (misalnya, 3.1.1, 5.1.1)
- Pahami secara tepat apa yang ditandai oleh Apple
Perbaiki masalah secara menyeluruh
- Tidak hanya perbaiki - perbaiki penyebab akar
- Uji perbaikan secara menyeluruh
- Dokumentasikan perubahan yang Anda buat

Balas di Pusat Resolusi

Thank you for your feedback. I have addressed the issue:

Issue: Subscription pricing not clear upfront

Fix: Added explicit pricing display on subscription selection
screen showing "$9.99/month" before purchase button. Also added
cancellation instructions on the same screen.

The changes are in this submission and can be tested using the
provided test account.

Resubmit dengan segera
- Resubmisi biasanya diperiksa lebih cepat
- Biasanya dalam waktu 24 jam

Proses Banding

Jika Anda percaya bahwa penolakan itu salah:

Proses Penjelasan App Store

Klik “Banding” di App Store Connect
Berikan bukti yang jelas:
- Gambar layar menunjukkan kelayakan
- Referensi pada pedoman spesifik
- Penjelasan bagaimana Anda memenuhi persyaratan
Jadilah profesional dan faktual
Termasuk akun uji jika fungsi sulit ditemukan

Contoh Permintaan Dokumen

Sumber Daya Tambahan

Bantuan

Jika Anda masih mengalami masalah: Review
Dokumentasi Pembelian Nativ Periksa
masalah troubleshooting umum

Hubungi Dukungan Pengembang Apple untuk klarifikasi pedoman

Bantuan Ahli Jadwalkan panggilan konsultasi dengan tim kami untuk dukungan yang terdedikasi dengan:

Ulasan dan optimasi implementasi IAP
Persiapan dan strategi ulasan App Store
Ulasan daftar pemeriksaan lengkap
Pengembalian penolakan dan banding
Pengujian dan validasi lengkap

Ahli kami telah berhasil membantu ratusan aplikasi melewati ulasan!

Teruskan dari Pedoman Ulasan App Store iOS untuk IAP

Jika Anda menggunakan Pedoman Ulasan App Store iOS untuk IAP Mengatur persetujuan dan distribusi toko, hubungkannya dengan Menggunakan @capgo/native-purchases untuk kemampuan asli dalam Menggunakan @capgo/native-purchases, @capgo/capacitor-ulasan-dalam-aplikasi untuk detail implementasi dalam @capgo/capacitor-ulasan-dalam-aplikasi, dan Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi untuk kemampuan asli dalam Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi, @capgo/capacitor-pasar-native untuk detail implementasi dalam @capgo/capacitor-pasar-native, dan Menggunakan @capgo/capacitor-pasar-native untuk kemampuan asli dalam Menggunakan @capgo/capacitor-pasar-native.