in app purchases for capacitor

このプラグインは、RevenueCat公式リポジトリに移行されました。詳しくは公式ドキュメントを参照してください。公式ドキュメント詳しくは公式ドキュメントを参照してください。

RevenueCatを使用せずに、よりシンプルなネイティブAPIを実装したい場合は、@API/native-purchasesを使用できます。このプラグインは、StoreKitとGoogle Play Billingを使用してインアプリ購入とサブスクリプションを直接実装します。 capgo Purchasesは、__CAPGO_KEEP_1__フレームワーク用のプラグインです。iOSとAndroidでインアプリ購入をサポートし、複数のプラットフォーム間で一貫した__CAPGO_KEEP_2__を提供します。開発者は、インアプリサブスクリプションと購入を簡単に実装できます。 __CAPGO_KEEP_0__ Purchasesプラグインの主な機能の1つは、RevenueCatと統合することです。RevenueCatは、インアプリサブスクリプションとインアプリ購入を提供するプラットフォームです。RevenueCatは、複数のプラットフォーム間で一貫した__CAPGO_KEEP_1__を提供し、レシート検証とユーザーマネージメントなどのタスクを自動化します。

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.

ユーザーマネージメント

カスタム価格モデルへの対応
__CAPGO_KEEP_0__
Capacitorフレームワーク
詳細分析 -拡張性

Capacitorを使用したCapacitor PurchasesプラグインとRevenueCatを利用することで、開発者はモバイルアプリケーションにインアプリサブスクリプションや購入を実装する際の時間と労力を削減でき、ユーザー体験の向上と収益の増加に役立つ追加機能を提供できます。

Using Capacitor Purchases plugin and RevenueCat, developers can easily manage and track in-app subscriptions and purchases, validate receipts, and manage users across multiple platforms. It also allows creating custom pricing models and get detailed analytics to improve the performance and revenue.

インストール

最新のCapacitorとCapacitor Purchases プラグインを使用してください。最新のCapacitorとCapacitor Purchases プラグインのバージョンは、Capacitor ウェブサイトで確認できます。

Capacitor のインストールに必要なプラグインである Capacitor Purchases プラグインをインストールするには、以下のコマンドを実行してください。 npm i @capgo/capacitor-purchases アプリにプラグインを追加するには、Capacitorのnative codeを設定してください。 npx cap sync

Xcode にインアプリ購入機能を追加する

Xcode ステップ 1 次のステップ Xcodeのステップ2

1. CloudflareでRevenueCatアカウントを作成

このガイドでは、サブスクリプションとRevenueCatのSDKを使用して、数行のcodeで実行可能な状態にします。

新しいRevenueCatアカウントに登録するここ.

📘

💡 ここにヒントがあります!

RevenueCatは、各アプリ/プロジェクトごとに別々のRevenueCatアカウントを作成することをお勧めします。特に、アプリを売る予定がある場合は、特にアカウントを転送する際に迅速化されます。

組織/エンタープライズ

RevenueCatに登録し、アプリをプロジェクト内に設定する際は、会社アカウントを使用することをお勧めします。プロジェクトの残りのメンバーをプロジェクトに招待できますが、プロジェクトのオーナーだけが請求管理を実行できます。プロジェクトのコラボレーターは請求管理の詳細を管理できません。 2. プロジェクトとアプリの設定 only the project owner can manage billing. Project collaborators can’t manage billing details.

2. Project and App Configuration

▶️ プロジェクトを作成

RevenueCat ダッシュボードに移動し新しいプロジェクトを追加上部ナビゲーションメニューのドロップダウンから プロジェクト.

コンテキスト: Capgo マーケティングウェブサイト。役割: 短い UI ラベルまたはナビゲーションアイテム。ページ: contributing.astro に表示される。メッセージキー `projects` (Projects).

RevenueCat ステップ 1

新しいプロジェクトを作成するポップアップモーダル

▶️ アプリ / プラットフォームを追加 プロジェクト設定 > アプリ プロジェクトダッシュボードの左メニューで、追加するアプリのプラットフォームを選択

