capacitor アプリ内課金

__CAPGO_KEEP_0__ アプリ内課金のプラグインは、RevenueCat 公式リポジトリに移行されました。詳しくは公式ドキュメントを参照してください。公式ドキュメント __CAPGO_KEEP_0__ Purchases は、__CAPGO_KEEP_1__ フレームワーク用のプラグインで、iOS と Android でアプリ内課金を実行できるようにします。iOS と Android の両方で、開発者がアプリ内サブスクリプションや購入を実装するのを簡単にします。

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.

Capacitorの購入プラグインの重要な機能の1つは、RevenueCatというプラットフォームと統合していることです。RevenueCatは、インアプリ購入やサブスクリプションのためのツールを提供するプラットフォームです。RevenueCatは、インアプリ購入やサブスクリプションの実装を簡素化するために、複数のプラットフォームで使用できるシンプルで一貫したAPIを提供し、レシートの検証やユーザーマネージメントなどのタスクを自動化します。

Capgoでは、RevenueCatを使用することで、開発者は簡単にサブスクリプションを管理し、収益を追跡し、関連する他のタスクを実行できます。RevenueCatが提供する機能には、以下が含まれます。

自動受け取り確認
ユーザー管理
カスタム価格モデルに対するサポート
詳細分析 -拡張性

Capgoを使用してRevenueCatのCapacitor購入プラグインと組み合わせると、開発者はモバイルアプリにインアプリサブスクリプションや購入を実装する際に時間と労力を節約でき、ユーザー体験を向上させたり収益を増やすための追加機能を提供できる。

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 ウェブサイトで確認できます。

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

Xcodeにインストールされている購入機能を追加する:

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

1. RevenueCatアカウントを作成する

このガイドでは、サブスクリプションとRevenueCatのSDKを使用して、数行のcodeで実行する方法を説明します。

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

📘

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

RevenueCatは、各アプリ/プロジェクトごとに別々のRevenueCatアカウントを作成することをお勧めしています。特に、アプリを売る予定がある場合は、迅速なアカウントの移行が可能になります。

組織/エンタープライズ

Capgoでは、RevenueCatの登録とアプリのプロジェクト内での設定に会社アカウントを使用することをお勧めします。プロジェクト内で残りのチームメンバーを招待することができますが、プロジェクトのオーナーだけが請求管理を管理できます。 __CAPGO_KEEP_0__ 2. プロジェクトとアプリの設定 ▶️ プロジェクトを作成RevenueCat ダッシュボードに移動し、上部ナビゲーションメニューのドロップダウンから新しいプロジェクトを追加します。

Projects

RevenueCatのステップ1

プロジェクトのオーナーだけが請求管理を管理できます。プロジェクトのコラボレーターは請求管理の詳細を管理できません。 ▶️ プロジェクトを作成 プロジェクトとアプリの設定.

2. プロジェクトとアプリの設定

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

▶️ アプリ/プラットフォームを追加

From プロジェクト設定 > アプリ プロジェクトダッシュボードの左メニューで、追加するアプリのプラットフォームを選択してください。

RevenueCat ステップ 2

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

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

RevenueCat ステップ 3

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

📘

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

Capgoアプリを登録した後、RevenueCatでは Platform Server Notifications. これらの通知は必須ではありませんが、 webhooks と統合の配信時間を速めることで、サブスクライバーの更新時間を短縮します。

📘

Staging vs. Production アプリとユーザー

RevenueCat自体にはStagingとProductionの環境が分かれていないのですが、ユーザーのトランザクションはsandboxとproductionで区別されています。

RevenueCatのアプリはsandboxとproductionの両方の購入を行うことができます。StagingとProductionのアプリを分ける場合は、RevenueCatで複数のプロジェクトを作成して、設定をミラーリングすることができます。

さらに、ユーザーは環境によって区別されていません。同じユーザーはsandboxとproductionの両方の購入を同時に有効にできます。

▶️ Service Credentials

Service credentialsは、RevenueCatがアプリストアと連携するために必要です。RevenueCatのガイドを参照してください App Store Connect シェアードシークレット, Play Service クレデンシャル, そして Amazon Appstore シェアードシークレット詳しくはこちら。

プレイサービスクレデンシャルの場合、Google のサーバー全体に 36 時間以内に反映されることがあります。

3. 製品設定

▶️ ストア設定

RevenueCat を使用して製品を取得する前に、製品をそれぞれのストアで設定する必要があります。以下のガイドを参照してください。 App Store Connect, Google Play Console, Amazon Appstore, および Stripe iOS製品を販売している場合、必ず「Paid Applications Agreement」を署名し、銀行情報と税務情報を

App Store Connect > Agreements, Tax, and Banking この設定は購入テストを行う前に完了する必要があります。. ストアのセットアップをテスト中にスキップしたいですか?.

📘

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

