Langsung ke konten

Buat Grup Langganan iOS

GitHub

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.

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.

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

Dalam satu grup, setiap langganan harus diurutkan dari nilai tertinggi (level 1) hingga terendah. Urutan ini menentukan bagaimana perubahan langganan diklasifikasikan:

Hierarki grup langganan

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)

Apple secara otomatis menangani tiga jenis perubahan langganan berdasarkan peringkat level:

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 time

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 switches

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)
  1. Buka Subscriptions

    Di App Store Connect, pilih aplikasi Anda dan buka Monetisasi > Langganan.

  2. Buat Grup

    Klik + di sebelah “Subscription Groups” untuk membuat grup baru.

  3. Beri Nama Grup

    Pilih nama deskriptif yang mencerminkan langganan di dalamnya:

    • “Akses Premium”
    • “Cloud Storage Plans”
    • “Fitur Pro”
  4. Tambahkan Langganan

    Setelah membuat grup, tambahkan langganan satu per satu ke dalamnya. Setiap langganan akan memiliki peringkat level.

  5. 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

Plugin native-purchases secara otomatis menangani logika subscription group:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Fetch all subscriptions in a group
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['premium_monthly', 'premium_annual', 'ultimate_monthly'],
productType: PURCHASE_TYPE.SUBS,
});
// Display current subscription using StoreKit transactions
const { 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);
});
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Get current subscription info
const { 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/downgrades
NativePurchases.addListener('transactionUpdated', (transaction) => {
console.log('Subscription changed!', transaction);
if (transaction.subscriptionState === 'revoked') {
revokeAccess();
} else if (transaction.isActive) {
unlockPremiumFeatures();
}
});

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].”

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.

  • 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
  • Paket tahunan → Level lebih tinggi daripada bulanan (untuk tier yang sama)
  • Tier harga lebih tinggi → Level lebih tinggi
  • Pertimbangkan nilai, bukan hanya harga
  • 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
  • Uji semua skenario upgrade
  • Uji semua skenario downgrade
  • Verifikasi perilaku crossgrade
  • Cek webhook terpicu
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)
Level 1: Premium Annual ($99.99/year)
Level 2: Premium Monthly ($9.99/month)
  • Bulanan → Tahunan: Crossgrade (saat perpanjangan)
  • Tahunan → Bulanan: Downgrade (saat perpanjangan)
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.

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

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.