Buat Grup Langganan iOS
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Grup langganan sangat penting untuk mengatur dan mengelola beberapa level langganan di aplikasi iOS Anda. Memahami cara kerjanya sangat krusial untuk mengimplementasikan fungsi upgrade, downgrade, dan crossgrade.
Apa itu Grup Langganan?
Bagian berjudul “Apa itu Grup Langganan?”Grup langganan adalah kumpulan langganan terkait yang dapat dipilih oleh pengguna. Pengguna hanya dapat berlangganan satu langganan dalam satu grup pada satu waktu. Saat mereka beralih langganan, Apple menangani transisi secara otomatis.
Mengapa Grup Langganan Penting
Bagian berjudul “Mengapa Grup Langganan Penting”Grup langganan memungkinkan:
- Penetapan harga bertingkat: Tawarkan paket basic, premium, dan ultimate
- Durasi yang berbeda: Opsi bulanan, tahunan, dan seumur hidup
- Logika upgrade/downgrade: Penanganan otomatis perubahan langganan
- Manajemen yang disederhanakan: Kelompokkan langganan terkait
Level Langganan
Bagian berjudul “Tingkat Langganan”Dalam satu grup, setiap langganan harus diurutkan dari nilai tertinggi (level 1) hingga terendah. Urutan ini menentukan bagaimana perubahan langganan diklasifikasikan:

