capacitor用インアプリ購入

このプラグインは、RevenueCat公式リポジトリに移行されました。詳しくは公式ドキュメントを参照してください。公式ドキュメント RevenueCatを使用せずに、よりシンプルなネイティブ__CAPGO_KEEP_0__を使用したい場合は、@__CAPGO_KEEP_0__/native-purchasesを使用できます。このプラグインは、StoreKitとGoogle Play Billingを使用して直接インアプリ購入とサブスクリプションを実装します。

API Purchasesは、__CAPGO_KEEP_1__フレームワーク用のプラグインで、iOSとAndroidでインアプリ購入をサポートします。複数のプラットフォームで一貫した__CAPGO_KEEP_2__を提供し、開発者がモバイルアプリにインアプリサブスクリプションと購入を実装するのを簡単にします。 capgo Purchasesプラグインの主な機能の1つは、RevenueCatと統合することです。RevenueCatは、インアプリサブスクリプションとインアプリ購入を提供するプラットフォームです。RevenueCatは、インアプリサブスクリプションと購入を実装するプロセスを簡素化し、複数のプラットフォームで一貫した__CAPGO_KEEP_1__を提供し、レシート検証やユーザーマネージメントなどのタスクを自動化します。 RevenueCatを使用すると、開発者はサブスクリプションを簡単に管理し、収益を追跡し、関連するタスクを実行できます。RevenueCatが提供する機能の例としては、以下のものがあります。

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__ Purchases
Capacitor
一貫したインターフェイス
[詳細分析] -スケーラビリティ

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.

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.

インストール

Be sure to use the latest version of Capacitor and the Capacitor Purchases plugin. You can check the latest version of Capacitor and the Capacitor Purchases plugin on the Capacitor website.

To install the Capacitor Purchases plugin, run the following command: npm i @capgo/capacitor-purchases Capgoのネイティブcodeにプラグインを追加する npx cap sync

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

Xcodeステップ1 次に Xcodeステップ2

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

This guide will walk you through how to get up and running with subscriptions and RevenueCat’s SDK with only a few lines of code.

新しいRevenueCatアカウントの登録ここ.

📘

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

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

組織/エンタープライズ

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

__CAPGO_KEEP_1__

▶️ プロジェクトを作成

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

RevenueCatステップ 1

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

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

プロジェクトの設定 > アプリ プロジェクトダッシュボードの左メニューで、追加するアプリのプラットフォームを選択 RevenueCatステップ 2

▶️ Project Settings > Apps

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

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

RevenueCat ステップ 3

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

📘

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

アプリを登録した後、RevenueCatは設定をプラットフォームサーバー通知を推奨しています。これらの通知は必須ではありませんが、ウェブホックと統合の配信時間を速めるだけでなく、サブスクライバーの更新時間を短縮します。

📘

Staging と Production アプリとユーザー

RevenueCat 自体は、Staging と Production に対して別々の環境を持ちません。それどころか、ユーザーの下位のトランザクションはサンドボックスとプロダクションで区別されています。

RevenueCat の任意のアプリは、両方のサンドボックスとプロダクションの購入をストアから行うことができます。また、Staging と Production に対して別々のアプリを持っている場合、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 > 契約、税金、銀行 このプロセスを完了する必要があります。購入をテストする前に. このプロセスを完了する必要があります。購入をテストする前に.

📘

__CAPGO_KEEP_0__をスキップしたいですか？

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

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

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

__CAPGO_KEEP_0__のインアプリ製品がApp Store Connect、Google Play Console、Amazon Appstore、またはStripeで設定されたら Configure Products and Entitlements in RevenueCat, Once your in-app products have been configured in, App Store ConnectGoogle Play Console Amazon Appstore、RevenueCat ダッシュボードにその設定をコピーする必要があります。RevenueCat は、プレミアム機能へのアクセスを制御する Entitlements システムと、顧客に提供する製品のセットを管理する Offerings を使用します。

Entitlements は、特定の製品を購入した後、顧客が「有資格」であるレベルです。 Offerings は、Paywall に表示するインアプリ製品を簡単に管理し、リモートで設定できる方法です。RevenueCat は、上記の機能を使用して、__CAPGO_KEEP_0__ を簡素化し、製品を変更することなくアプリの更新をリリースしなくても済むように推奨しています。 「設定」を参照してください。 utilizing these features to simplify your code and enable you to change products without releasing an app update.

RevenueCat のステップ 4 4. RevenueCat の Purchases __CAPGO_KEEP_0__ を使用します。 RevenueCat は、__CAPGO_KEEP_0__ を使用して、プラットフォームをまたいだ購入とサブスクリプションをシームレスに実装し、RevenueCat サーバーとトークンを同期します。

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

4. Using RevenueCat’s Purchases SDK

SDK

SDK __CAPGO_KEEP_0__ for guidance.

📘

SDK を使用して購入を設定する際は、パブリックキーをのみ使用してください。

