ネイティブ購入

@capgo/native-purchasesを使用

インアプリ購入の簡素化

インストール

bun add @capgo/native-purchases
bunx cap sync

このプラグインが提供するもの

• restorePurchases -ユーザーの前の購入情報を復元し、ユーザーのアプリIDを他のユーザーとリンクします。
• getAppTransaction -アプリのトランザクション情報を取得します。これにより、ユーザーがアプリをダウンロードしたときや購入したときの詳細が提供されます。
• isEntitledToOldBusinessModel -元のアプリバージョンと対象バージョンを比較して、ユーザーが以前のビジネスモデルから特定の機能にアクセスできるかどうかを判断します。
• getProducts -iOSのサブスクリプション価格条件を含むストア製品メタデータを読み込みます。
• purchaseProduct -選択した製品と請求プランの購入プロセスを開始します。

使用例

restorePurchases

ユーザーの前の購入を復元し、AppUser IDをユーザーが同じアプリを使用している場合にリンクします。

import { NativePurchases } from '@capgo/native-purchases';

await NativePurchases.restorePurchases();

getAppTransaction

App Transaction情報を取得します。これにより、ユーザーがアプリをダウンロードしたときや購入したときの詳細が提供されます。

import { NativePurchases } from '@capgo/native-purchases';

const { appTransaction } = await NativePurchases.getAppTransaction();

// Check if user downloaded before version 2.0.0 (when subscription was added)
if (compareVersions(appTransaction.originalAppVersion, '2.0.0') < 0) {
  // User gets free access - they downloaded before subscriptions
  grantFreeAccess();
}

isEntitledToOldBusinessModel

App Transactionから元のアプリバージョンと対象バージョンを比較して、ユーザーが以前のビジネスモデルから機能を利用できるかどうかを判断します。

import { NativePurchases } from '@capgo/native-purchases';

// Check if user downloaded before version 2.0.0/build 42 (when subscription was added)
const result = await NativePurchases.isEntitledToOldBusinessModel({
  targetVersion: '2.0.0',
  targetBuildNumber: '42'
});

if (result.isOlderVersion) {
  console.log(`User downloaded v${result.originalAppVersion}, granting free access`);
  grantFreeAccess();
}

purchaseProduct

指定された製品の購入プロセスを開始します。Androidのサブスクリプションの場合、Google PlayのベースプランIDを渡してください。 planIdentifierサポートされているiOSサブスクリプションの場合、月額課金の12か月のコミットメントを提供する場合、次の値を渡してください。 billingPlanType: 'monthly'.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

await NativePurchases.purchaseProduct({
  productIdentifier: 'com.example.premium.monthly',
  planIdentifier: 'monthly-plan',
  productType: PURCHASE_TYPE.SUBS,
});

サポートされているiOSバージョンでは、StoreKitは12か月のコミットメントを含む月額課金プランを表示できます。

サポートされているiOSバージョンでは、StoreKitは12か月のコミットメントを含む月額課金プランを表示できます。 pricingTermsサポートされているiOSバージョンでは、StoreKitは12か月のコミットメントを含む月額課金プランを表示できます。

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.example.premium.yearly'],
  productType: PURCHASE_TYPE.SUBS,
});

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.example.premium.yearly',
);
const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly price:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });

  console.log('Billing plan:', transaction.billingPlanType);
  console.log('Commitment ends:', transaction.commitmentInfo?.expirationDate);
}

サポートされているiOSバージョンでは、StoreKitは12か月のコミットメントを含む月額課金プランを表示できます。

• GitHub: https://github.com/Cap-go/capacitor-native-purchases/
• サポートされているiOSバージョンでは、StoreKitは12か月のコミットメントを含む月額課金プランを表示できます。
• iOS 月額コミットメントガイド: /docs/plugins/native-purchases/ios-monthly-commitment/

使用中の @capgo/native-purchases から続けてください。

Capacitor Native Purchases を使用している場合 Using @capgo/native-purchases Capacitor Native Purchases を Capacitor Native Purchases に接続してください。 @capgo/native-purchases for the implementation detail in @capgo/native-purchases, Getting Started の実装詳細については、Getting Started を参照してください。 __CAPGO_KEEP_0__ Pricing Capgo Pricing の製品ワークフローについては、Capgo Pricing を参照してください。 for the product workflow in Capgo Pricing, Payment system Paymentシステムの実装詳細について Revenue Playbook Revenue Playbookの実装詳細について