Contoh Level
Bagian berjudul “Contoh Level”Level 1 (Nilai Tertinggi)
- Premium Tahunan ($99,99/tahun)
- Ultimate Bulanan ($19,99/bulan)
Level 2 (Nilai Sedang)
- Standard Tahunan ($49,99/tahun)
- Premium Bulanan ($9,99/bulan)
Level 3 (Nilai Terendah)
- Basic Tahunan ($29,99/tahun)
- Standard Bulanan ($4,99/bulan)
Tipe Perubahan Langganan
Bagian berjudul “Jenis Perubahan Langganan”Apple secara otomatis menangani tiga jenis perubahan langganan berdasarkan peringkat level:
1. Upgrade
Bagian berjudul “1. Upgrade”Beralih ke higher-tier langganan (misalnya, level 2 → level 1).
Perilaku:
- Takes effect langsung
- Pengguna menerima pengembalian dana prorata untuk sisa waktu
- Langganan baru dimulai segera
Contoh:
// User currently has: Standard Monthly (Level 2)// User upgrades to: Premium Annual (Level 1)// Result: Immediate access to Premium, refund for unused Standard time2. Downgrade
Bagian berjudul “2. Downgrade”Beralih ke tier lebih rendah (misalnya, level 1 → level 2).
Perilaku:
- Berlaku pada tanggal perpanjangan berikutnya
- Pengguna tetap menggunakan langganan saat ini hingga periode berakhir
- Langganan baru dimulai otomatis setelah masa berlaku habis
Contoh:
// User currently has: Premium Annual (Level 1)// User downgrades to: Standard Monthly (Level 2)// Result: Premium access continues until annual renewal date, then switches3. Crossgrade
Bagian berjudul “3. Crossgrade”Beralih ke langganan lain di level tier yang sama.
Perilaku bergantung pada durasi:
Durasi Berbeda → Berperilaku seperti downgrade
- Berlaku pada tanggal perpanjangan berikutnya
- Contoh: Premium Bulanan (Level 1) → Premium Tahunan (Level 1)
Durasi Sama → Berfungsi seperti upgrade
- Takes effect immediately
- Contoh: Premium Bulanan (Level 1) → Ultimate Bulanan (Level 1)
Membuat Grup Langganan
Bagian berjudul “Membuat Grup Langganan”-
Buka Subscriptions
Di App Store Connect, pilih aplikasi Anda dan buka Monetisasi > Langganan.
-
Buat Grup
Klik + di sebelah “Subscription Groups” untuk membuat grup baru.
-
Beri Nama Grup
Pilih nama deskriptif yang mencerminkan langganan di dalamnya:
- “Akses Premium”
- “Cloud Storage Plans”
- “Fitur Pro”
-
Tambahkan Langganan
Setelah membuat grup, tambahkan langganan satu per satu ke dalamnya. Setiap langganan akan memiliki peringkat level.
-
Atur Peringkat Level
Susun langganan dari nilai tertinggi (1) ke nilai terendah. Pertimbangkan:
- Annual plans typically rank higher than monthly
- Tier dengan harga lebih tinggi berada di atas tier yang lebih murah
- Tier ultimate/premium menempati peringkat tertinggi
Penggunaan di Aplikasi
Bagian berjudul “Menggunakan di Aplikasi Anda”Plugin native-purchases secara otomatis menangani logika subscription group:
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch all subscriptions in a groupconst { products } = await NativePurchases.getProducts({ productIdentifiers: ['premium_monthly', 'premium_annual', 'ultimate_monthly'], productType: PURCHASE_TYPE.SUBS,});
// Display current subscription using StoreKit transactionsconst { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS,});
const activeSubs = purchases.filter((purchase) => purchase.isActive);
// Detect pending downgrade/cancellation (StoreKit sets willCancel === true)const pendingChange = purchases.find((purchase) => purchase.willCancel === true);if (pendingChange) { console.log('Subscription will stop auto-renewing on', pendingChange.expirationDate);}
// Purchase (StoreKit handles upgrades/downgrades automatically)await NativePurchases.purchaseProduct({ productIdentifier: 'premium_annual', productType: PURCHASE_TYPE.SUBS,});
// Listen for StoreKit updates (fires on upgrades/downgrades/refunds)NativePurchases.addListener('transactionUpdated', (transaction) => { console.log('Subscription updated:', transaction);});Menangani Perubahan Langganan
Bagian berjudul “Menangani Perubahan Subscription”Deteksi Tipe Perubahan
Bagian berjudul “Mendeteksi Jenis Perubahan”import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Get current subscription infoconst { purchases } = await NativePurchases.getPurchases({ productType: PURCHASE_TYPE.SUBS,});
const currentSubscription = purchases.find( (purchase) => purchase.subscriptionState === 'subscribed',);
if (currentSubscription) { // StoreKit reports if user cancelled auto-renew if (currentSubscription.willCancel) { console.log( `User cancelled. Access remains until ${currentSubscription.expirationDate}`, ); }
if (currentSubscription.isUpgraded) { console.log('User recently upgraded to this plan.'); }}
// Listen for automatic upgrades/downgradesNativePurchases.addListener('transactionUpdated', (transaction) => { console.log('Subscription changed!', transaction); if (transaction.subscriptionState === 'revoked') { revokeAccess(); } else if (transaction.isActive) { unlockPremiumFeatures(); }});Komunikasi pengguna
Bagian berjudul “Komunikasi dengan Pengguna”Selalu komunikasikan perilaku perubahan dengan jelas:
Untuk Upgrade:
“Anda akan langsung mendapatkan akses ke fitur Premium. Kami akan mempro-rata langganan Anda saat ini.”
Untuk Downgrade:
“Anda akan tetap memiliki akses Premium hingga [tanggal perpanjangan], lalu beralih ke Standard.”
Untuk Crossgrade:
“Paket Anda akan berubah ke penagihan Tahunan pada perpanjangan berikutnya di [tanggal].”
Monitoring Server
Bagian berjudul “Server monitoring”Gunakan Apple’s App Store Server Notifications v2 atau backend validasi receipt Anda sendiri untuk mencerminkan perubahan StoreKit di database Anda. Pasangkan notifikasi server dengan transactionUpdated listener agar klien dan backend tetap sinkron.
Praktik Terbaik
Bagian berjudul “Praktik Terbaik”Organisasi Grup
Bagian berjudul “Organisasi Grup”- Jaga agar langganan terkait berada di grup yang sama
- Jangan campur fitur yang tidak terkait (misalnya, penyimpanan dan penghapusan iklan)
- Buat grup terpisah untuk set fitur yang berbeda
Strategi Ranking Level
Bagian berjudul “Strategi Peringkat Level”- Paket tahunan → Level lebih tinggi daripada bulanan (untuk tier yang sama)
- Tier harga lebih tinggi → Level lebih tinggi
- Pertimbangkan nilai, bukan hanya harga
Pengalaman Pengguna
Bagian berjudul “User Experience”- Tampilkan langganan saat ini dengan jelas
- Tampilkan semua opsi yang tersedia di grup
- Tandai perubahan mana yang langsung berlaku vs. saat perpanjangan
- Izinkan pindah antar paket dengan mudah
Pengujian
Bagian berjudul “Testing”- Uji semua skenario upgrade
- Uji semua skenario downgrade
- Verifikasi perilaku crossgrade
- Cek webhook terpicu
Skenario Umum
Bagian berjudul “Skenario Umum”Skenario 1: Paket Bulanan Tiga Tingkat
Bagian berjudul “Skenario 1: Paket Bulanan Tiga Tingkat”Level 1: Ultimate Monthly ($19.99)Level 2: Premium Monthly ($9.99)Level 3: Basic Monthly ($4.99)- Basic → Premium: Upgrade (langsung)
- Premium → Ultimate: Upgrade (langsung)
- Ultimate → Premium: Downgrade (saat perpanjangan)
- Basic → Ultimate: Upgrade (langsung)
Skenario 2: Paket Durasi Campuran
Bagian berjudul “Skenario 2: Paket Durasi Campuran”Level 1: Premium Annual ($99.99/year)Level 2: Premium Monthly ($9.99/month)- Bulanan → Tahunan: Crossgrade (saat perpanjangan)
- Tahunan → Bulanan: Downgrade (saat perpanjangan)
Skenario 3: Multi-Tingkat Multi-Durasi
Bagian berjudul “Skenario 3: Multi-Tier Multi-Duration”Level 1: Ultimate Annual ($199/year)Level 2: Ultimate Monthly ($19.99/month)Level 3: Premium Annual ($99/year)Level 4: Premium Monthly ($9.99/month)Level 5: Basic Annual ($49/year)Level 6: Basic Monthly ($4.99/month)Konfigurasi ini memberikan fleksibilitas maksimal sambil mempertahankan logika upgrade/downgrade yang jelas.
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Langganan tidak muncul di grup:
- Pastikan sudah ditugaskan ke grup yang benar
- Periksa apakah statusnya minimal “Ready to Submit”
- Pastikan product ID sudah benar
Perilaku upgrade/downgrade yang salah:
- Tinjau peringkat level (1 = tertinggi)
- Pastikan tier langganan sudah sesuai
- Cek apakah level sudah diatur dengan benar
Produk dari grup yang berbeda:
- User bisa berlangganan ke beberapa grup sekaligus
- Ini disengaja - simpan produk terkait di grup yang sama
getActiveProducts menampilkan beberapa langganan:
- Cek apakah langganan berada di grup berbeda
- Pastikan user tidak berlangganan via Family Sharing
- Tinjau status langganan di App Store Connect
Sumber daya tambahan
Bagian berjudul “Sumber daya tambahan”Untuk detail lebih lanjut, lihat dokumentasi resmi Apple tentang grup langganan.
Lanjutkan dari Membuat Grup Langganan iOS
Bagian berjudul “Lanjutkan dari Buat Grup Langganan iOS”Jika Anda menggunakan Buat Grup Langganan iOS 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.