Flutter SDKでモバイルアプリのアプリ内課金を行う

モバイルアプリ内でペイウォールを表示することは、ユーザーにプレミアムコンテンツやサービスへのアクセスを提供するうえで欠かせないステップです。ただし、ペイウォールビルダーを使ってペイウォールをカスタマイズしている場合に限り、ペイウォールを表示するだけで購入をサポートできます。

ペイウォールビルダーを使用しない場合は、購入を完了してコンテンツのロックを解除するために、.makePurchase() という別のメソッドを呼び出す必要があります。このメソッドは、ユーザーがペイウォールを通じて希望するトランザクションを進めるための入り口となります。

ペイウォールに購入しようとしているプロダクトのアクティブなプロモーションオファーがある場合、Adapty は購入時に自動的にそれを適用します。

初期設定をひとつも手順をスキップせずに完了していることを確認してください。初期設定が済んでいないと、購入を検証できません。

購入を行う

try {
  final purchaseResult = await Adapty().makePurchase(product: product);
    switch (purchaseResult) {
      case AdaptyPurchaseResultSuccess(profile: final profile):
        if (profile.accessLevels['premium']?.isActive ?? false) {
          // Grant access to the paid features
        }
        break;
      case AdaptyPurchaseResultPending():
        break;
      case AdaptyPurchaseResultUserCancelled():
        break;
      default:
        break;
    }
} on AdaptyError catch (adaptyError) {
    // Handle the error
} catch (e) {
    // Handle the error
}

リクエストパラメーター：

レスポンスパラメーター：

購入時にサブスクリプションを変更する

ユーザーが現在のサブスクリプションを更新するのではなく、新しいサブスクリプションを選択した場合の動作は、アプリストアによって異なります。

• App Store の場合、サブスクリプションはサブスクリプショングループ内で自動的に更新されます。ユーザーがすでに別のグループのサブスクリプションを持っている状態で、あるグループのサブスクリプションを購入した場合、両方のサブスクリプションが同時にアクティブになります。
• Google Play の場合、サブスクリプションは自動的に更新されません。以下で説明するように、モバイルアプリのコードで切り替えを管理する必要があります。 Androidでサブスクリプションを別のものに切り替えるには、追加パラメータを指定して .makePurchase() メソッドを呼び出します。

try {
  final subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    'OLD_PRODUCT_ID',
    AdaptyAndroidSubscriptionUpdateReplacementMode.immediateWithTimeProration,
  );

  final result = await Adapty().makePurchase(
    product: product,
    parameters: AdaptyPurchaseParameters(
      subscriptionUpdateParams: subscriptionUpdateParams,
    ),
  );
  
  // successful cross-grade
} on AdaptyError catch (adaptyError) {
  // Handle the error
} catch (e) {
  // Handle the error
}

追加のリクエストパラメーター:

• 置き換えモードについて
• 置き換えモードに関するGoogleの推奨事項
• 置き換えモード CHARGE_PRORATED_PRICE。注意: このメソッドはサブスクリプションのアップグレードにのみ使用できます。ダウングレードはサポートされていません。
• 置き換えモード DEFERRED。注意: 実際のサブスクリプション変更は、現在のサブスクリプションの請求期間が終了したときにのみ行われます。

iOS でオファーコードを使用する

アプリ内でコード引き換えシートを表示するには：

try {
  await Adapty().presentCodeRedemptionSheet();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

プリペイドプランの管理（Android）

アプリのユーザーがプリペイドプラン（例：数ヶ月分の非更新型サブスクリプションを一括購入）を利用できる場合、プリペイドプランの保留中のトランザクションを有効にすることができます。

await Adapty().activate(
  configuration: AdaptyConfiguration(apiKey: 'YOUR_PUBLIC_SDK_KEY')
    ..withGoogleEnablePendingPrepaidPlans(true),
);