capacitorアプリ内課金

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

RevenueCatを使用せずに、APIのシンプルなネイティブアプリ内課金を実装したい場合は @capgo/native-purchases ストアキットとGoogle Play Billingと直接実装することで、__CAPGO_KEEP_0__ Purchasesはインアプリ購入とサブスクリプションをサポートしています。

Capacitor Purchasesは、Capacitorフレームワークのプラグインであり、iOSとAndroidでインアプリ購入をサポートします。複数のプラットフォームで一貫したAPIを提供し、開発者がモバイルアプリにインアプリサブスクリプションと購入を実装するのを簡単にします。

Capacitor Purchasesプラグインの主な機能の1つは、RevenueCatと統合することです。RevenueCatはインアプリサブスクリプションとインアプリ購入を提供するプラットフォームであり、インアプリサブスクリプションと購入を実装するプロセスを簡素化し、複数のプラットフォームで一貫したAPIを提供し、レシート検証とユーザーマネージメントなどのタスクを自動化します。

RevenueCatを使用すると、開発者はサブスクリプションを簡単に管理し、収益を追跡し、関連するタスクを実行できます。RevenueCatが提供する機能の例としては次のとおりです。

• 自動レシート検証
• ユーザーマネージメント
• カスタム価格モデルへの対応
• 詳細な分析 -スケーラビリティ

Capacitor PurchasesプラグインをRevenueCatと組み合わせると、開発者はインアプリサブスクリプションと購入を実装するのを簡素化し、ユーザー体験を向上させ、収益を増やすのに役立つ追加機能を提供できます。

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

インストール

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

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

Xcode でインストール済みの購入の機能を追加します:

次に

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

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

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

📘

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

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

組織/エンタープライズ

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

▶️ プロジェクトを作成

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

▶️ 新しいプロジェクトを追加する 上部のナビゲーションメニューのドロップダウンから プロジェクト.

RevenueCat ステップ 1

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

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

RevenueCat ステップ 2

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

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製品を販売している場合、Paid Applications Agreementに署名し、App Store Connect > Agreements, Tax, and Bankingで銀行と税金の情報を入力することを確認してください。 App Store Connect > Agreements, Tax, and Banking. 購入をテストする前にこれを完了する必要があります。.

📘

テストをスキップしたい場合はストアの設定をスキップできますか?

iOSでは、StoreKit Configurationファイルを使用してApp Store Connectの製品設定を延期できます。これらの設定ファイルは、Xcodeを介して最小限の設定で設定できます。

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

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

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

RevenueCatはエンティテルメントシステムを使用してプレミアム機能へのアクセスを制御し、顧客に提供する製品のセットを管理するためにオファリングを使用します。 推奨 utilizing these features to simplify your code and enable you to change products without releasing an app update.

参照 製品の設定 製品を設定し、OfferingsまたはEntitlementsに組織化する方法を説明します。

4. RevenueCatのPurchases SDK

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

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

📘

Capacitorの公開SDKキーを使用してのみ、Purchasesを設定してください。

Capgoの公開SDKキーはダッシュボードのプロジェクト設定のタブから取得できます。 APIキー __CAPGO_KEEP_0__ プロジェクト設定 ダッシュボード

Purchasesの共有インスタンスは、通常アプリ起動時に一度だけ設定する必要があります。以降、アプリ内でインスタンスをアクセスすることで、同じインスタンスが共有されます。 インスタンス Capgoの設定については、RevenueCatのガイドを参照してください。 .shared instance in the SDK.

Capgoの設定については、RevenueCatのガイドを参照してください。 Configuring SDK Capgoの設定については、RevenueCatのガイドを参照してください。

Capgoの設定を確認してください 購入 with your public SDK key only. You can read more about the different API keys available in RevenueCat Authentication guide.

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の Debugging ガイドを参照してください。

RevenueCatとあなたの既存の購入codeを併用する計画がある場合は、RevenueCatの Observer Mode.

📘

購入をCapgoとユーザーIDと組み合わせる

あなたのアプリにユーザー認証システムがある場合、設定時または後日、 .logIn()を呼び出すことでユーザー識別子を提供できます。詳細については、RevenueCatの ユーザーを識別する.

The SDK will automatically fetch the オファリングの例 オファリングを使用して、支払い画面を整理できます。RevenueCatの「製品を表示する」ガイドを参照してください。