RevenueCat ステップ 2

アプリプラットフォームの選択用のプロジェクトダッシュボード

このフィールド アプリ名 RevenueCatにアプリを追加するには、アプリ名が必要です。残りの設定フィールドは後で追加できます。テストと実稼働の購入を行うには、Bundle ID (iOS) / Package Name (Android) 以外に、Shared Secret (iOS) / Service Credentials (Android) の設定が必要です。

RevenueCat ステップ 3

Apple App Store用のアプリ設定ページ

📘

💡 ここにヒントがあります!

アプリを登録した後、RevenueCatはアプリの設定でプラットフォームサーバー通知を設定することをお勧めしています。これらの通知は必須ではありませんが、ウェブホックの配信時間と統合時間を速めることができ、サブスクライバーの更新時間を短縮できます。

📘

ステージングと本番アプリとユーザー

RevenueCat自体はステージングと本番用の環境を分けることはありません。その代わりに、ユーザーの下位のトランザクションはサンドボックスと本番で区別されます。

RevenueCatの任意のアプリは、両方のサンドボックスと本番の購入をストアから行うことができます。ただし、ステージングと本番用のアプリを分ける場合は、RevenueCatで複数のプロジェクトを作成して、設定をミラーリングすることができます。

さらに、環境によってユーザーを区別することもありません。同じユーザーは、同時にサンドボックスと本番の購入を有効に保つことができます。

▶️ サービス認証情報

RevenueCatは、アプリストアと通信するために、サービス認証情報を設定する必要があります。详细信息については、RevenueCatのガイドを参照してください。 App Store Connect 共有シークレット, Play Service 認証情報, そして Amazon Appstore 共有シークレット詳細についてはこちらを参照してください。

ただし、Play Service 認証情報は、Googleのサーバー全体にまで 36 時間かかることがあります。

3. 商品設定

▶️ ストア設定

RevenueCatを使用して製品を取得する前に、製品をそれぞれのストアで設定する必要があります。以下のガイドを参照してください。 App Store Connect, Google Play Console, Amazon Appstore、および Stripe を使用してこのプロセスをナビゲートするのに役立ちます。

iOS製品を販売している場合、請求アプリケーション契約を署名し、App Store Connect > 契約、税金、銀行 > で銀行と税金情報を入力することを確認してください。 App Store Connect > 契約、税金、銀行 > を完了する必要があります。これを行うと購入をテストできます。. __CAPGO_KEEP_0__.

📘

試験中に店舗の設定をスキップしたいですか?

iOS の場合、App Store Connect で製品を設定するのを遅らせることができます。StoreKit Configuration ファイルを使用してテストするのです。これらの設定ファイルは、Xcode を直接使用して最小限の設定で設定できます。

RevenueCat で StoreKit Configuration ファイルの設定方法についてもっと読むサンドボックステストガイド

▶️ RevenueCat で製品と特典を設定する

App Store Connect Google Play Console, Amazon Appstore, 、またはStripe Stripe、RevenueCat ダッシュボードにその設定をコピーする必要があります。RevenueCat は、プレミアム機能へのアクセスを制御する Entitlements システムと、顧客に提供する製品のセットを管理する Offerings を使用します。

Entitlements は、特定の製品を購入した後、顧客が「有資格」であるレベルです。 Offerings は、Paywall に表示するインアプリ製品を簡単に組織化して、リモートで構成する方法です。RevenueCat 推奨利用することをお勧めします。これにより、code を簡素化し、製品を変更することなくアプリの更新をリリースすることができます。

参照製品を設定し、Offerings または Entitlements に組織する方法を確認してください。 RevenueCat のステップ 4

4. RevenueCat の Purchases __CAPGO_KEEP_0__

RevenueCat は、Purchases とサブスクリプションをプラットフォーム間でシームレスに実装し、RevenueCat サーバーとトークンを同期する SDK を提供します。

問題が発生した場合は、SDK を参照してください。

If you run into issues with the SDK, see Troubleshooting the SDKs ガイドラインを参照してください。

📘

