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

ペイウォールビルダーを使用しない場合は、.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
}

リクエストパラメータ：

パラメータ	必須/任意	説明
Product	必須	ペイウォールから取得した AdaptyPaywallProduct オブジェクト。

レスポンスパラメータ：

パラメータ	説明
Profile	リクエストが成功した場合、レスポンスにはこのオブジェクトが含まれます。AdaptyProfile オブジェクトは、アプリ内でのユーザーのアクセスレベル、サブスクリプション、非サブスクリプション購入に関する包括的な情報を提供します。 ユーザーが必要なアクセス権を持っているかどうかを確認するために、アクセスレベルのステータスをチェックしてください。

購入時のサブスクリプション変更

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

• App Store では、サブスクリプショングループ内でサブスクリプションが自動的に更新されます。ユーザーがあるグループのサブスクリプションを購入しつつ、別のグループのサブスクリプションをすでに持っている場合、両方のサブスクリプションが同時にアクティブになります。
• Google Play では、サブスクリプションは自動的に更新されません。以下に説明するように、モバイルアプリのコードで切り替えを管理する必要があります。

Android でサブスクリプションを別のものに切り替えるには、追加パラメータを指定して .makePurchase() メソッドを呼び出してください。

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

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

パラメータ	必須/任意	説明
subscriptionUpdateParams	必須	AdaptyAndroidSubscriptionUpdateParameters オブジェクト。

サブスクリプションと置き換えモードについては、Google デベロッパードキュメントを参照してください。

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

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

オファーコードについて

オファーコードを使うと、特定のユーザーに割引や無料トライアルを提供できます。自動的に適用される通常のオファーとは異なり、オファーコードはメールキャンペーン、SNS、印刷物など、アプリの外で配布します。ユーザーはApp Storeでコードを入力するか、引き換えURLを使うか、アプリ内ダイアログから利用できます。

オファーコードを設定するには、App Store Connectでサブスクリプションを開き、Offer Codes セクションに移動してください。オファーコードは3種類作成できます。

• Free — 指定した期間はサブスクリプションが無料になり、次の更新から通常価格になります。
• Pay as you go — 指定した期間、各請求サイクルに割引価格が適用され、その後は通常価格で更新されます。
• Pay up front — オファー期間全体に対して一括で割引価格を支払い、その後は通常価格で更新されます。

オファーコードをAdaptyに追加する必要はありません。Appleはオファー期間中のすべてのトランザクションにオファーコードカテゴリのタグを付与します。これには最初の引き換えとその後の割引更新がすべて含まれます。Adaptyはこのタグを検出し、各トランザクションをオファーカテゴリ offer_code として記録します。オファー期間が終了してサブスクリプションが通常価格で更新されると、タグは付与されなくなります。Adapty ダッシュボードのアナリティクスで Offer Code オファータイプによるフィルタリングが可能です。

収益の差異が生じた場合のトラブルシューティング

オファーコードのトランザクションが、割引価格ではなく通常価格でAdaptyに記録されている場合は、App Store Connectで以下を確認してください。

• オファーコードに、ユーザーが引き換え可能なすべての地域に対して正しい価格が設定されているか。
• ユーザーの特定の国や地域に対してオファー価格が設定されているか。Appleはトランザクションに地域価格を含めて送信します。その地域のオファー価格が設定されていない場合、Appleは通常価格を送信することがあります。

Adapty ダッシュボードで、Offer Code オファータイプと Offer Discount Type フィルターを使ってオファーコードのトランザクションをフィルタリング・確認できます。

レガシープロモコード（非推奨）

Appleは2026年3月にアプリ内課金向けのプロモコードを廃止しました。オファーコードはより多くの機能（適格性の設定、有効期限、四半期あたり最大100万コード）を備えた後継機能です。アプリ内課金にプロモコードを使用していた場合は、App Store Connectでオファーコードに移行してください。

レガシープロモコード（アプリのバージョンごとに最大100件）は、サブスクリプションへの無料アクセスを付与していました。オファーコードとは異なり、Appleはプロモコードのトランザクションに割引情報を含めず、レシートには通常価格が記載されていました。そのため、Adaptyはこれらのトランザクションを通常価格で記録し、Adaptyアナリティクスとレポートの間に収益の差異が生じていました。

本来は無料であるべきトランザクションが通常価格で記録されている履歴がある場合、それはレガシープロモコードによるものと考えられます。これらのコードは現在廃止されているため、正確な収益追跡のためにオファーコードに移行してください。

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

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),
);