RevenueCatでStoreKit Configurationファイルの設定方法についてもっと詳しく知りたい場合はこちらを参照してください。

サンドボックステストガイド。 ▶️ RevenueCatで製品とエンタイトルメントを設定する

▶️ RevenueCatで製品とエンタイトメントを設定する

App Store Connect、Google Play Console、Amazon Appstore、またはStripeでインアプリ製品を設定した後、RevenueCat ダッシュボードにその設定をコピーする必要があります。RevenueCatは、エンターテインメントシステムを使用して、プレミアム機能へのアクセスを制御し、顧客に提供する製品のセットを管理するためのオファーを管理します。エンターテインメントは、特定の製品を購入した後、顧客が「有資格」であるレベルです。, オファーは、簡単な方法で、Paywallで製品を「提示」するために使用することができます。また、製品をリモートで設定することもできます。RevenueCatは、__CAPGO_KEEP_0__を簡素化し、製品を変更することなくアプリの更新をリリースしなくても済むようにすることをお勧めしています。, 製品を設定する方法についてはこちらを参照してくださいEntitlements OfferingsRevenueCat

recommends See utilizing these features to simplify your code and enable you to change products without releasing an app update.

Entitlements Offerings 製品を設定し、次にOfferingsまたはEntitlementsに整理する。

RevenueCat ステップ 4

4. RevenueCatのPurchases SDKを使用します。

RevenueCat SDK seamlessly implements purchases and subscriptions across platforms while syncing tokens with the RevenueCat server.

問題が発生した場合のSDKのトラブルシューティングについては SDKのトラブルシューティングガイダンスを参照してください。

📘

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

パブリックSDKキーは、プロジェクト設定のSDKキーから取得できます。 APIキー プロジェクト設定 __CAPGO_KEEP_0__ ダッシュボード内で。

あなたは、通常はアプリ起動時に一度だけ、共有インスタンスを設定する必要があります。以降、同じインスタンスはアプリ内で、__CAPGO_KEEP_0__にアクセスすることで共有されます。購入 RevenueCatのガイド .shared Configuring SDK

RevenueCatのガイドあなたは、SDKのパブリックキーのみで購入を設定する必要があります。RevenueCatの Authentication guide

の Authentication guide with your public SDK key only. You can read more about the different API keys available in RevenueCat __CAPGO_KEEP_1__.

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

開発中の場合、RevenueCatはより詳細なデバッグログを有効にすることを推奨しています。詳細については、以下のガイドを参照してください。デバッグ RevenueCatを既存の購入__CAPGO_KEEP_0__と共に使用する場合の計画がある場合は、RevenueCatのガイドを参照してください。

If you’re planning to use RevenueCat alongside your existing purchase code, refer to their guide on 購入者IDを使用して購入を構成する.

📘

アプリ内でユーザー認証システムがある場合、ユーザー識別子を設定または後日呼び出すことで、ユーザー識別子を提供できます。

詳細については、RevenueCatのガイドを参照してください。 .logIn()ユーザーを識別する Capgoは自動的に設定された__CAPGO_KEEP_0__を取得し、Apple、Google、またはAmazonから製品情報を取得します。したがって、顧客が購入画面を起動したときにすでに利用可能な製品がロードされます。.

The SDK will automatically fetch the Configuring Purchases with User IDs Observer Mode

以下は、Offeringsを取得する例です。Offeringsを利用して、料金壁画を組織化できます。RevenueCatのガイドを参照してください。製品の表示 ▶️ 利用可能な製品を取得して表示

購入設定のユーザーIDの設定

📘

アプリ内でユーザー認証システムがある場合、設定時または後日、ユーザー識別子を提供できます。

詳細については、RevenueCatのガイドを参照してください。 .logIn()ユーザー識別 __CAPGO_KEEP_0__は、自動的に設定されたOfferingsを取得し、Apple、Google、またはAmazonから製品情報を取得します。したがって、顧客が購入画面を起動したときに利用可能な製品が既に読み込まれていることになります。.

The SDK will automatically fetch the 製品の表示 ▶️ 利用可能な製品を取得して表示

購入設定のユーザーIDの設定製品の表示詳細情報やベストプラクティスについてはこちらを参照してください。

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

アプリの Capgoの提供サービス, 製品利用可能なパッケージが表示されない場合は、対応するストアの設定に問題がある可能性があります。

App Store Connectの場合、最も一般的な原因は、更新されていない「有料アプリケーション契約」または、少なくとも「提出可能」状態の製品が存在していないことです。Google Playの場合、通常、クローズドトラックにアプリが公開されていないか、有効なテストユーザーが追加されていないことが原因です。

この問題についての詳細情報は、RevenueCatのヘルプセンターで確認できます。 ▶️ 購入を実行.

▶️

