このガイドでは、 Adjustの購入認証SDKから、SDK v5のビルトイン購入認証に移行する方法を説明します。SDK v5の購入認証ワークフローは、購入認証を行うための合理化されたアプローチです。
購入認証SDKは、3つの認証ステップに分けられます。
-
購入認証SDKを初期化します。
-
購入を検証します。
-
検証の結果に応じて、
AdjustEvent
オブジェクトを設定し、Adjustに送信します。
SDK v5では、このワークフローは簡素化されています。Adjust.verifyAndTrackAppStorePurchase()
とAdjust.verifyAndTrackPlayStorePurchase()
メソッドを使用すると、Adjustのサーバーにイベントを送信し、認証ステータスをコールバックで受け取ることができます。Adjustは、イベントと認証ステータスを自動的に記録します。
ガイド
購入認証SDKからSDK v5のビルトイン購入認証機能に移行するには、このガイドをご覧ください。
1. 購入認証SDKをアンインストールする
この機能を利用するには、まずはAdjust購入認証SDKをアンインストールしてください。
2. 購入認証SDKコードを削除する
Adjustの購入認証SDKをアンインストールしたら、プロジェクトから全ての購入認証コードを削除する必要があります。
3. SDK v5の購入認証に移行する
既存の購入認証コードを削除したら、SDK v5に組み込まれた購入認証メソッドを使用してください。Adjust SDKで購入認証を行うには、次の2つの方法があります。
- 購入を表す
AdjustEvent
オブジェクトを作成し、ターゲットストアの購入プロパティを設定します。 - 購入を表す
AdjustAppStorePurchase
(Apple App Store)またはAdjustPlayStorePurchase
(Google Play ストア)オブジェクトを作成します。
イベントを記録し購入を認証する
購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。
-
イベントトークンを使用して
AdjustEvent
オブジェクトをインスタンス化し、以下のパラメーターを設定します。ProductId
(string
):購入に成功したアイテムのプロダクトID。TransactionId
(string
):認証したいトランザクションのID。
-
次の引数を使用して
Adjust.VerifyAndTrackPlayStorePurchase
メソッドを呼び出します:event
(AdjustEvent
):インスタンス化されたイベントオブジェクト。callback
(Action
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。
-
イベントトークンを使用して
AdjustEvent
オブジェクトをインスタンス化し、以下のパラメーターを設定します。ProductId
(String
):購入された商品のID。PurchaseToken
(String
):購入に関連付けられた購入トークン。
-
次の引数を使用して
Adjust.VerifyAndTrackPlayStorePurchase
メソッドを呼び出します:ajustEvent
(AdjustEvent
):インスタンス化されたイベントオブジェクト。callback
(Action
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
購入認証のみの場合
独立してApp Storeの購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。
-
以下の引数で
AdjustAppStorePurchase
をインスタンス化します:ProductId
(string
):購入に成功したアイテムのプロダクトID。TransactionId
(string
):認証したいトランザクションのID。
-
次の引数を使用して
Adjust.VerifyAppStorePurchase
メソッドを呼び出します:purchase
(AdjustAppStorePurchase
):インスタンス化されたイベントオブジェクト。callback
(Action
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
独立してPlay Storeの購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。
-
以下の引数で
AdjustPlayStorePurchase
をインスタンス化します:ProductId
(string
):購入された商品のID。PurchaseToken
(string
):購入に関連付けられた購入トークン。
-
次の引数を使用して
Adjust.VerifyPlayStorePurchase
メソッドを呼び出します:purchase
(AdjustPlayStorePurchase
):インスタンス化された購入オブジェクトverificationResultCallback
(Action
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。