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__
__CAPGO_KEEP_1__
詳細分析 -拡張性

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

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 アプリにプラグインを追加するには、native code を設定してください。 npx cap sync

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

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

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

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

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

📘

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

RevenueCatは、各アプリ/プロジェクトごとに別々のRevenueCatアカウントを作成することをお勧めしています。特に、アプリを売る予定がある場合は、特定のプロジェクトを個別に転送するのではなく、全体のアカウントを転送できるため、転送プロセスが速くなります。

組織/エンタープライズ

RevenueCatに登録し、アプリをプロジェクト内に設定する際は、会社アカウントを使用することをお勧めします。プロジェクトの残りのメンバーをプロジェクトのコラボレーターとして招待できますが、プロジェクトのオーナーだけが請求設定を管理できます。プロジェクトのコラボレーターは請求設定を管理できません。 2. プロジェクトとアプリの設定 2. プロジェクトとアプリの設定 2. プロジェクトとアプリの設定2. プロジェクトとアプリの設定

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

▶️ プロジェクトを作成

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 > 契約、税金、銀行. 購入をテストする前にこれを完了する必要があります.

📘

ストアのセットアップをテスト中にスキップしたいですか?

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

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

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

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

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

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

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

RevenueCat は、SDK に問題が発生した場合、

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

RevenueCat の SDK は、プラットフォームを問わず購入とサブスクリプションをシームレスに実装し、RevenueCat サーバーとトークンを同期します。 RevenueCat の __CAPGO_KEEP_0__ に問題が発生した場合、ガイドラインを参照してください。

📘

Only use your public SDK key to configure Purchases

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

Purchasesのインスタンスは、通常アプリ起動時に一度だけ設定してください。アプリ内でインスタンスを共有するには、__CAPGO_KEEP_0__でインスタンスを取得してください。 RevenueCatのガイドを参照してください。 Purchasesのインスタンスは、通常アプリ起動時に一度だけ設定してください。アプリ内でインスタンスを共有するには、__CAPGO_KEEP_0__でインスタンスを取得してください。 .shared Purchasesのインスタンスは、通常アプリ起動時に一度だけ設定してください。アプリ内でインスタンスを共有するには、SDKでインスタンスを取得してください。

Purchasesのインスタンスは、通常アプリ起動時に一度だけ設定してください。アプリ内でインスタンスを共有するには、__CAPGO_KEEP_0__でインスタンスを取得してください。 Configuring SDK __CAPGO_KEEP_0__の詳細情報とベストプラクティスについてはこちら

__CAPGO_KEEP_0__を正しく設定する購入 SDKの公開鍵のみでSDKを設定してください。RevenueCatのAPIの種類についてはこちら認証ガイド.

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はデバッグログをより詳細に表示することを推奨しています。詳細はこちらのデバッグガイド

codeとRevenueCatを併用する場合の購入codeについてはこちらのオブザーバーモード.

📘

__CAPGO_KEEP_0__をユーザーIDで設定する

あなたのアプリにユーザー認証システムがある場合、設定時または後日、以下の呼び出しを実行してユーザー識別子を提供できます。 .logIn(). ユーザーを識別する.

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

以下はOfferingsを取得する例です。Paywall画面を組織化するためにOfferingsを利用できます。詳細とベストプラクティスについては、RevenueCatの製品を表示するを参照してください。

▶️利用可能な製品を取得して表示

📘

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

あなたのアプリにユーザー認証システムがある場合、設定時または後日、以下の呼び出しを実行してユーザー識別子を提供できます。 .logIn(). Apple, Google, Amazon の提供する商品情報を取得するには、RevenueCat のガイドを参照してください。ユーザーを識別する.

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

Offerings を取得する例を以下に示します。Paywall を表示する際に Offerings を利用できます。RevenueCat のガイドを参照してください。商品情報を表示する RevenueCat のガイドとベストプラクティスについては、以下のリンクを参照してください。

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

Offerings の商品情報を取得する場合、または利用可能な商品, 商品商品パッケージは空の場合、対応するストアの設定問題によるものです。

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

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

Capgoは購入を簡素化するためのシンプルなメソッドを提供します。

The SDK includes a simple method for facilitating purchases. The purchase:package Capgoのサンプルコードは、パッケージを購入し、「your_entitlement_id」コンテンツがアンロックされることを確認するプロセスを示しています。Capgoの購入方法については、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__ __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アカウント) で購入したものを復元する機能を提供します。すべてのアプリには、ユーザーが復元メソッドをトリガーできる方法が必要です。ただし、Appleは、ユーザーが購入アクセスを失う場合 (例: アプリをアンインストール/再インストール、ユーザー情報を失うなど) に復元メカニズムが必要であることを要求しています。

Capacitor Cloudflare GitHub

  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 App User ID 同じ基盤ストアアカウント (Apple、Google、またはAmazon アカウント) から 2 つの異なる App User ID

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 Capgo は、どのプラットフォームでも平滑に動作するため、ユーザーの購入情報の変更はさまざまなソースから来る可能性があります。 getCustomerInfo(), purchase(package:), purchase(product:)購入情報の変更に対応するには、 restorePurchases().

Capgo が更新された object を取得するために呼び出される Capgo のメソッド、または CustomerInfo の更新を呼び出す場合に、 RevenueCatのバックエンドからアプリにプッシュされる更新は、上記で説明されているように、RevenueCatへのアウトバウンドネットワークリクエストのみで発生することができます。

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

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

👍

おめでとう!

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

サンプルアプリ

SDKを完全に統合したサンプルアプリをダウンロードするには、RevenueCatサンプルアプリリソースをご覧ください。

サンプルを表示

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

Capacitorの深い使用を必要とする場合は、SDKを確認してください。ここ.

次のステップ

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

アプリでリアルタイムの更新が必要な場合は

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

アカウントを取得するには、ここに登録してください

Capgo

Keep going from in app purchases for capacitor

Capacitorを使用している場合 in app purchases for capacitor Capacitorを使用してアプリ内購入と支払いを計画するには、Capacitorを Capgo Pricing for the product workflow in Capgo Pricing, Capacitor Payment system Capacitor Payment system @capgo/native-purchases for the implementation detail in @capgo/native-purchases, Capacitorを使用して始める Capacitorのインプレース購入の実装詳細については、 Revenue Playbook Revenue Playbookのインプレース購入の実装詳細については、

capacitor アプリ内課金