capacitor アプリ内購入

このプラグインは、RevenueCat公式リポジトリに移管されました。詳しくは公式ドキュメントを参照してください。公式ドキュメント __CAPGO_KEEP_0__購入は、__CAPGO_KEEP_1__フレームワーク用のプラグインです。iOSおよびAndroidでインアプリ購入をサポートし、複数のプラットフォームで統一された__CAPGO_KEEP_2__を提供します。

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.

自動レシート検証

ユーザーマネージメント
カスタム価格モデルへの対応
詳細な分析 -スケーラビリティ
RevenueCatと__CAPGO_KEEP_0__購入プラグインを使用すると、開発者はインアプリサブスクリプションと購入を実装するプロセスを簡素化し、ユーザー体験を向上させ、収益を増やすことができます。

Capacitor Purchasesは__CAPGO_KEEP_1__フレームワーク用のプラグインです。

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

インストール

最新の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で起動する方法を紹介します。

Capgoで新しいRevenueCatアカウントを作成するには、まずCapgoでアカウントを作成し、RevenueCatにサインアップする必要があります。 Japanese.

📘

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

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

組織/エンタープライズ

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

RevenueCatダッシュボードに移動してください

▶️

プロジェクト __CAPGO_KEEP_0__を追加 __CAPGO_KEEP_1__からドロップダウンメニューのトップナビゲーションメニューの プロジェクト.

RevenueCat ステップ 1

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

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

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

RevenueCat ステップ 2

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

フィールド アプリ名 __CAPGO_KEEP_0__

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

RevenueCatのステップ 3

📘

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

💡 ここにヒントがあります! アプリを登録した後、RevenueCatはプラットフォームサーバー通知これらの通知は必要ありませんが、 Webhook

📘

と統合の配信時間を速めるため、遅延時間を削減します。

ステージングと実稼働アプリとユーザー

どのRevenueCatアプリでも、両方のサンドボックスと生産の購入をストアから行うことができます。また、ステージングと生産用の別々のアプリがある場合、RevenueCatに複数のプロジェクトを作成して、設定をミラーリングすることができます。

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

▶️ サービス認証情報

RevenueCatは、ストアと通信するためにあなたの behalfで設定する必要があるサービス認証情報が必要です。さらに詳しくは、RevenueCatのガイドを参照してください。 App Store Connect 共有シークレット, Play Service 認証情報、および Amazon Appstore 共有シークレットの詳細については、

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

3. 商品設定

▶️ ストア設定

Capgoを使用して収益を取得する前に、製品をそれぞれのストアで設定する必要があります。詳しくは以下のガイドを参照してください。 App Store Connect, Google Play Console, Amazon AppstoreStripe iOS製品を販売している場合、App Store Connect > 契約、税金、銀行口座 > '有料アプリケーション契約'に署名し、銀行口座と税金情報を入力することをお忘れなく。 App Store Connect > 契約、税金、銀行口座

購入テストを行う前にこれを完了する必要があります。 ストア設定をテスト中にスキップしたいですか?. iOSでは、App Store Connectで製品を設定するのを遅らせることができます。StoreKit Configurationファイルを使用してテストするのです。これらの設定ファイルは、Xcodeを直接使用して設定することができます。.

📘

Capgoを使用して収益を取得する前に、製品をそれぞれのストアで設定する必要があります。詳しくは以下のガイドを参照してください。

App Store Connect

StoreKit設定ファイルの設定について詳しく読むサンドボックステストガイド。

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

App Store Connect、Google Play Console、Amazon Appstore、またはStripeでインアプリ製品を設定した後、RevenueCatダッシュボードにその設定をコピーする必要があります。 RevenueCatは、プレミアム機能へのアクセスを制御するための特典システムと、顧客に提供する製品のセットを管理するためのオファリングを使用します。, 特典は、特定の製品を購入した後、顧客が「特典」されるレベルです。, オファリングは、Paywallで製品を「提示」する方法として、製品を簡単に組織化し、リモートで設定する方法です。RevenueCat ▶️ RevenueCatで製品と特典を設定するApp Store Connect、Google Play Console、Amazon Appstore、またはStripeでインアプリ製品を設定した後、RevenueCatダッシュボードにその設定をコピーする必要があります。

RevenueCatは、プレミアム機能へのアクセスを制御するための特典システムと、顧客に提供する製品のセットを管理するためのオファリングを使用します。推奨これらの機能を利用して、codeを簡素化し、製品を変更することなくアプリの更新を実行することができます。

See 製品の設定製品を設定し、OfferingsまたはEntitlementsに組織する方法について説明します。

RevenueCat step 4

4. RevenueCatのPurchases SDKを使用

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

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

📘

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

あなたの公開 SDK キーは、ダッシュボードの "プロジェクト設定" タブから取得できます。 API キー プロジェクト設定 ダッシュボード Purchases の共有インスタンスは、通常アプリ起動時に 1 回だけ設定する必要があります。以降、アプリ内でインスタンスをアクセスすることで、同じインスタンスが共有されます。

インスタンス __CAPGO_KEEP_0__ RevenueCat のガイド "__CAPGO_KEEP_0__ の設定" を参照してください。 .shared SDK

__CAPGO_KEEP_0__ SDK __CAPGO_KEEP_0__

設定を正しく構成してください購入 SDKの公開鍵のみを使用してください。APIの異なる鍵については、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と既存の購入codeを使用する場合のガイドを参照してください。購入者モード.

📘

購入者IDを使用して購入を構成する

アプリ内でユーザー認証システムがあれば、ユーザー識別子を設定することができます。設定時または後日、 .logIn()を呼び出すことで、ユーザー識別子を提供できます。詳細は、RevenueCatのガイドを参照してください。ユーザーを識別する.

