Unity SDKでモバイルアプリ内で購入を行う

モバイルアプリ内でペイウォールを表示することは、ユーザーにプレミアムコンテンツやサービスへのアクセスを提供するための重要なステップです。ただし、ペイウォールを表示するだけで購入が完結するのは、Adapty が画面をレンダリングする場合、つまりフローまたは旧ペイウォールビルダーで作成したペイウォールを使用する場合に限られます。

独自のコードで画面をレンダリングする場合は、.makePurchase() という別のメソッドを使用して購入を完了し、目的のコンテンツをアンロックする必要があります。このメソッドは、ユーザーがペイウォールを通じてトランザクションを進めるための入口となります。

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

初期設定をすべてのステップを漏らさず完了していることを確認してください。設定が完了していないと、購入の検証ができません。

購入を実行する

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

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

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

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

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

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

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

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

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

サブスクリプションと置き換えモードの詳細については、Google Developerのドキュメントをご参照ください。

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

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

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

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

App Storeのプロモーションアプリ内課金

ユーザーがApp Storeのプロダクトページから購入を開始すると、SDKはOnReceivePromotedPurchaseを通じてプロダクトを渡し、待機します。購入を完了するのはあなたのアプリ次第です。Adapty.MakePromotedPurchaseにプロダクトを渡してください。タイミングを制御できるため、購入が始まる前に独自の画面を表示することも可能です。

プロモーション対象のプロダクトにサブスクリプションオファーが設定されている場合、SDKは購入時に自動的にそのオファーを適用します。オファーはApp Storeの購入インテントから読み取られ、iOS 18.0以降で利用できます。iOS 16.4〜17.xでは、購入は通常価格で処理されます。

IAdaptyEventListener には、必須メソッド OnReceivePromotedPurchase(AdaptyPromotedProduct) が含まれており、受け取った購入を完了するための Adapty.MakePromotedPurchase と組み合わせて使用します。

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

プリペイドプランを管理する（Android）

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

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});