pengembalian dalam aplikasi untuk capacitor

Plugin ini telah dipindahkan ke repository resmi RevenueCat. Silakan lihat dokumentasi resmi untuk informasi lebih lanjut. Jika Anda lebih suka menggunakan plugin __CAPGO_KEEP_0__ native yang lebih sederhana tanpa RevenueCat,

If you prefer a simpler native API without RevenueCat, @capgo/native-purchases Mengimplementasikan pembelian dalam aplikasi dan langganan secara langsung dengan StoreKit dan Billing Google Play.

Capacitor Purchases is a plugin for the Capacitor framework that allows in-app purchases on iOS and Android. It provides a simple and consistent API across multiple platforms, making it easy for developers to implement in-app subscriptions and purchases in their mobile apps.

One of the key features of the Capacitor Purchases plugin is that it integrates with RevenueCat, a platform that provides tools for in-app subscriptions and in-app purchases. RevenueCat simplifies the process of implementing in-app subscriptions and purchases by providing a simple and consistent API across multiple platforms, and automating tasks such as receipt validation and user management.

Dengan menggunakan RevenueCat, pengembang dapat dengan mudah mengelola langganan, melacak pendapatan, dan melakukan tugas terkait lainnya. Beberapa fitur yang ditawarkan oleh RevenueCat termasuk:

• Validasi bukti pembayaran otomatis
• Pengelolaan pengguna
• Support untuk model harga kustom
• Analisis detail -Skala

Dengan menggunakan plugin Pembelian Capacitor bersama dengan RevenueCat, pengembang dapat menghemat waktu dan upaya ketika mengimplementasikan langganan dan pembelian dalam aplikasi di aplikasi mobile mereka, serta menyediakan fitur tambahan yang dapat membantu meningkatkan pengalaman pengguna dan meningkatkan pendapatan.

Penggunaan plugin Pembelian Aplikasi Capacitor dan RevenueCat, pengembang dapat dengan mudah mengelola dan melacak langganan dan pembelian aplikasi, memvalidasi bukti pembayaran, dan mengelola pengguna di berbagai platform. Ini juga memungkinkan membuat model harga kustom dan mendapatkan analisis detail untuk meningkatkan kinerja dan pendapatan.

Pemasangan

Pastikan untuk menggunakan versi terbaru dari Capacitor dan plugin Pembelian Aplikasi Capacitor. Anda dapat memeriksa versi terbaru dari Capacitor dan plugin Pembelian Aplikasi Capacitor di situs web Capacitor.

Untuk menginstal plugin Pembelian Aplikasi Capacitor, jalankan perintah berikut: npm i @capgo/capacitor-purchases Tambahkan plugin ke native code Anda npx cap sync

Tambahkan kemampuan pembelian aplikasi di Xcode:

Kemudian

1. Buatlah Akun RevenueCat

Petunjuk ini akan membantu Anda untuk memulai menggunakan langganan dan RevenueCat’s SDK dengan hanya beberapa baris kode code.

Pendaftaran untuk akun RevenueCat baru di sini.

📘

💡 Berikut tipsnya!

Penggunaan RevenueCat merekomendasikan membuat akun RevenueCat terpisah untuk setiap aplikasi / proyek yang Anda miliki, terutama jika Anda pernah berencana untuk menjual aplikasi. Ini akan mempercepat proses transfer, karena Anda dapat mentransfer akun seluruhnya daripada menunggu dukungan RevenueCat untuk mentransfer proyek individu.

Organisasi / Bisnis

Kami merekomendasikan menggunakan akun perusahaan ketika mendaftar untuk RevenueCat dan mengatur aplikasi Anda dalam proyek. Anda akan dapat mengundang tim Anda yang lain sebagai kolaborator tetapi hanya pemilik proyek yang dapat mengelola tagihan . Kolaborator proyek tidak dapat mengelola detail tagihan.

2. Konfigurasi Proyek dan Aplikasi

▶️ Buat Proyek

Navigasikan ke dashboard RevenueCat dan Tambahkan proyek baru Dari menu dropdown di bagian navigasi atas yang disebut Proyek.

