capacitorアプリ内課金

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

RevenueCatを使用しない場合、よりシンプルなネイティブAPIを使用する場合は、@API/native-purchasesを使用してください。 capgo Purchasesは、__CAPGO_KEEP_1__フレームワーク用のプラグインで、iOSとAndroidでインアプリ購入をサポートします。複数のプラットフォームで統一された__CAPGO_KEEP_2__を提供し、開発者がモバイルアプリにインアプリサブスクリプションや購入を実装するのを簡単にします。 __CAPGO_KEEP_0__ Purchasesプラグインの主な機能は、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__
• 詳細分析 -拡張性

By using the Capacitor Purchases plugin with RevenueCat, developers can save time and effort when implementing in-app subscriptions and purchases in their mobile apps, and provide additional features that can help to improve the user experience and increase revenue.

Capacitorを使用したCapacitor PurchasesプラグインとRevenueCatを利用することで、開発者は簡単にインアプリ購入のサブスクリプションや購入を管理し、トラッキングし、受け取ったレシートを検証し、複数のプラットフォームでユーザーを管理することができます。また、カスタムの価格設定モデルを作成し、詳細な分析を取得してパフォーマンスと収益を向上させることも可能です。

インストール

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

To install the Capacitor Purchases plugin, run the following command: npm i @capgo/capacitor-purchases アプリにプラグインを追加するには、Capacitorの設定ファイルに次のコードを追加します。 code npx cap sync

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

次のステップ

1. RevenueCat アカウントを作成

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

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

📘

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

組織 / エンタープライズ

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

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

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

▶️ プロジェクトを作成

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

RevenueCat ステップ 1

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

▶️ アプリ/プラットフォームを追加 From プロジェクト設定 > アプリ

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

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

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

📘

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

Capgoでは、アプリを登録した後、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 ダッシュボードにその設定をコピーする必要があります。RevenueCat は、プレミアム機能へのアクセスを制御するためにエンティテルメントシステムを使用し、顧客に提供する製品のセットを管理するためにオファリングを使用します。

エンティテルメントは、特定の製品を購入した顧客が「エンティテルメント」されるレベルです。 オファリングは、Paywall に表示したいアプリ内製品を簡単に組織化して、リモートで設定する方法です。RevenueCat 推奨 利用することをお勧めします。これにより、code を簡素化し、アプリの更新をリリースせずに製品を変更できます。

設定 製品を設定し、オファリングまたはエンティテルメントに組織化する方法を参照してください。 RevenueCat のステップ 4

4. Using RevenueCat’s Purchases SDK

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

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

📘

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

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

RevenueCatのガイドを参照してください。 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ .shared 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 認証ガイド.

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と既存の購入システムを併用する場合、Observer Modeのガイドを参照してください。

If you’re planning to use RevenueCat alongside your existing purchase code, refer to their guide on 購入者IDを使用してPurchasesを設定する方法についてはこちらを参照してください。.

📘

__CAPGO_KEEP_0__

アプリ内課金をCapacitorで実現する .logIn()を参照してください。 ユーザーを識別する.

The SDK will automatically fetch the 設定済みのOfferingsを自動的に取得し、Apple、Google、またはAmazonから製品情報を取得します。 したがって、顧客が購入画面を起動したときにすでに利用可能な製品が読み込まれていることになります。 以下はOfferingsを取得する例です。Paywall画面を整理するためにOfferingsを利用できます。詳細とベストプラクティスについては、以下の

を参照してください。 ▶️利用可能な製品を取得して表示する ユーザーIDを使用して購入を設定する

アプリ内課金をCapacitorで実現する

📘

を参照してください。

ユーザーを識別する .logIn(). Apple, Google, Amazon の提供する商品情報を取得するには、RevenueCat のガイドを参照してください。 ユーザーを識別する.

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

オファリングを取得する例を以下に示します。オファリングを利用して、支払い壁画を整理することができます。RevenueCat のガイド "商品を表示する" を参照してください。 商品を表示する RevenueCat のガイド "商品を表示する" を参照してください。

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