Purchasesにのみ、パブリックSDKキーを使用してください。

パブリックSDKキーは、ダッシュボードのプロジェクト設定のタブから取得できます。 APIキー ダッシュボードのプロジェクト設定のタブ プロジェクト設定 Purchasesの共有インスタンスを一度だけ、通常はアプリ起動時に設定してください。アプリ内で、共有インスタンスを取得することで、同じインスタンスをアプリ全体で共有できます。

Purchasesのインスタンス インスタンス RevenueCatのガイドを参照してください。 .shared instance in the SDK.

__CAPGO_KEEP_0__ Configuring SDK 詳細情報やベストプラクティスについてはこちらを参照してください。

開発環境では、RevenueCatが推奨するように、デバッグログをより詳細に表示するようにしてください。デバッグログについての詳細は、以下の ガイドを参照してください。 with your public SDK key only. You can read more about the different API keys available in RevenueCat キーと組み合わせて使用する場合は、RevenueCatの.

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_******'})
}

モードガイドを参照してください。購入キーの設定購入キーの設定

If you’re planning to use RevenueCat alongside your existing purchase code, refer to their guide on 購入IDを使用した購入キーの設定.

📘

購入IDを使用した購入キーの設定

アプリ内課金をCapacitorで実装する .logIn()を呼び出すことで、設定時または後日、ユーザーIDを提供できます。ユーザー認証.

The SDK will automatically fetch the ユーザーを識別する __CAPGO_KEEP_0__

自動的にApple、Google、またはAmazonから設定されたオファリングを取得し、製品情報を取得します。顧客が購入画面を起動したときにすでに利用可能な製品がロードされているため、利用可能な製品を取得して表示することができます。オファリングを取得して表示する

ユーザーIDを使用して購入を設定する

📘

を呼び出すことで、設定時または後日、ユーザーIDを提供できます。

ユーザー認証 .logIn(). Apple, Google, Amazon の提供する商品情報を取得するには、ユーザーを識別する.

The SDK will automatically fetch the __CAPGO_KEEP_0__ が自動的に設定された商品情報を取得し、Apple, Google, Amazon から商品情報を取得します。したがって、顧客が購入画面を起動したときにすでに利用可能な商品が読み込まれていることになります。

以下に、商品情報を取得する例を示します。利用可能な商品を表示するには、Paywall スクリーンを組織化するために Offerings を使用できます。さらに詳しくは、 RevenueCat のガイド "Displaying Products" を参照してください。 Offerings から商品情報を取得する場合、または利用可能な

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

商品を取得する場合、, products, or available パッケージは空の場合、対応するストアの設定問題によるものです。

App Store Connect の場合、最も一般的な原因は、有料アプリケーション契約が古い状態にあることや、製品が少なくとも「提出準備完了」状態になっていないことです。Google Play の場合、通常、クローズドトラックでアプリが公開されていない場合や、有効なテストユーザーが追加されていない場合に発生します。

RevenueCat のヘルプセンターでこの問題のトラブルシューティングについて詳しく調べることができます。購入の助け.

Capgo の __CAPGO_KEEP_0__ は、購入を簡単に実行できる方法を提供します。

SDK は、取得したオファリングからパッケージを取得し、対応するアプリストアでトランザクションを処理します。 purchase:package Capgo の __CAPGO_KEEP_0__ のサンプルは、パッケージを購入し、「your_entitlement_id」コンテンツがアンロックされることを確認するプロセスを示しています。__CAPGO_KEEP_0__ の詳細については、RevenueCat の "購入の実行" ガイドを参照してください。

The code sample below shows the process of purchasing a package and confirming it unlocks the “your_entitlement_id” content. More details about the purchase:package 購入ステータスの確認 __CAPGO_KEEP_0__.

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
}

__CAPGO_KEEP_0__

このメソッドを使用して、最新の状態を取得する必要がある場合にいつでも呼び出すことができます。また、再生産性のあるアプリのライフサイクル中にも安全に呼び出すことができます。購入最新の購入情報は自動的にキャッシュされ、更新されるたびにキャッシュから取得され、高速に実行されます。 CustomerInfo このメソッドを呼び出す典型的なシナリオは、ユーザーに表示するUIを決定するときや、特定の特権レベルが必要なアクションを実行するときです。

