Buat Langganan Auto-Renewable iOS

Langganan yang dapat diperbarui secara otomatis memberikan akses berulang kepada konten, layanan, atau fitur premium di aplikasi iOS Anda. Panduan ini akan membantu Anda membuat langganan di App Store Connect.

Ringkasan

Langganan otomatis yang dapat diperbarui secara otomatis akan diperbarui pada akhir setiap periode pembayaran sampai pengguna membatalkan. Mereka sangat cocok untuk:

• Konten dan fitur premium
• Pengalaman tanpa iklan
• Penyimpanan awan dan sinkronisasi
• Pelayanan streaming
• Alat-alat profesional dan utilitas

Prasyarat

Sebelum membuat langganan, Anda harus:

1. Membuat kelompok langganan untuk mengatur langganan Anda
2. Anda memiliki keanggotaan aktif Program Pengembang Apple
3. Informasi perbankan dan pajak lengkap di App Store Connect

Membuat Langganan

1. Navigasikan ke Langganan

   Di App Store Connect, pilih aplikasi Anda dan pergi ke Monetize > Langganan.

   Pilih kelompok langganan Anda atau buat yang baru jika perlu.

   

2. Buat Langganan Baru

   Klik + Ikon berikutnya di grup langganan Anda untuk menambahkan langganan baru.

3. Masukkan Informasi Dasar

   Nama Referensi: Nama deskriptif untuk penggunaan internal (tidak ditampilkan kepada pelanggan)

   • Contoh: “Langganan Bulanan Premium”, “Langganan Tahunan Ultimate”, “Rencana Dasar”

   ID Produk: Identifikasi unik untuk langganan ini (tidak dapat diubah kemudian)

   • Format: com.yourcompany.yourapp.premium_monthly
   • Pilih nama yang deskriptif dan huruf kecil dengan garis bawah
   • Diperlukan untuk mengonfigurasi plugin native-purchases

   

4. Konfigurasi Durasi

   Pilih durasi langganan dari opsi yang tersedia:

   • 1 minggu
   • 1 bulan
   • 2 bulan
   • 3 bulan
   • 6 bulan
   • 1 tahun

   Durasi menentukan berapa sering pengguna dikenakan tagihan.

5. Set Up Pricing

   Klik Tambah Harga Langganan untuk mengkonfigurasi harga:

   Wilayah Dasar: Pilih wilayah utama Anda (biasanya negara Anda)

   Harga: Tentukan harga langganan

   • Apple secara otomatis mengonversi ke mata uang lain
   • Pilih dari tingkat harga Apple
   • Perhatikan nilai yang dipahami dan tarif pasar

   

6. Bagikan Keluarga (Opsional)

   Putuskan apakah untuk mengaktifkan Bagikan Keluarga, yang memungkinkan hingga 6 anggota keluarga untuk mengakses langganan

   Peringatan

   Setelah Family Sharing diaktifkan, tidak dapat dinonaktifkan untuk produk ini.

   Aktifkan jika:

   • Konten sesuai untuk penggunaan keluarga
   • Anda ingin meningkatkan nilai proporsional
   • Model bisnis Anda mendukungnya

   Jangan aktifkan jika:

   • Langganan hanya untuk penggunaan individu
   • Konten disesuaikan untuk pengguna
   • Anda ingin maksimalkan pendapatan per pengguna

7. Tambahkan Lokalisasi

   Tambahkan informasi tampilan langganan di semua bahasa yang didukung aplikasi Anda:

   Nama Tampilan Langganan: Nama yang terlihat oleh pelanggan (misalnya, “Premium Bulanan”)

   Deskripsi: Ringkasan singkat tentang apa yang termasuk dalam langganan

   • Jaga agar ringkasan singkat dan fokus pada manfaat
   • Sebutkan fitur utama
   • Tunjukkan proporsi nilai

   

8. Gambar Promosi App Store (Opsional)

   Unggah gambar promosi untuk langganan ini (312x390 piksel):

   • Muncul di halaman langganan App Store
   • Harus sesuai dengan desain aplikasi Anda
   • Termasuk nama langganan untuk kejelasan

   Catatan

   Sementara gambar tidak wajib untuk pengajuan awal, mereka diperlukan untuk tampilan promosi di App Store. Anda dapat menambahkannya kemudian.

9. Simpan dan Kirim

   Klik Simpan untuk membuat langganan.

   Untuk Langganan Pertama:

   • Harus disampaikan bersama versi aplikasi baru
   • Termasuk dalam pengajuan App Store berikutnya
   • Tidak dapat disampaikan secara independen

   Untuk Langganan Selanjutnya:

   • Dapat disubmit langsung dari halaman Subscriptions
   • Tidak memerlukan versi aplikasi baru
   • Tersedia setelah pertama kali persetujuan langganan disetujui

Status Langganan

Langganan Anda akan memiliki salah satu status ini:

Status	Deskripsi	Bisa Uji?
Kurang Metadata	Pengaturan tidak lengkap	Ya (sandbox)
Siap untuk Dikirim	Sudah lengkap tapi belum dikirim	Ya (sandbox)
Menunggu Ulasan	Dikirim ke Apple	Ya (sandbox)
Dalam Ulasan	Dinilai oleh Apple	Ya (sandbox)
Disetujui	Tersedia untuk dibeli	Ya (sandbox)
Ditolak	Perlu perubahan	Ya (sandbox)

Tip

Anda dapat menguji langganan di mode sandbox bahkan jika mereka menampilkan “Metadata Hilang” atau “Siap Dikirim”!

Menggunakan di Aplikasi Anda

