プロダクトIDと購入トークンの詳細については、Google Playの請求システムのドキュメントをご覧ください。
購入認証を有効にしている場合、Adjust SDKを使用して購入認証をリクエストできます。Adjust SDKで購入認証を行うには、次の2つの方法があります。
-
購入を示す
AdjustEvent
オブジェクトを作成し、以下のプロパティを追加します。productId
(String
):購入に成功したアイテムのプロダクトID。purchaseToken
(String
):アプリ内購入が正常に完了したために生成された購入トークン。
-
プロダクトIDと購入トークンを使用して、
AdjustPlayStorePurchase
オブジェクトを作成します。
収益イベントを使用してAdjustで購入を計測する場合は、 AdjustEvent
クラスを使用してください。購入のみを確認したいが、イベントと関連付けない場合は、 AdjustPlayStorePurchase
クラスを使用してください。
Adjust SDKで購入情報を送信すると、Adjustは以下を実行します。
- Google Playに情報を送信し、ステータスのレスポンスを待ちます。
- ステータスレスポンスをAdjust SDKに転送します。
コールバックを使用することで、購入認証ステータスにアクセスできます。結果は、以下のプロパティを含むAdjustPurchaseVerificationResult
オブジェクトとして返されます。
verificationStatus
(String
): 購入のステータス。code
(int
):購入のステータスコード。message
(String
):Google Playから返される全てのメッセージ。
イベントの記録と購入認証
購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。
-
イベントトークンを使用して
AdjustEvent
オブジェクトをインスタンス化し、以下のパラメーターを設定します。productId
(String
):購入された商品のID。purchaseToken
(String
):購入に関連付けられた購入トークン。
-
次の引数を使用して
Adjust.verifyAndTrackPlayStorePurchase
メソッドを呼び出します:event
(AdjustEvent
):インスタンス化されたイベントオブジェクト。callback
(OnPurchaseVerificationFinishedListener
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
購入認証のみの場合
独立して購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。
-
以下の引数で
AdjustPlayStorePurchase
をインスタンス化します:productId
(String
):購入された商品のID。purchaseToken
(String
):購入に関連付けられた購入トークン。
-
次の引数を使用して
Adjust.verifyPlayStorePurchase
メソッドを呼び出します:purchase
(AdjustPlayStorePurchase
):インスタンス化された購入オブジェクトcallback
(OnPurchaseVerificationFinishedListener
):AdjustPurchaseVerificationResult
オブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
購入認証を有効にしている場合は、購入イベントと共に追加情報を送信して、購入イベントを検証する必要があります。Adjustのサーバーがこの情報をAdjustEvent
オブジェクトで受け取ると、情報をGoogleに転送して購入を確認します。
購入を検証するには、イベントトークンを使用してAdjustEvent
オブジェクトをインスタンス化し、以下のプロパティを設定してください。
productId
(String
):購入に成功したアイテムのプロダクトIDpurchaseToken
(String
):アプリ内購入が正常に完了したために生成された購入トークン。
AdjustEvent
クラスの詳細については、イベント情報の送信をご覧ください。