capacitor アプリ内課金

このプラグインは、RevenueCat公式リポジトリに移行されています。RevenueCat公式ドキュメントをご確認ください。 公式ドキュメント RevenueCatを使用せずに、よりシンプルなネイティブアプリ内課金用Capacitorを使用する場合は、@Capacitor/native-purchasesをご参照ください。

API capgo ストアキットとGoogle Play Billingと直接実装するためのインアプリ購入とサブスクリプション。

Capacitor Purchasesは、Capacitorフレームワークのプラグインであり、iOSとAndroidでインアプリ購入を可能にし、複数のプラットフォームで簡単かつ一貫したAPIを提供します。

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

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

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

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 買い物機能プラグインと RevenueCat を使用すると、開発者は簡単にインストール済みのサブスクリプションと購入を管理および追跡し、受け取り証明書を検証し、複数のプラットフォームでユーザーを管理できます。また、カスタム価格モデルを作成し、詳細な分析を取得してパフォーマンスと収益を向上させることもできます。

インストール

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

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

__CAPGO_KEEP_0__ のインストール済みの購入機能を追加する

次に

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

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

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

📘

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

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

組織/エンタープライズ

RevenueCatに登録し、アプリをプロジェクト内に設定する際は、会社アカウントを使用することをお勧めします。プロジェクトのオーナー以外のチームメンバーをプロジェクトに招待することができますが、プロジェクトのオーナー以外の人は請求情報を管理することはできません。 2. プロジェクトとアプリの設定 ▶️ プロジェクトを作成 RevenueCatダッシュボードに移動して▶️ プロジェクトを作成

RevenueCatダッシュボードに移動して

プロジェクトを作成

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

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

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

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

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

フィールド アプリ名 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 Credential、 Amazon Appstore 共有シークレット 詳細情報についてはこちら。

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設定ファイルを使用してテストするのではなく、Xcodeで直接設定ファイルを設定できます。

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

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

App Store Connectでインアプリ製品を設定した後 Google Play Consoleでインアプリ製品を設定した後, Amazon Appstoreでインアプリ製品を設定した後, 、またはStripe Stripe特典は、特定の製品を購入した後、顧客が「特典」を受けるレベルです。 オファリングは、Paywallで顧客に提供するインアプリ製品を簡単に組織化し、リモートで設定する方法です。RevenueCat

▶️ RevenueCatで製品と特典を設定する 推奨 Capacitorを使用して、codeを簡素化し、製品を変更することなくアプリの更新をリリースしなくても済むようにします。

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

4. RevenueCatのPurchases SDK

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

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

📘

Purchasesの設定では、パブリックSDKキーを使用してください。

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

Capacitorの共有インスタンスを設定する際は、以下の点に注意してください。 Purchases __CAPGO_KEEP_0__ .shared RevenueCatのガイドでSDKの設定について詳しく学びましょう。

Configuring __CAPGO_KEEP_0__ Configuring SDK ガイド

Capgoを使用する前に、__CAPGO_KEEP_0__キーをパブリックに設定してください。 購入 CapacitorのパブリックSDKキーのみでご利用ください。RevenueCatで利用可能なさまざまなAPIキーについては、詳しく読むことができます。 RevenueCatの__CAPGO_KEEP_1__キーについては、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_******'})
}

認証ガイド Debugging デバッグ

Capacitorを使用する場合、RevenueCatと既存の購入codeを組み合わせる計画がある場合は、RevenueCatのガイドを参照してください。 RevenueCatと既存の購入__CAPGO_KEEP_0__を使用する場合、Observer Modeのガイドを参照してください。.

📘

購入の設定

購入設定 .logIn()購入設定 ユーザーを識別する.

The SDK will automatically fetch the 下記はオファリングを取得する例です。オファリングを利用して、支払い画面を整理することができます。RevenueCatの「製品を表示する」ガイドを参照してください。 ▶️ 利用可能な製品を取得して表示する

ユーザーIDを使用した購入の設定 Capgoには、ユーザー認証システムがあれば、ユーザー識別子を設定することができます。設定時または後日、Capgoのcallを使用して、ユーザー識別子を提供することができます。RevenueCatの「ユーザー識別子を使用した購入の設定」ガイドを参照してください。 Identifying Users

The __CAPGO_KEEP_0__ will automatically fetch the

📘

configured Offerings

and retrieve the product information from Apple, Google, or Amazon. Thus, available products will already be loaded when customers launch your purchase screen. .logIn()RevenueCatのガイドを参照してください。 ユーザーを識別する.

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

Offeringsを取得する例を下に示します。 Offeringsを使用して、支払い画面を整理することができます。 さらに詳細とベストプラクティスについては、RevenueCatの 製品を表示する ガイドを参照してください。

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

Offerings 製品, 、または利用可能なパッケージ packages の

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

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

購入する

Capgo の SDK は、購入を容易にするためのシンプルな方法を提供します。SDK は、取得したオファリングからパッケージを取得し、対応するアプリ ストアでトランザクションを処理します。 purchase:package 取引は、取得したOfferingからパッケージを取り出し、対応するアプリストアで取引を処理します。

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
}

購入

購入 購入 最新のものを自動的にキャッシュする CustomerInfo 更新されるたびにキャッシュから取得するので、ほとんどの場合、このメソッドは高速に実行されます。

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

📘

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

購入のステータスを確認するだけでなく、購入が再生されるかどうか、ユーザーのクレジットカードに問題が発生しているかどうかなど、購入の詳細情報を多く取得できます。RevenueCatのガイドを参照してください。 購入のステータス 購入が再生されるかどうか、ユーザーのクレジットカードに問題が発生しているかどうかなど、購入の詳細情報を多く取得できます。

RevenueCatはユーザーが購入したコンテンツを再活性化できるように、ユーザーが購入したインアプリ購入を復元することを可能にします。 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)
  })

キャッシュする キャッシュから取得する 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:.

このメソッドは、SDK が更新を受け取ったときに常に発火します。 CustomerInfo の更新された getCustomerInfo(), purchase(package:), purchase(product:), or restorePurchases().

CustomerInfoの更新は pushed 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_KEEP_0__の製品を正しく設定するには、RevenueCatのエンタイトルメントガイドをご覧ください。 エンタイトルメントガイド.
• 自社のユーザーIDを使用したい場合は、 設定アプリユーザーID .
• RevenueCat から別のシステムに移行する場合は、RevenueCat のガイドを参照してください。 既存のサブスクリプションを移行する方法についてのRevenueCat ガイドを参照してください。.
• RevenueCat ガイドに従って、テストとデバッグを実行してください。 App Store Small Business Program の資格がある場合は、RevenueCat ガイドの "資格がある場合のアプリケーション方法" を参照してください。.
• RevenueCat に通知する方法についてのRevenueCat ガイドを参照してください。 アプリに必要なものがあります

If you need Live update in your app

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

__CAPGO_KEEP_0__

Capgo

Capgo から続けて、イン アプリ購入の capacitor

あなたが __CAPGO_KEEP_0__ を使用している場合 capacitor のイン アプリ購入を使用して支払いと購入を計画する __CAPGO_KEEP_0__ Pricing を __CAPGO_KEEP_0__ Pricing の製品フローと接続する 製品フローの Capgo Pricing に Capacitor製品のワークフローにおけるCapgo Pricingのために Payment system の実装の詳細 @__CAPGO_KEEP_0__/native-purchases を使用して実装の詳細 @capgo/native-purchases の実装の詳細 @capgo/ネイティブ購入 Getting Started の実装の詳細 Revenue Playbook Revenue Playbook Revenue Playbookの実装詳細については、