Langkah 1 RevenueCat

Modal popup untuk membuat proyek baru

▶️ Tambahkan Aplikasi / Platform Dari Pengaturan Proyek > Aplikasi

Langkah 2 RevenueCat

Dashboard proyek untuk memilih platform aplikasi Nama Aplikasi Nama aplikasi wajib untuk menambahkan aplikasi Anda ke RevenueCat. Sisa konfigurasi bidang dapat ditambahkan kemudian. Untuk membuat pembelian uji coba dan produksi, ID Paket (iOS) / Nama Paket (Android) serta Rahasia Bersama (iOS) / Kredensial Layanan (Android) harus dikonfigurasi.

Halaman Konfigurasi Aplikasi untuk Aplikasi App Store Apple

📘

💡 Tips!

Setelah mendaftar aplikasi, RevenueCat merekomendasikan mengatur Pemberitahuan Server Platform. Pemberitahuan ini tidak wajib, tetapi akan mempercepat webhooks dan waktu pengiriman integrasi serta mengurangi waktu pengiriman pembaruan untuk pelanggan Anda.

📘

Aplikasi Staging vs. Aplikasi Produksi dan Pengguna

RevenueCat sendiri tidak memiliki lingkungan terpisah untuk staging dan produksi. Sebaliknya, transaksi dasar untuk pengguna dipisahkan oleh sandbox dan produksi.

Apapun aplikasi RevenueCat dapat membuat pembelian baik sandbox maupun produksi dari toko-toko. Jika Anda memiliki aplikasi terpisah untuk tahap pengembangan dan produksi, Anda dapat membuat proyek-proyek yang berbeda di RevenueCat untuk meniru konfigurasi Anda.

Selain itu, pengguna tidak dipisahkan berdasarkan lingkungan, baik. Pengguna yang sama dapat memiliki pembelian sandbox aktif dan pembelian produksi aktif pada saat yang sama.

▶️ Kredensial Layanan

Kredensial layanan harus disetel untuk memungkinkan RevenueCat berkomunikasi dengan toko aplikasi Anda. Lihat panduan RevenueCat Kunci Rahasia App Store Connect, Kredensial Layanan Play, dan Kunci Rahasia Aplikasi Amazon Appstore untuk informasi lebih lanjut.

Penting untuk diingat bahwa kredensial layanan Play dapat membutuhkan waktu hingga 36 jam untuk menyebarluaskan ke server Google.

3. Konfigurasi Produk

▶️ Pengaturan Toko

Sebelum Anda dapat memulai menggunakan RevenueCat untuk mengambil produk, Anda harus mengonfigurasi produk Anda di toko yang relevan. Lihatlah panduan berikut untuk App Store Connect, Google Play Console, Amazon Appstore, dan Stripe untuk bantuan untuk menavigasi melalui proses ini.

Jika Anda menjual produk iOS, pastikan Anda menandatangani 'Persetujuan Aplikasi Berbayar' dan isi informasi bank dan pajak Anda di App Store Connect > Persetujuan, Pajak, dan Perbankan. Ini harus diselesaikan sebelum Anda dapat menguji pembelian apa pun.

📘

Apakah Anda ingin melewatkan pengaturan toko saat menguji?

Pada iOS, Anda dapat menunda mengonfigurasi produk di App Store Connect dengan menguji menggunakan file konfigurasi StoreKit. File konfigurasi ini memerlukan pengaturan minimal dan dapat diatur melalui Xcode secara langsung.

Selengkapnya tentang pengaturan file Konfigurasi StoreKit di RevenueCat Tes Sandbox petunjuk.

▶️ Konfigurasi Produk dan Hak Akses di RevenueCat

Setelah produk in-app Anda telah dikonfigurasi di App Store Connect, Google Play Console, Amazon Appstore, atau Stripe, Anda perlu menyalin konfigurasi tersebut ke dashboard RevenueCat. RevenueCat menggunakan sistem Hak Akses untuk mengontrol akses ke fitur premium, dan Penawaran untuk mengelola set produk yang Anda tawarkan kepada pelanggan.