The SDKには、購入を容易にするためのシンプルな方法が含まれています。 purchase:package は、取得したOfferingからパッケージを取り出し、対応するアプリストアでトランザクションを処理します。

The codeサンプルは、パッケージを購入し、「your_entitlement_id」コンテンツがアンロックされるプロセスを示しています。RevenueCatの「Making Purchases」ガイドで、詳細についてはこちらを参照してください。 purchase:package ▶️ サブスクリプションのステータスを確認するこのメソッドを使用して、最新のステータスを取得できます。アプリのライフサイクル全体で、このメソッドを繰り返し呼び出すのは安全です。.

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
}

購入

自動的にキャッシュに最新のデータを保存します。キャッシュが更新された場合、キャッシュからデータを取得して高速に実行します。このメソッドを呼び出すのは、ユーザーに表示するUIを決定するときや、特定の特権レベルが必要なアクションを実行したときなど、ユーザーが特定の特権レベルが必要なアクションを実行したときなどです。 💡 ここにヒントがあります! CustomerInfo Purchase

Check Subscription Status

📘

Purchases

アプリの購入情報を確認するには、単にアクティブかどうかだけでは十分ではありません。CloudflareのCapacitorのサブスクリプションの状態を参照してください。サブスクリプションの更新設定、クレジットカードの問題など、詳細な情報を確認できます。

Capgoは、ユーザーが以前購入したコンテンツを再度購入することができるようにするため、ユーザーが購入したアプリの購入を復元できるようにします。 Capgoは、Apple、Google、またはAmazonのアカウントから購入したコンテンツを復元できるようにします。 Capgoは、ユーザーが購入したアプリの購入を復元できるようにすることをお勧めします。ユーザーがアプリをアンインストールしたり再インストールしたり、またはアカウント情報を失ったりすると、購入が復元されない可能性があります。

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

Capgoは、同じストアアカウント (Apple、Google、またはAmazonアカウント) から購入したアプリの購入を復元できるようにします。 Capgoは、同じストアアカウント (Apple、Google、またはAmazonアカウント) から購入したアプリの購入を復元できるようにします。 Capgoは、同じストアアカウント (Apple、Google、またはAmazonアカウント) から購入したアプリの購入を復元できるようにします。 Capgoは、同じストアアカウント (Apple、Google、またはAmazonアカウント) から購入したアプリの購入を復元できるようにします。 Capgoは、ユーザーの購入情報の変更を検知できます。

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 delegateメソッドをオプションで実装することで purchases:receivedUpdated:.

このメソッドは、SDKが更新された CustomerInfo objectから呼び出された getCustomerInfo(), purchase(package:), purchase(product:),または restorePurchases().

CustomerInfoの更新は RevenueCatのバックエンドからアプリにプッシュされない場合、更新はアウトバウンドのネットワークリクエストを介してRevenueCatにのみ発生することができます。あなたのアプリによっては、delegateを無視し、__CAPGO_KEEP_0__のメソッドの完了ブロックで、またはアプリが起動したときに、顧客情報の変更をハンドルするだけで十分であるかもしれません。

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)
})

👍

あなたは、サーバー__CAPGO_KEEP_0__を1か月間書くことなく、完全機能するサブスクリプション購入システムを実装したことになります!おめでとう!

You have now implemented a fully-featured subscription purchasing system without spending a month writing server code. Congrats!

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

To download more complete examples of integrating the SDK, head over to RevenueCat sample app resources.

サンプルを表示

CapacitorとVue.jsを使用したサンプルアプリをすぐに公開します。

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

次のステップ

あなたの製品が正しく設定されていることを確認するには、RevenueCatのエンタイトルメントのガイドを参照してください。 __CAPGO_KEEP_0__でユーザーIDを設定する方法については、こちらを参照してください。.
RevenueCatから別のシステムに移行する場合は、RevenueCatの既存のサブスクリプションの移行ガイドを参照してください。あなたの統合をテストする準備ができたら、RevenueCatのガイドを参照してください。 .
View Samples I will soon publish a sample app using __CAPGO_KEEP_0__ and Vue.js..
If you need to move deep usage of the __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ check the documentation here. テストとデバッグ.
App Store Small Business Programに申し込む資格がある場合は、RevenueCatのガイドを参照してください。 RevenueCatに申し込む方法についてのガイド

アプリ内でライブ更新が必要な場合

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

__CAPGO_KEEP_0__

Capgoのアプリ内購入から続けてください

Keep going from in app purchases for capacitor

__CAPGO_KEEP_0__のアプリ内購入 支払いと購入を計画するには、capacitorと接続する必要があります 価格設定 Capgo 製品ワークフローについてのCapgoの価格設定決済システム __CAPGO_KEEP_0__の決済システムの実装詳細 @capgo/native-purchases capgo/native-purchasesの実装詳細 Getting Started Getting Startedの実装詳細 Revenue Playbook Revenue Playbookの実装詳細