Membuat Langganan Otomatis Menggunakan iOS

Langganan otomatis ulang memberikan akses berulang ke konten, layanan, atau fitur premium di aplikasi iOS Anda. Panduan ini akan mengantarkan Anda melalui pembuatan langganan di App Store Connect.

Pendahuluan

Langganan otomatis ulang secara otomatis diperbarui pada akhir setiap periode pembayaran hingga pengguna membatalkan. Mereka sangat cocok untuk:

• Konten dan fitur premium
• Pengalaman tanpa iklan
• Penyimpanan awan dan sinkronisasi
• Layanan streaming
• Alat dan utilitas profesional

Prasyarat

Sebelum membuat langganan, Anda harus:

1. Membuat kelompok langganan untuk mengorganisir langganan Anda
2. Mempunyai keanggotaan Program Pengembang Apple yang aktif
3. Mengisi informasi keuangan dan pajak di App Store Connect

Membuat Langganan

1. Navigasikan ke Langganan

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

   Pilih kelompok langganan Anda atau buat yang baru jika diperlukan.

   

2. Buat Langganan Baru

   Klik ikon + di samping grup langganan Anda untuk menambahkan langganan baru.

3. Masukkan Informasi Dasar

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

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

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

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

   

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. Atur Harga

   Klik Tambah Harga Langganan Untuk mengkonfigurasi harga:

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

   Harga: Tentukan harga langganan

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

   

6. Pengaturan Berbagi Keluarga (Opsional)

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

   Peringatan

   Setelah Fitur Keluarga diaktifkan, tidak dapat dimatikan untuk produk ini.

   Aktifkan jika:

   • Konten sesuai untuk penggunaan keluarga
   • Kamu ingin meningkatkan nilai properti
   • Model bisnis kamu mendukungnya

   Tidak aktifkan jika:

   • Langganan hanya untuk penggunaan individu
   • Konten disesuaikan dengan pengguna
   • Kamu ingin meningkatkan pendapatan per pengguna

7. Tambahkan Lokalisasi

   Tambahkan informasi tampilan langganan di semua bahasa yang digunakan oleh aplikasi Anda:

   Nama Langganan Tampilan: Nama yang ditampilkan kepada pelanggan (misalnya, "Premium Bulanan")

   Deskripsi: Deskripsi singkat tentang apa yang termasuk dalam langganan

   • Jaga agar 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):

   • Menampilkan halaman langganan di 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 Kirimkan

   Klik Simpan Untuk Langganan Pertama:

   Wajib disertakan dengan versi aplikasi baru

   • Simpan dan Kirimkan untuk membuat langganan.
   • Termasuk dalam pengajuan App Store berikutnya
   • Tidak dapat disampaikan secara independen

   Untuk Langganan Selanjutnya:

   • Dapat disampaikan langsung dari halaman Langganan
   • Tidak memerlukan versi aplikasi baru
   • Terоступ setelah langganan pertama disetujui

Status Langganan

Langganan Anda akan memiliki salah satu status ini:

Status	context	Navigation label for system status page. Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: site footer. Message key `status` (Status).
Metadata yang Hilang	Konfigurasi yang Tidak Lengkap	Ya (Sandbox)
Sudah Siap Kirim	Sudah Selesai Tapi Belum Dikirim	Ya (Sandbox)
Mengharapkan Ulasan	Sudah Dikirim ke Apple	Ya (Sandbox)
Sedang Dalam Proses Ulasan	Sedang Dibaca oleh Apple	Ya (Sandbox)
Diterima	Tersedia untuk pembelian	Ya
Ditolak	Perlu perubahan	Ya (sandbox)

Tip

Anda dapat menguji langganan di mode sandbox bahkan jika mereka menampilkan “Metadata Hilang” atau “Siap untuk 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();
}

Rencana Bulanan dengan Komitmen 12 Bulan

Jika langganan App Store Connect Anda telah dikonfigurasi 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 paywall dan hak akses penuh, lihat Rencana Pembayaran Bulanan dengan Komitmen iOS.

Praktik Terbaik

Rencana Bulanan

• Section titled “Best Practices”Lower batasan masuk, membentuk kebiasaan
• TahunanNilai yang lebih baik, nilai LTV yang lebih tinggi, pengeluaran yang lebih rendah
• Berbagai tingkatBasic, Premium, Ultimate untuk berbagai segment pengguna
• Analisis kompetitifPenelitian harga aplikasi serupa

ID Produk

• Pakai penamaan yang konsisten: company.app.tier_duration
• Masukkan 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)
• Pertimbangkan dampak pada pendapatan
• Uji perilaku berbagi secara menyeluruh
• Komunikasikan kemampuan berbagi dalam pemasaran

Pengaturan Lokalisasi

• Terjemahkan semua nama dan deskripsi langganan
• Pertimbangkan 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 keuntungan utama
• Perbarui untuk promosi musiman
• Sesuaikan dengan bahasa desain aplikasi secara keseluruhan

Polanya Langganan Umum

Tingkat Satu (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)

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

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

Hybrid 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 yang benar (sensitif kasus)
• Periksa apakah langganan masuk dalam kelompok langganan
• Pastikan ID aplikasi sesuai dengan App Store Connect
• Tunggu 2-3 jam setelah membuat produk

Tidak bisa mengirimkan langganan:

• Lengkapi semua bidang yang diperlukan (nama, deskripsi, harga)
• Tambahkan setidaknya satu lokal
• Pastikan informasi perbankan/pajak disetujui
• Cek apakah langganan pertama (memerlukan versi aplikasi)

Tombol berbagi keluarga di nonaktifkan:

• Sudah diaktifkan (tidak bisa dinonaktifkan)
• Cek di detail langganan
• Hubungi Dukungan Apple jika terjebak

Level harga tidak tersedia:

• Mungkin terbatas di beberapa wilayah
• Alternatif tingkat pilih
• 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
• Pastikan unik di semua produk

Langkah-Langkah Selanjutnya

• Buat tawaran pengenalan untuk menarik pelanggan baru
• Rencana pembayaran komitmen bulanan barang dagangan untuk tawaran langganan tahunan yang didukung
• Konfigurasi pengujian sandbox untuk menguji langganan Anda
• Tetapkan penawaran promosi untuk kembali dan penahanan
• Implementasikan pengukuran analitis langganan

Sumber Daya Tambahan

Untuk informasi lebih lanjut, lihat dokumentasi Apple resmi tentang langganan yang dapat diperbarui secara otomatis Lanjutkan dari Membuat Langganan iOS yang Dapat Diperbarui Secara Otomatis.

Bagian berjudul “Lanjutkan dari Membuat Langganan iOS yang Dapat Diperbarui Secara Otomatis”

__CAPGO_KEEP_0__ Membuat Langganan iOS Otomatis Diri Diri untuk merencanakan persetujuan toko dan distribusi, hubungkannya dengan Menggunakan @capgo/native-purchases untuk kemampuan asli di Menggunakan @capgo/native-purchases, @capgo/capacitor-ulasan-dalam-aplikasi untuk detail implementasi di @capgo/capacitor-ulasan-dalam-aplikasi, Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi untuk kemampuan asli di Menggunakan @capgo/capacitor-ulasan-dalam-aplikasi, @capgo/capacitor-pasar-asli untuk detail implementasi di @capgo/capacitor-pasar-asli, dan Menggunakan @capgo/capacitor-pasar-asli untuk kemampuan asli di Menggunakan @capgo/capacitor-pasar-asli.