Hak Akses adalah tingkat akses yang dimiliki oleh pelanggan setelah membeli produk tertentu. Penawaran adalah cara sederhana untuk Anda mengorganisir produk in-app yang ingin Anda tawarkan di paywall dan mengkonfigurasi mereka secara remote. RevenueCat Merekomendasikan menggunakan fitur-fitur ini untuk memudahkan code Anda dan memungkinkan Anda untuk mengubah produk tanpa mengeluarkan pembaruan aplikasi.

Lihat Mengatur Produk untuk mengatur produk Anda dan kemudian mengorganisir mereka menjadi Penawaran atau Hak Akses.

4. Menggunakan Purchases SDK dari RevenueCat

Penggunaan SDK dari RevenueCat secara otomatis mengimplementasikan pembelian dan langganan di berbagai platform sambil sinkronisasi token dengan server RevenueCat.

Jika Anda mengalami masalah dengan SDK, lihat Pengaturan SDK untuk petunjuk.

📘

Hanya gunakan kunci publik SDK Anda untuk mengonfigurasi Pembelian

Kamu dapat mendapatkan kunci publik SDK dari halaman Kunci API di bawah tab Pengaturan Projek di dashboard.

Kamu hanya perlu mengonfigurasi instance yang dibagikan dari Purchases sekali, biasanya pada saat aplikasi diluncurkan. Setelah itu, instance yang sama dapat diakses di seluruh aplikasi dengan mengakses instance di .shared instance di SDK.

Lihat panduan RevenueCat tentang Mengonfigurasi SDK untuk informasi lebih lanjut dan praktik terbaik.

Pastikan Anda mengonfigurasi Pembelian dengan kunci publik SDK Anda hanya. Anda dapat membaca lebih lanjut tentang berbagai kunci API yang tersedia di RevenueCat Petunjuk Autentikasi.

import { CapacitorPurchases } from '@capgo/capacitor-purchases'
import { isPlatform } from '@ionic/vue' // use the right one for your framework

CapacitorPurchases.setDebugLogsEnabled({ enabled: import.meta.env.DEV }) // Enable to get debug logs in dev mode
if (isPlatform('ios')) {
    CapacitorPurchases.setup({ apiKey:'appl_******'})
} else if (isPlatform('android')) {
    CapacitorPurchases.setup({ apiKey:'goog_******'})
}

Ketika dalam pengembangan, RevenueCat merekomendasikan mengaktifkan log debug yang lebih rinci. Untuk informasi lebih lanjut tentang log-log ini, lihat petunjuk mereka Pengembangan Jika Anda merencanakan untuk menggunakan RevenueCat bersama dengan pembelian __CAPGO_KEEP_0__ yang ada Anda, lihat petunjuk mereka tentang

If you’re planning to use RevenueCat alongside your existing purchase code, refer to their guide on Mengonfigurasi Pembelian dengan ID Pengguna.

📘

Jika Anda memiliki sistem autentikasi pengguna di aplikasi Anda, Anda dapat menyediakan identifier pengguna pada saat pengonfigurasi atau pada tanggal yang lebih lanjut dengan panggilan ke

. Untuk mempelajari lebih lanjut, cek petunjuk RevenueCat tentang .logIn()__CAPGO_KEEP_0__ Menentukan Pengguna.

The SDK will automatically fetch the Tawaran dan mengambil informasi produk dari Apple, Google, atau Amazon. Jadi, produk yang tersedia sudah akan dimuat ketika pelanggan membuka layar pembelian Anda.

Contoh di bawah ini adalah cara mengambil Tawaran. Anda dapat menggunakan Tawaran untuk mengatur layar pembayaran Anda. Lihat panduan RevenueCat tentang Penggunaan Produk untuk informasi lebih lanjut dan praktik terbaik.

▶️ Mengambil dan Menampilkan Produk yang Tersedia

📘

Mengonfigurasi Pembelian dengan ID Pengguna