SDK キーを取得するには、ダッシュボードの API キー プロジェクト設定 ダッシュボードの __CAPGO_KEEP_0__ キーを使用してください。

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

__CAPGO_KEEP_0__ SDKの設定詳細情報とベストプラクティスについてはこちらを参照してください。

__CAPGO_KEEP_0__を設定することを確認してください。購入 with your public SDK key only. You can read more about the different API keys available in 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_******'})
}

認証ガイド開発環境では、RevenueCatはより詳細なデバッグログを有効にすることを推奨しています。デバッグログについての詳細は、デバッグガイド

RevenueCatと既存の購入codeを併用する場合のガイドを参照してください。オブザーバーモード.

📘

ユーザーIDとともに購入を設定する方法についてはこちらの

If you have a user authentication system in your app, you can provide a user identifier at the time of configuration or at a later date with a call to .logIn(). To learn more, check out guide on.

The SDK will automatically fetch the 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. Below is an example of fetching Offerings. You can utilize Offerings to organize your paywall screen. See guide on

▶️ Fetch and Display Available Products

📘

▶️ Fetch and Display Available Products

Configuring Purchases with User IDs .logIn(). Apple, Google, Amazon の提供する商品情報を自動的に取得し、Apple, Google, Amazon の提供する商品情報を取得します。ユーザーを識別する.

The SDK will automatically fetch the 設定された商品 Apple, Google, Amazon の提供する商品情報を自動的に取得し、Apple, Google, Amazon の提供する商品情報を取得します。

顧客が購入画面を起動すると、すでに利用可能な商品がロードされます。 Offerings を取得する例を示します。Offerings を使用して、支払い壁画面を整理できます。RevenueCat のガイド "Displaying Products" を参照してください。商品を表示する

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

RevenueCat のガイド "Displaying Products" を参照してください。 Offerings の商品, Offerings の商品Offerings の商品パッケージは空です。これは、各ストアの設定問題のためです。 App Store Connect の場合、最も一般的な原因は、更新されていない 'Paid Applications Agreement' または、少なくとも 'Ready To Submit' の状態にある製品が存在しないことです。 GooglePlay の場合、通常、クローズドトラックにアプリが公開されていないか、有効なテストユーザーが追加されていない場合に発生します。

購入のトラブルシューティングについての詳細は、RevenueCat のヘルプセンターで確認できます。

▶️ 購入を行う __CAPGO_KEEP_0__ は、購入を容易にするためのシンプルなメソッドを提供します。.

__CAPGO_KEEP_0__ は、取得したオファリングからパッケージを取得し、対応するアプリストアでトランザクションを処理します。

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

code 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は、ユーザーが購入アクセスを失う場合 (例: アプリをアンインストール/再インストールしたり、アカウント情報を失ったりするなど) に復元メカニズムが必要であることを要求しています。

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

If two different App User IDs __CAPGO_KEEP_0__から同じ基盤ストアアカウント (Apple, Google, またはAmazonアカウント) からトランザクションを復元する場合、異なるApp User IDが2つある場合。 RevenueCatは、2つのApp User ID間でエイリアスを作成し、以降は両方を同じユーザーとしてカウントする可能性があります。RevenueCatのガイド「Restoring Purchases」を参照してください。 Restoring Purchases for more information on the different configurable restore behaviors.

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_KEEP_0__は、どのプラットフォームでも平滑に動作するため、ユーザーの購入情報の変更は、さまざまなソースから来る可能性があります。ユーザーの購入情報の変更に応じて、任意の変更に対応することができます。 purchases:receivedUpdated:.

This method will fire whenever the SDK receives an updated CustomerInfo __CAPGO_KEEP_0__は、購入情報の更新を取得するために、calls to getCustomerInfo(), purchase(package:), purchase(product:)、または restorePurchases().

を呼び出すたびに、更新されたCustomerInfoオブジェクトを取得します。 CustomerInfoの更新は RevenueCatのバックエンドからアプリにプッシュされた更新は、上記のように述べられているように、RevenueCatへのアウトバウンドネットワークリクエストのみで行うことができます。

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

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

👍

おめでとう!

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

サンプルアプリ

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

サンプルを表示

Capacitorを使用したサンプルアプリとVue.jsを使用したサンプルアプリを公開する予定です。

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

次のステップ

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

App Store Small Business Program の資格がある場合は、RevenueCat に

アプリにライブ更新が必要な場合は

ここ 👇 から参加してください。

Capgo

Keep going from in app purchases for capacitor

If you are using in app purchases for capacitor to plan payments and purchases, connect it with Capgo for the product workflow in Capgo Pricing, Payment system for the implementation detail in Payment system, @capgo/native-purchases for the implementation detail in @capgo/native-purchases, Getting Started for the implementation detail in Getting Started, and Revenue Playbook for the implementation detail in Revenue Playbook.

capacitorアプリ内課金