▶️ 利用可能な製品を取得して表示する 購入をユーザーIDと組み合わせる Capgoの設定時にユーザーIDを提供するか、後日呼び出すことで、ユーザー認証システムがあれば、ユーザーIDを提供できます。RevenueCatの「ユーザーを識別する」ガイドを参照してください。

__CAPGO_KEEP_0__

📘

設定されたオファリング

オファリング .logIn()オファリング オファリング.

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

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

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

Capgoが オファリング, 製品、または利用可能な パッケージ が空の場合、それはそれぞれのストアでの構成問題によることです。

App Store Connect では、このような理由で発生するのは、有料アプリの契約書が古い状態にある場合や、少なくとも「提出可能」状態にある製品が存在していない場合が多いです。GooglePlay では、通常、クローズド トラックにアプリが公開されていない場合や、有効なテストユーザーが追加されていない場合に発生します。

RevenueCat で詳しく調べることができます。 ヘルプセンター.

購入実行

SDKには、購入を容易にするためのシンプルなメソッドが含まれています。SDKは、取得したオファリングからパッケージを取得し、対応するアプリストアでトランザクションを処理します。 purchase:package __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 購入状況確認 購入状況を最新の状態で取得する必要がある場合や、アプリのライフサイクル中にも安全に呼び出すことができるメソッドです。.

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__ 自動的に最新のキャッシュを保持します。 CustomerInfo 更新されるたびにキャッシュから取得するので、ほとんどの場合、このメソッドは高速に実行されます。

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

📘

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

サブスクリプションの状態を確認するだけでなく、サブスクリプションが再生されるかどうか、ユーザーのクレジットカードに問題が発生しているかどうかなど、サブスクリプションに関するより多くの情報にアクセスできます。RevenueCatのガイドを参照してください。 サブスクリプションの状態 サブスクリプションが再生されるかどうか、ユーザーのクレジットカードに問題が発生しているかどうかなど、サブスクリプションに関するより多くの情報にアクセスできます。

RevenueCatは、ユーザーが以前購入したコンテンツを再活性化できるように、同一のストアアカウント (Apple、Google、またはAmazonアカウント) 内の購入を復元する機能を提供します。アプリのすべてに、ユーザーが復元メソッドをトリガーできる方法を設置することをお勧めします。Appleは、ユーザーが購入アクセスを失った場合 (例: アプリをアンインストール/再インストールしたり、アカウント情報を失ったりした場合) に復元メカニズムを必要とします。 2 つの異なる App User ID

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

アプリユーザーID アプリユーザーID Apple、Google、またはAmazonのアカウントからトランザクションを復元します。 RevenueCatは、2つのApp User 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 オプションのデリゲートメソッドに従うことで、 purchases:receivedUpdated:.

This method will fire whenever the SDK receives an updated CustomerInfo 、または getCustomerInfo(), purchase(package:), purchase(product:)Capgoから取得した更新された restorePurchases().

オブジェクトを受け取ったときに発火します。 RevenueCatのバックエンドから購入情報の更新は プッシュされないため、更新はCapgoからRevenueCatへのアウトバウンドネットワークリクエストのみで行う必要があります。

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

👍

あなたは成功しました！

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

サンプルアプリ

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

サンプルを表示

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

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

Capgo Builder / ネイティブクラウドビルド製品ページ

\

• あなたの製品が正しく設定されていることを確認するには、RevenueCatのエンティティメントガイドをご覧ください。 あなたが独自のユーザーIDを使用したい場合は、.
• 次のステップ 設定アプリユーザーID .
• RevenueCat から別のシステムに移行している場合、RevenueCat のガイドを参照してください。 既存のサブスクリプションを移行する方法についてのRevenueCatのガイドを参照してください。.
• 統合をテストする準備ができたら、RevenueCat のガイドに従ってテストとデバッグを実行してください。 App Store Small Business Program の資格がある場合は、RevenueCat のガイドを参照して、RevenueCat にアプリケーションと通知を送信してください。.
• アプリ内購入でリアルタイム更新が必要な場合はこちら アカウントを作成してください

Capgo にプルリクエストを提出する

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

__CAPGO_KEEP_0__

Capgo

capacitor

あなたが capacitor内アプリ購入を使用 __CAPGO_KEEP_0__内アプリ購入を使用して Capgo価格設定 Capgo価格設定の製品ワークフロー 決済システム 決済システムの実装詳細 @capgo/native-purchases @capgo/native-purchasesの実装詳細 Getting Started Getting Startedの実装詳細 Revenue Playbook Capgoの実装詳細については、Revenue Playbookを参照してください。