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

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

ペイウォールビルダーを使用しない場合は、.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が自動的に完了させます。Appleの購入システム画面がすぐに表示され、Adaptyはそのトランザクションをほかのアプリ内課金と同様に処理します。

プロモートされたプロダクトにサブスクリプションオファーが含まれている場合、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
    });
}

SDK はまだこのメソッドにプロモート購入を渡しません。代わりに自動的に完了させるため、カスタム画面を先に表示するためにプロモート購入を遅らせることはできません。インターフェースで必須のため、メソッドは実装してください。空の本体でも有効な実装です。

プリペイドプランを管理する（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;
    }
});