Jika Anda memiliki sistem autentikasi pengguna di aplikasi Anda, Anda dapat menyediakan identifier pengguna pada saat pengaturan atau pada tanggal yang lebih lanjut dengan panggilan ke .logIn(). Untuk mengetahui lebih lanjut, cek panduan RevenueCat tentang Menentukan Pengguna.

SDK akan secara otomatis mengambil tawaran yang telah dikonfigurasi Tawaran yang telah dikonfigurasi dan mengambil informasi produk dari Apple, Google, atau Amazon. Oleh karena itu, produk yang tersedia sudah akan dimuat ketika pelanggan membuka layar pembelian Anda.

Contoh di bawah ini adalah cara mengambil Tawaran. Anda dapat menggunakan Tawaran untuk mengatur layar pembayaran Anda. Lihat panduan RevenueCat tentang Penggunaan Produk untuk informasi lebih lanjut dan praktik terbaik.

const { offerings } = await CapacitorPurchases.getOfferings()
if (offerings.current !== null) {  
    // Display current offering with offerings.current
}

Jika mengambil Tawaran, produkatau paket tersedia Anda tidak ada, itu karena ada masalah konfigurasi di toko yang bersangkutan.

Alasan paling umum untuk masalah ini di App Store Connect adalah perjanjian 'Pembayaran Aplikasi Berbayar' yang tidak diperbarui atau produk tidak dalam keadaan 'Siap Untuk Dikirim' setidaknya. Di Google Play, masalah ini biasanya terjadi ketika aplikasi tidak dipublikasikan di jalur tertutup dan pengguna uji yang valid ditambahkan.

Temukan informasi lebih lanjut tentang troubleshooting masalah ini di RevenueCat Bantuan.

▶️ Lakukan Pembelian

Metode SDK termasuk metode sederhana untuk memfasilitasi pembelian. Metode ini purchase:package mengambil paket dari Offering yang diperoleh dan memproses transaksi dengan toko aplikasi yang relevan.

Contoh code di bawah menunjukkan proses pembelian paket dan memastikan bahwa konten 'your_entitlement_id' terbuka. Detail lebih lanjut tentang metode ini dapat ditemukan di panduan RevenueCat tentang purchase:package Membuat Pembelian ▶️ Periksa Status Langganan.

const purchase = async (p: Package): Promise<PurchaserInfo | null> => {
  try {
    // console.log('purchase', p)
    const data = await CapacitorPurchases.purchasePackage({
      identifier: p.identifier,
      offeringIdentifier: p.offeringIdentifier,
    })
    const purchaserInfo = data.purchaserInfo
    // console.log('listenBuy', purchaserInfo)
    if (purchaserInfo.activeSubscriptions.includes(p.identifier)) {
      // set the user as paid
    }
    return purchaserInfo
  }
  catch (e) {
    console.error('listenBuy error', e)
  }
  return null
}

Metode ini dapat digunakan kapan saja Anda memerlukan status terbaru, dan aman untuk memanggil metode ini secara berulang selama siklus hidup aplikasi Anda.

Pembelian Pembelian meng-cache otomatis versi terbaru CustomerInfo ketika itu diperbarui — jadi dalam kebanyakan kasus, metode ini mengambil dari cache dan berjalan sangat cepat.

Metode ini biasanya dipanggil ketika memutuskan UI mana yang harus ditampilkan kepada pengguna, dan ketika pengguna melakukan aksi yang memerlukan tingkat hak akses tertentu.

📘

💡 Tips!

Pengguna dapat mengakses informasi lebih banyak tentang langganan daripada hanya apakah aktif atau tidak. Lihat panduan RevenueCat tentang Status Langganan untuk mengetahui apakah langganan akan diperbarui, apakah ada masalah dengan kartu kredit pengguna, dan lain-lain.

