Membuat langganan iOS yang diperpanjang otomatis
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Langganan auto-renewable memberikan akses berulang ke konten, layanan, atau fitur premium di aplikasi iOS Anda. Panduan ini memandu Anda membuat langganan di App Store Connect.
Ikhtisar
Bagian berjudul “Ringkasan”Langganan auto-renewable diperbarui secara otomatis di akhir setiap periode tagihan hingga pengguna membatalkannya. Cocok untuk:
- Konten dan fitur premium
- Pengalaman bebas iklan
- Penyimpanan cloud dan sinkronisasi
- Layanan streaming
- Alat dan utilitas profesional
Prerequisites
Bagian berjudul “Prasyarat”Sebelum membuat langganan, Anda harus:
- Buat grup langganan untuk mengatur langganan Anda
- Punya keanggotaan Apple Developer Program yang aktif
- Lengkapi informasi perbankan dan pajak di App Store Connect
Membuat Langganan
Bagian berjudul “Membuat Langganan”-
Buka Subscriptions
Di App Store Connect, pilih aplikasi Anda dan buka Monetisasi > Langganan.
Pilih grup langganan Anda atau buat yang baru jika diperlukan.

-
Buat langganan baru
Klik + ikon di samping grup langganan Anda untuk menambahkan langganan baru.
-
Isi Informasi Dasar
Nama Referensi: Nama deskriptif untuk penggunaan internal (tidak ditampilkan ke pelanggan)
- Contoh: “Premium Monthly”, “Ultimate Annual”, “Basic Plan”
ID Produk: ID unik untuk langganan ini (tidak dapat diubah setelahnya)
- Format:
com.yourcompany.yourapp.premium_monthly - Gunakan nama deskriptif huruf kecil dengan underscore
- Wajib untuk mengonfigurasi plugin native-purchases

-
Konfigurasi Durasi
Pilih durasi langganan dari opsi yang tersedia:
- 1 minggu
- 1 bulan
- 2 bulan
- 3 bulan
- 6 bulan
- 1 tahun
Durasi menentukan seberapa sering pengguna ditagih.
-
Atur Harga
Klik Tambah Harga Langganan untuk mengatur harga:
Wilayah Dasar: Pilih pasar utama Anda (biasanya negara Anda)
Harga: Atur harga langganan
- Apple secara otomatis mengonversi ke mata uang lain
- Pilih dari tier harga Apple
- Pertimbangkan nilai persepsi dan tarif pasar

-
Family Sharing (Opsional)
Putuskan apakah akan mengaktifkan Family Sharing, yang memungkinkan hingga 6 anggota keluarga mengakses langganan.
Aktifkan jika:
- Konten cocok untuk penggunaan keluarga
- Anda ingin meningkatkan nilai proposisi
- Model bisnis Anda mendukungnya
Jangan aktifkan jika:
- Langganan hanya untuk penggunaan individu
- Konten dipersonalisasi untuk pengguna
- Anda ingin memaksimalkan pendapatan per pengguna
-
Tambahkan Lokalisasi
Tambahkan informasi tampilan langganan dalam semua bahasa yang didukung aplikasi Anda:
Nama Tampilan Langganan: Nama yang dilihat pelanggan (mis. “Premium Bulanan”)
Deskripsi: Deskripsi singkat tentang apa yang termasuk dalam langganan
- Buat ringkas dan fokus pada manfaat
- Sebutkan fitur utama
- Tonjolkan nilai jual