SDKは自動的にApple、Google、またはAmazonから提供された設定されたオファリングを取得し、製品情報を取得します。したがって、顧客が購入画面を起動したときに利用可能な製品はすでにロードされます。提供されたオファリングオファリングを使用して、Paywall画面を組織化できます。RevenueCatのガイド "製品を表示する方法" を参照してください。

▶️ 利用可能な製品を取得して表示するユーザーIDと購入を設定するユーザー認証システムがあれば、アプリ内でユーザー識別子を提供できます。設定時または後日、callを使用して識別子を提供できます。

詳細については、RevenueCatのガイド "ユーザーを識別する方法" を参照してください。

📘

提供されたオファリング

▶️ 利用可能な製品を取得して表示する .logIn()ユーザーIDと購入を設定するユーザー認証システムがあれば、アプリ内でユーザー識別子を提供できます。設定時または後日、callを使用して識別子を提供できます。.

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

以下は、オファリングを取得する例です。オファリングを使用して、支払い壁画を整理できます。詳細とベストプラクティスについては、製品の表示を参照してください。

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

オファリングの製品, 、または利用可能なパッケージが空の場合、各ストアの設定問題によります。 configured Offerings

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

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

Capgo には、購入を容易にするためのシンプルなメソッドが含まれています。

The SDK includes a simple method for facilitating purchases. The purchase:package 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 このメソッドを使用することで、最新のステータスを取得し、安全に呼び出すことができます。アプリのライフサイクル全体で、このメソッドを繰り返し呼び出すことができます。購入.

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__

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ CustomerInfo 最新のキャッシュを自動的にキャッシュする

更新されるたびに — したがって、ほとんどの場合、このメソッドはキャッシュから取得し、非常に高速に実行されます。

📘

ユーザーに表示するUIを決定するときや、特定の特権レベルが必要なアクションを実行したときに、このメソッドを呼ぶことが一般的です。

💡 ここにヒントがあります! サブスクリプションの有効性だけではなく、サブスクリプションの詳細情報にアクセスすることができます。サブスクリプションのステータスについてのRevenueCatのガイドを参照してください。サブスクリプションのステータス

サブスクリプションが再発行されるか、ユーザーのクレジットカードに問題が発生しているか、など、サブスクリプションの詳細情報を確認できます。 RevenueCatは、ユーザーが以前購入したコンテンツを再活性化できるように、ユーザーがインアプリ購入を復元できるようにします。 同一のストアアカウント (Apple、Google、またはAmazonアカウント) から購入したコンテンツを復元できます。

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

すべてのアプリには、ユーザーが復元メソッドをトリガーできる方法が必要です。ただし、Appleは、ユーザーが購入アクセスを失う場合 (例: アプリをアンインストール/再インストールしたり、アカウント情報を失ったりするなど) に復元メカニズムが必要であると要求しています。 2 つの異なる App User IDs 同じ基盤ストアアカウント (Apple、Google、またはAmazonアカウント) からトランザクションを復元します。 RevenueCat は、2 つの App ユーザー ID の間でエイリアスを作成し、以降は両方を同じユーザーとしてカウントする可能性があります。詳細については、RevenueCat のガイドを参照してください。購入の復元さまざまな構成可能な復元動作についての詳細情報については、

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 このメソッドは、 getCustomerInfo(), purchase(package:), purchase(product:)から受信した更新された restorePurchases().

オブジェクトに対して発火されます。は、または

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

👍

あなたは成功しました！

あなたは、サーバー code を 1 か月間書くことなく、完全機能のサブスクリプション購入システムを実装しました。おめでとうございます！

サンプルアプリ

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

サンプルを表示

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

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

次のステップ

製品が正しく設定されていることを確認するには、RevenueCat の "entitlements" に関するガイドを参照してください。自社のユーザー識別子を使用したい場合は、こちらを参照してください.
If you want to use your own user identifiers, read about __CAPGO_KEEP_1__ ユーザーIDを設定するアプリ .
別のシステムからRevenueCatに移行する場合は、RevenueCatのガイドを参照してください。既存のサブスクリプションを移行する方法についてのRevenueCatのガイドを参照してください。.
統合をテストする準備ができたら、RevenueCatのガイドを参照してください。 App Store Small Business Programの資格がある場合は、RevenueCatのガイドを参照してください。.
App Store Small Business Programへの申請方法とRevenueCatに通知する方法についてのRevenueCatのガイドを参照してください。ライブ更新機能が必要な場合はこちら

アカウントを作成するにはこちら

__CAPGO_KEEP_0__

Capgo

capacitor

あなたが使用している場合 capacitorのインアプリ購入 __CAPGO_KEEP_0__と接続して Capgoの価格設定 Capgoの価格設定の製品ワークフロー決済システム決済システムの実装詳細 @capgo/native-purchases @capgo/native-purchasesの実装詳細 Getting Started Getting Startedの実装詳細 Revenue Playbook Revenue Playbook の実装詳細について。

capacitorアプリ内課金

インストール

1. RevenueCatアカウントを作成します。

📘

組織/エンタープライズ

RevenueCatダッシュボードに移動してください

▶️

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

📘

📘

▶️ サービス認証情報

3. 商品設定

▶️ ストア設定

📘

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

4. RevenueCatのPurchases SDKを使用

📘

📘

詳細については、RevenueCatのガイド "ユーザーを識別する方法" を参照してください。

📘

Capgo には、購入を容易にするためのシンプルなメソッドが含まれています。

__CAPGO_KEEP_0__

📘

👍

サンプル アプリ

次のステップ

__CAPGO_KEEP_0__

capacitor

サンプルアプリ