💡 ここにヒントがあります!

📘

購入のステータスについては、単に有効かどうかだけを確認するのではなく、購入の詳細情報にアクセスすることもできます。RevenueCatのガイドを参照してください。

購入のステータス購入のステータスを確認する方法を学びましょう。購入が再生産されるかどうか、ユーザーのクレジットカードに問題が発生しているかどうか、などを確認できます。 RevenueCatは、ユーザーが以前購入したコンテンツを再度購入することができるようにします。同一のストアアカウント (Apple、Google、またはAmazonアカウント) 内の購入を再度購入することができます。すべてのアプリには、ユーザーが購入を再度購入できるようにするためのメカニズムが必要です。特に、ユーザーがアプリをアンインストールしたり再インストールしたり、またはアカウント情報を失ったりすると、購入を再度購入することができなくなります。

restore store account Apple, Google, or Amazon account

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

2 つの異なる App User ID 同じ基盤ストアアカウント (Apple、Google、またはAmazon アカウント) から 2 つの異なる App User ID 同じ基盤ストアアカウント (Apple、Google、またはAmazon アカウント) から 2 つの異なる

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 Restoring Purchases purchases:receivedUpdated:.

This method will fire whenever the SDK receives an updated CustomerInfo Capacitor の __CAPGO_KEEP_0__ は、どのプラットフォームでも平滑に動作するため、ユーザーの購入情報の変更はさまざまなソースから来る可能性があります。顧客の購入情報の変更に応じて、任意の変更に対応することができます。 getCustomerInfo(), purchase(package:), purchase(product:)delegate メソッドに従ってください。 restorePurchases().

Capacitor の __CAPGO_KEEP_0__ が、購入情報の更新されたオブジェクトを受け取った場合に発火します。 Capacitor の __CAPGO_KEEP_0__ が、購入情報の更新されたオブジェクトを受け取った場合に発火します。 RevenueCatのバックエンドからアプリにプッシュされた更新は、上記で説明されているように、RevenueCatへのアウトバウンドネットワークリクエストのみで行うことができます。

あなたのアプリに応じて、デリゲートを無視し、次回アプリが起動したときやSDKメソッドの完了ブロックで顧客情報の変更をハンドルするだけでも十分かもしれません。

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

👍

おめでとう!

あなたは、サーバーcodeを1か月間書くことなく、完全機能のサブスクリプション購入システムを実装したことになります。ご祝儀!

サンプルアプリ

RevenueCatサンプルアプリのリソースにアクセスして、SDKを完全に統合したサンプルアプリをダウンロードしてください。

サンプルを表示

あなたはCapacitorとVue.jsを使用したサンプルアプリを公開する予定です。

If you need to move deep usage of the Capacitor SDK check the documentation ここ.

次のステップ

あなたの製品が正しく設定されていることを確認するには、RevenueCatを確認してください。特権のガイド.
独自のユーザー識別子を使用したい場合は、以下を参照してくださいアプリのユーザーIDを設定する方法 .
RevenueCatから別のシステムに移行する場合は、RevenueCatの既存のサブスクリプションを移行する方法.
統合をテストする準備ができたら、RevenueCatのテストとデバッグのガイド.
App Store Small Business Programの資格がある場合は、RevenueCatのアプリケーションとRevenueCatに通知する方法

ライブ更新が必要な場合は

ここに参加してください 👇

アカウントを作成してください

Capgo

capacitor

__CAPGO_KEEP_0__ capacitor __CAPGO_KEEP_0__ Pricing Capgo Pricing for the product workflow in Capgo Pricing, Payment system @__CAPGO_KEEP_0__/native-purchases @capgo/native-purchases for the implementation detail in @capgo/native-purchases, Getting Started for the implementation detail in Getting Started, and Revenue Playbook for the implementation detail in Revenue Playbook.

capacitorのインアプリ購入