Setelah dibuat, referensi langganan di aplikasi Anda menggunakan ID produk:

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

// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
  productIdentifiers: [
    'com.yourcompany.yourapp.premium_monthly',
    'com.yourcompany.yourapp.premium_annual',
  ],
  productType: PURCHASE_TYPE.SUBS,
});

products.forEach((product) => {
  console.log(`${product.title}: ${product.priceString}`);
  console.log(`Duration: ${product.subscriptionPeriod}`);
  console.log(`Description: ${product.description}`);
});

// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Transaction ID:', transaction.transactionId);

  // StoreKit receipts are included on iOS for server-side validation
  await sendReceiptToBackend(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const premium = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);

if (premium?.isActive) {
  console.log('Expires:', premium.expirationDate);
  console.log('Will renew:', premium.willCancel === false);
  console.log('Store state:', premium.subscriptionState);
  unlockPremiumFeatures();
} else {
  showPaywall();
}

Langganan Bulanan dengan Komitmen 12-Bulan

If App Store Connect Anda terkonfigurasi dengan rencana pembayaran bulanan dan komitmen 12 bulan, StoreKit dapat mengembalikan istilah harga tambahan untuk produk tersebut. Gunakan istilah-istilah tersebut untuk menampilkan biaya bulanan, harga komitmen total, dan periode komitmen penuh sebelum pembelian.

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);

const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });
}

Untuk alur penuh paywall dan hak akses, lihat Rencana pembayaran bulanan iOS dengan komitmen.

Praktik Terbaik

Strategi Harga

• Rencana bulanan: Batasan masuk yang lebih rendah, membentuk kebiasaan
• Rencana tahunan: Nilai yang lebih baik, LTV yang lebih tinggi, churn yang lebih rendah
• Berbagai tingkat: Dasar, Premium, Ultimate untuk segmen pengguna yang berbeda
• Analisis kompetitif: Riset harga aplikasi serupa

ID Produk

• Gunakan penamaan konsisten: company.app.tier_duration
• Termasuk tingkat dan durasi dalam ID: premium_monthly, ultimate_annual
• Hindari mengubah ID produk (mereka permanen)
• Dokumentasikan semua ID produk untuk tim Anda

Pengaturan Keluarga

• Aktifkan untuk aplikasi yang berorientasi keluarga (permainan, pendidikan, hiburan)
• Perhatikan dampak pada pendapatan
• Uji perilaku berbagi secara menyeluruh
• Komunikasikan kemampuan berbagi dalam pemasaran

Lokalisasi

• Terjemahkan semua nama dan deskripsi langganan
• Perhatikan perbedaan harga regional
• Uji tampilan di semua bahasa yang didukung
• Gunakan bahasa pemasaran yang sesuai dengan budaya

Gambar Promosi

• Tetapkan gaya visual yang konsisten
• Termasuk nama langganan dan manfaat utama
• Perbarui untuk promosi musiman
• Sesuaikan dengan bahasa desain aplikasi

Polanya Langganan Umum

Tingkat Satu (Freemium)

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

Tingkat Multi (Baik, Lebih Baik, Terbaik)

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

Hibrid Konsumsi + Langganan

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

Pengaturan

Langganan tidak terbuka di aplikasi:

• Pastikan ID produk sesuai dengan benar (sensitif kasus)
• Periksa apakah langganan masuk dalam kelompok langganan
• Pastikan identifikasi paket sesuai dengan App Store Connect
• Tunggu 2-3 jam setelah membuat produk

Tidak dapat mengirimkan langganan:

• Isi semua bidang yang wajib (nama, deskripsi, harga)
• Tambahkan setidaknya satu lokalisasi
• Verifikasi informasi perbankan/pajak telah disetujui
• Periksa jika langganan pertama (memerlukan versi aplikasi)

Tombol berbagi keluarga dinonaktifkan:

• Sudah diaktifkan (tidak dapat dinonaktifkan)
• Periksa dalam detail langganan
• Hubungi dukungan Apple jika terjebak

Tingkat harga tidak tersedia:

• Mungkin terbatas di beberapa wilayah
• Pilih tingkat alternatif
• Hubungi Apple untuk pertanyaan harga

"ID Produk Tidak Valid" error:

• Harus dalam format domain yang dibalik
• Tidak boleh mengandung spasi atau karakter khusus
• Cek kesalahan ketik
• Verifikasi unik di semua produk

Langkah-Langkah Selanjutnya

• Buat tawaran pengenalan Untuk menarik pelanggan baru
• Produksi komitmen bulanan rekening tagihan Untuk penawaran langganan tahunan yang didukung
• Konfigurasi pengujian sandbox Untuk menguji langganan Anda
• Siapkan penawaran promosi untuk kembali dan retensi
• Implementasikan analisis pelacakan langganan

Sumber Daya Tambahan

Untuk informasi lebih lanjut, lihat dokumentasi resmi Apple tentang langganan auto-renewable.

Teruskan dari Buat Langganan Auto-Renewable iOS

Jika Anda menggunakan Buat Langganan Auto-Renewable iOS untuk merencanakan persetujuan toko dan distribusi, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan asli di Menggunakan @capgo/native-purchases, @capgo/capacitor-in-app-review untuk detail implementasi di @capgo/capacitor-in-app-review, Menggunakan @capgo/capacitor-in-app-review untuk kemampuan asli di Menggunakan @capgo/capacitor-in-app-review, @capgo/capacitor-native-market untuk detail implementasi di @capgo/capacitor-native-market, dan Menggunakan @capgo/capacitor-native-market untuk kemampuan asli di Menggunakan @capgo/capacitor-native-market.