RevenueCat memungkinkan pengguna untuk mengembalikan pembelian dalam aplikasi, mengaktifkan kembali konten yang sebelumnya dibeli dari akun toko yang sama (akun Apple, Google, atau Amazon). Kami merekomendasikan bahwa semua aplikasi memiliki cara untuk memicu metode restore. Perlu diingat bahwa Apple memerlukan mekanisme restore dalam kasus pengguna kehilangan akses ke pembelian mereka (misalnya: menghapus/reinstall aplikasi, kehilangan informasi akun, dll).

  const res = await CapacitorPurchases.restoreTransactions()
  const purchaserInfo = res.purchaserInfo
  const ids: string[] = [] // extract active subscriptions ids
  purchaserInfo.activeSubscriptions.forEach((id) => {
    ids.push(id)
  })

Jika ada dua ID Pengguna Aplikasi yang berbeda mengembalikan transaksi dari akun penyimpanan yang sama (akun Apple, Google, atau Amazon). RevenueCat mungkin mencoba membuat alias antara dua ID Pengguna Aplikasi dan menghitung mereka sebagai pengguna yang sama ke depannya. Lihat panduan RevenueCat pada Memulihkan Pembelian untuk informasi lebih lanjut tentang perilaku pemulihan yang dapat disesuaikan.

Since the SDK works seamlessly on any platform, changes to a user’s purchase info may come from a variety of sources. You can respond to any changes in a customer’s CustomerInfo Capgo purchases:receivedUpdated:.

This method will fire whenever the SDK receives an updated CustomerInfo mengikuti metode delegasi opsional. getCustomerInfo(), purchase(package:), purchase(product:)Metode ini akan memicu setiap kali restorePurchases().

Capgo menerima objek yang diperbarui dari panggilan ke

Depending on your app, it may be sufficient to ignore the delegate and simply handle changes to customer information the next time your app is launched or in the completion blocks of the SDK methods.

CapacitorPurchases.addListener('purchasesUpdate', (data) => {
  console.log('purchasesUpdate', data)
})

👍

Selamat kamu telah melakukannya!

Kamu telah mengimplementasikan sistem pembelian langganan yang lengkap tanpa harus menghabiskan sebulan untuk menulis server code. Selamat!

Contoh Aplikasi

Untuk mengunduh contoh aplikasi yang lebih lengkap mengenai integrasi dengan SDK, silakan kunjungi sumber daya contoh aplikasi RevenueCat.

Tampilkan Contoh

Saya akan segera mempublikasikan contoh aplikasi menggunakan Capacitor dan Vue.js.

Jika kamu memerlukan informasi lebih lanjut tentang penggunaan yang lebih dalam dari Capacitor SDK, silakan cek dokumentasi. di sini.

Langkah Selanjutnya

\

• Jika kamu belum melakukannya, pastikan produkmu telah dikonfigurasi dengan benar dengan mengunjungi guide RevenueCat mengenai hak akses. Jika kamu ingin menggunakan identifikasi pengguna sendiri, baca tentang.
• __CAPGO_KEEP_0__ Pengaturan ID Pengguna Aplikasi .
• Jika Anda sedang beralih dari sistem lain ke RevenueCat, lihat panduan RevenueCat tentang Migrasi Langganan yang Sudah Ada.
• Saat Anda siap untuk menguji integrasi Anda, Anda dapat mengikuti panduan RevenueCat tentang Tes dan Debug.
• Jika Anda memenuhi syarat untuk Program Bisnis Kecil Toko Aplikasi, lihat panduan RevenueCat tentang Cara Mengajukan dan Menginformasikan RevenueCat

Jika Anda membutuhkan Update Langsung di Aplikasi Anda

Join di sini 👇

Pendaftaran di sini untuk mendapatkan akun Anda

Capgo

Teruskan dari Pembelian Aplikasi untuk capacitor

Jika Anda menggunakan pembelian dalam aplikasi untuk capacitor untuk merencanakan pembayaran dan pembelian, hubungkannya dengan Capgo Pricing untuk alur kerja produk di Capgo Pricing, Sistem Pembayaran untuk detail implementasi di Sistem Pembayaran, @capgo/native-purchases untuk detail implementasi di @capgo/native-purchases, Panduan Pemula untuk detail implementasi di Panduan Pemula, dan Buku Panduan Penghasilan untuk detail implementasi di Buku Panduan Pendapatan.