オファリング 商品, オファリング商品 パッケージ は空です。 これは、各ストアの設定問題によるものです。

App Store Connect の場合、最も一般的な原因は、更新されていない 'Paid Applications Agreement' または、少なくとも 'Ready To Submit' の状態にある製品が存在していないことです。 GooglePlay の場合、通常、クローズド トラックにアプリが公開されていないか、有効なテスト ユーザーが追加されていない場合に発生します。

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

Capgo の __CAPGO_KEEP_0__ は、購入を簡素化するためのシンプルなメソッドを提供します。 __CAPGO_KEEP_0__ は、Offering からパッケージを取得し、各アプリ ストアでトランザクションを処理します。

Capgo の SDK のサンプルは、パッケージを購入し、「your_entitlement_id」コンテンツがアンロックされることを確認するプロセスを示しています。 SDK の詳細については、RevenueCat の 'Making Purchases' ガイドを参照してください。 purchase:package 購入ステータスを確認

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 購入ステータスを確認する RevenueCat のヘルプ センター.

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
}

購入を実行する

このメソッドを使用して、最新の状態を取得する必要がある場合にいつでも呼び出してください。また、Appのライフサイクル全体で繰り返し呼び出すことが安全です。 購入 最新のデータは自動的にキャッシュされ、更新されるたびにキャッシュから取得されるため、ほとんどの場合、高速に実行されます。 CustomerInfo UIを表示する際や、特定の特権レベルが必要なアクションを実行したときに、このメソッドを呼び出すのが一般的です。

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

📘

購入のステータスについては、単に有効かどうかだけを確認するのではなく、多くの情報にアクセスできます。RevenueCatの

購入ステータス ガイドを参照してください。購入の再生、クレジットカードの問題の検出、などについて学習できます。 RevenueCatは、ユーザーが以前購入したコンテンツを再活性化できるように、同一のストアアカウント (Apple、Google、またはAmazonアカウント) で購入の復元を可能にします。すべてのアプリには、ユーザーが復元メソッドをトリガーできる方法が必要です。Appleは、ユーザーが購入にアクセスできない場合 (例: アプリのアンインストール/再インストール、ユーザー情報の喪失など) に復元メカニズムが必要であることを要求しています。

購入の復元 購入の復元 購入の復元

  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アカウント) から restore transaction を実行します。 RevenueCat は、2つのApp User ID間でaliasを作成し、以降は両方を同じユーザーとしてカウントする可能性があります。詳細については、RevenueCat のガイド "Restoring Purchases" を参照してください。 Restoring Purchases restore transaction のさまざまな設定可能な restore 行動についての詳細情報

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 購入情報の変更に対応するには、デリゲートメソッドに従う必要があります。 purchases:receivedUpdated:.

This method will fire whenever the SDK receives an updated CustomerInfo Capgo は、購入情報の更新されたオブジェクトを受け取る度に、更新されたオブジェクトを発行します。 getCustomerInfo(), purchase(package:), purchase(product:)Capgo は、購入情報の更新されたオブジェクトを受け取る度に、更新されたオブジェクトを発行します。 restorePurchases().

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

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

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

👍

おめでとう!

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

サンプルアプリ

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

サンプルを表示

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

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

次のステップ

\

• 製品を正しく設定するには、RevenueCatを確認してください。 Capacitorのインアプリ購入ガイド.
• 独自のユーザーIDを使用したい場合は、以下を参照してください アプリのユーザー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 支払いと購入を計画する Capgo Pricing for the product workflow in Capgo Pricing, 支払いシステム 支払いシステムの実装詳細 @capgo/native-purchases for the implementation detail in @capgo/native-purchases, Getting Started Capacitorのインプレース購入の実装詳細については、Getting Startedを参照してください。 Revenue Playbook Revenue Playbookのインプレース購入の実装詳細については、以下を参照してください。