-
Gambar Promosi App Store (Opsional)
Upload gambar promosi untuk langganan ini (312x390 piksel):
- Tampil di halaman langganan App Store
- Harus sesuai dengan desain aplikasi Anda
- Sertakan nama langganan untuk kejelasan
-
Simpan dan Ajukan
Klik Simpan untuk membuat langganan.
Untuk Langganan Pertama:
- Harus diajukan bersama versi aplikasi baru
- Sertakan dalam pengajuan App Store berikutnya
- Tidak dapat dikirim secara independen
Untuk Langganan Berikutnya:
- Dapat dikirim langsung dari halaman Langganan
- Tidak memerlukan versi aplikasi baru
- Tersedia setelah langganan pertama disetujui
Status Langganan
Bagian berjudul “Status Langganan”Langganan Anda akan memiliki salah satu status berikut:
| Status | Deskripsi | Bisa Diuji? |
|---|---|---|
| Metadata Hilang | Setup belum lengkap | Ya (sandbox) |
| Siap untuk dikirim | Lengkap tapi belum dikirim | Ya (sandbox) |
| Menunggu Review | Terkirim ke Apple | Ya (sandbox) |
| Sedang Direview | Sedang ditinjau oleh Apple | Ya (sandbox) |
| Disetujui | Tersedia untuk dibeli | Ya |
| Ditolak | Perlu perubahan | Ya (sandbox) |
Penggunaan di Aplikasi
Bagian berjudul “Menggunakan di Aplikasi Anda”Setelah dibuat, referensikan langganan tersebut di aplikasi Anda menggunakan product ID:
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch subscription products direct from StoreKitconst { 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?.unitString ?? 'unknown'}`); 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 dataconst { 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();}Paket Bulanan dengan Komitmen 12 Bulan
Bagian berjudul “Rencana Bulanan dengan Komitmen 12 Bulan”Jika langganan App Store Connect Anda dikonfigurasi dengan rencana penagihan bulanan dan komitmen 12 bulan, StoreKit dapat mengembalikan syarat harga tambahan untuk produk tersebut. Gunakan syarat-syarat itu untuk menampilkan biaya bulanan, harga total komitmen, 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 paywall dan entitlement lengkap, lihat Rencana penagihan komitmen bulanan iOS.
Praktik Terbaik
Bagian berjudul “Praktik Terbaik”Strategi Harga
Bagian berjudul “Strategi Harga”- Rencana bulanan: Hambatan masuk lebih rendah, membangun kebiasaan
- Paket tahunan: Nilai lebih baik, LTV lebih tinggi, churn lebih rendah
- Beberapa tier: Basic, Premium, Ultimate untuk segmen pengguna berbeda
- Analisis kompetitif: Riset harga aplikasi serupa
ID Produk
Bagian berjudul “Product IDs”- Gunakan penamaan yang konsisten:
company.app.tier_duration - Sertakan tier dan durasi di ID:
premium_monthly,ultimate_annual - Hindari mengubah product ID (bersifat permanen)
- Dokumentasikan semua product ID untuk tim Anda
Berbagi Keluarga
Bagian berjudul “Family Sharing”- Aktifkan untuk aplikasi keluarga (game, edukasi, hiburan)
- Pertimbangkan dampaknya terhadap pendapatan
- Uji perilaku sharing secara menyeluruh
- Sampaikan kemampuan sharing dalam materi marketing
Lokalisasi
Bagian berjudul “Localization”- Terjemahkan semua nama dan deskripsi langganan
- Pertimbangkan perbedaan harga regional
- Uji tampilan di semua bahasa yang didukung
- Gunakan bahasa marketing yang sesuai dengan budaya lokal
Gambar Promosi
Bagian berjudul “Gambar Promosi”- Jaga konsistensi gaya visual
- Sertakan nama langganan dan manfaat utama
- Perbarui untuk promosi musiman
- Sesuaikan dengan bahasa desain aplikasi
Common Subscription Patterns
Bagian berjudul “Pola Langganan Umum”Tier Tunggal (Freemium)
Bagian berjudul “Tier Tunggal (Freemium)”Free App + Premium Subscription- Basic: Free (limited features)- Premium Monthly: $4.99- Premium Annual: $39.99 (save 33%)Multi-Tier (Baik, Lebih Baik, Terbaik)
Bagian berjudul “Multi-Tier (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.99Hibrida Consumable + Subscription
Bagian berjudul “Hybrid Consumable + Subscription”- Credit packs (consumable)- Monthly subscription (unlimited credits)- Annual subscription (unlimited + bonus features)Pemecahan Masalah
Bagian berjudul “Troubleshooting”Langganan tidak dimuat di aplikasi:
- Pastikan product ID cocok persis (case-sensitive)
- Periksa apakah langganan berada dalam grup langganan
- Pastikan bundle identifier cocok dengan App Store Connect
- Tunggu 2-3 jam setelah membuat produk
Tidak dapat mengirim langganan:
- Lengkapi semua kolom wajib (nama, deskripsi, harga)
- Tambahkan minimal satu lokalisasi
- Pastikan info perbankan/pajak disetujui
- Periksa langganan pertama (memerlukan versi aplikasi)
Toggle Family Sharing dinonaktifkan:
- Sudah diaktifkan (tidak bisa dinonaktifkan)
- Periksa di detail langganan
- Hubungi Apple Support jika macet
Tier harga tidak tersedia:
- Mungkin dibatasi di beberapa wilayah
- Pilih tier alternatif
- Hubungi Apple untuk pertanyaan harga
Error “Invalid Product ID”:
- Harus berformat reverse domain
- Tidak boleh ada spasi atau karakter spesial
- Periksa typo
- Pastikan ID unik di semua produk
Langkah Berikutnya
Bagian berjudul “Langkah Selanjutnya”- Buat penawaran perkenalan untuk menarik pelanggan baru
- Promosikan paket penagihan komitmen bulanan untuk penawaran langganan tahunan yang didukung
- Konfigurasi pengujian sandbox untuk menguji langganan Anda
- Siapkan penawaran promosi untuk win-back dan retensi
- Implementasikan pelacakan analitik langganan
Sumber daya tambahan
Bagian berjudul “Sumber daya tambahan”Untuk detail lebih lanjut, lihat dokumentasi resmi Apple tentang langganan yang diperpanjang otomatis.
Lanjutkan dari membuat langganan iOS yang diperpanjang otomatis
Bagian berjudul “Lanjutkan dari membuat langganan iOS yang diperpanjang otomatis”Jika Anda menggunakan Membuat langganan iOS yang diperpanjang otomatis untuk merencanakan persetujuan store dan distribusi, hubungkan dengan Menggunakan @capgo/native-purchases untuk kemampuan native saat 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 kapabilitas native di bagian 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 native di Menggunakan @capgo/capacitor-native-market.