adjust-icon

Android 購入認証移行ガイド

このガイドでは、 Adjustの購入認証SDKから、 SDK v5のビルトイン購入認証機能を移行する方法を説明します。SDK v5の購入認証ワークフローは、購入認証を行うための合理化されたアプローチです。

購入認証SDKは、3つの認証ステップに分けられます。

  1. 購入認証SDKを初期化します。
String yourAppToken = "{YourAppToken}";
String environment = ADJPConstants.ENVIRONMENT_SANDBOX;


ADJPConfig config = new ADJPConfig(yourAppToken, environment);


AdjustPurchase.init(config);
  1. 購入を検証します。
AdjustPurchase.verifyPurchase(purchase.getSku(),
                              purchase.getToken(),
                              purchase.getDeveloperPayload(),
                              new OnADJPVerificationFinished() {
    @Override
    public void onVerificationFinished(ADJPVerificationInfo info) {
        // process ADJPVerificationInfo
    }
});
  1. 検証の結果に応じて、 AdjustEventオブジェクトを設定し、Adjustに送信します。
AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.setRevenue(6.0, "EUR");
adjustEvent.setProductId("product-id");
adjustEvent.setPurchaseToken("purchase-token");
Adjust.trackEvent(adjustEvent);

SDK v5では、このワークフローは簡素化されています。Adjust.verifyAndTrackPlayStorePurchase()メソッドを使用すると、Adjustのサーバーにイベントを送信し、認証ステータスをコールバックで受け取ることができます。Adjustは、イベントと認証ステータスを自動的に記録します。

ガイド

購入認証SDKからSDK v5ビルトイン購入認証に移行するには、以下の手順に従ってください。

1. 購入認証SDKをアンインストールする

この機能を利用するには、まずAdjust購入認証SDKをアンインストールしてください。

2. 購入認証SDKコードを削除する

Adjustの購入認証SDKをアンインストールしたら、プロジェクトから全ての購入認証コードを削除する必要があります。

3. SDK v5購入認証へ移行する

既存の購入認証コードを削除したら、SDK v5に組み込まれた購入認証メソッドを使用してください。Adjust SDKで購入認証を行うには、次の2つの方法があります。

  1. 購入を示すAdjustEventオブジェクトを作成し、以下のプロパティを追加します。

    • productId （String）：購入に成功したアイテムのプロダクトID。
    • purchaseToken （String）：アプリ内購入が正常に完了したために生成された購入トークン。

  2. プロダクトIDと購入トークンを使用して、 AdjustPlayStorePurchaseオブジェクトを作成します。

イベントの記録と購入認証

購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。

  1. イベントトークンを使用してAdjustEventオブジェクトをインスタンス化し、以下のパラメーターを設定します。

    • productId ( String )：購入された商品のID。
    • purchaseToken ( String )：購入に関連付けられた購入トークン。

  2. 次の引数を使用してAdjust.verifyAndTrackPlayStorePurchaseメソッドを呼び出します：

    • event ( AdjustEvent )：インスタンス化されたイベントオブジェクト。
    • callback ( OnPurchaseVerificationFinishedListener )： AdjustPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

この例では、購入認証レスポンスがログdaemonに出力されます。

購入認証のみの場合

独立して購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。

  1. 以下の引数でAdjustPlayStorePurchaseをインスタンス化します：

    • productId ( String )：購入された商品のID。
    • purchaseToken ( String )：購入に関連付けられた購入トークン。

  2. 次の引数を使用してAdjust.verifyPlayStorePurchaseメソッドを呼び出します：

    • purchase ( AdjustPlayStorePurchase )：インスタンス化された購入オブジェクト
    • callback ( OnPurchaseVerificationFinishedListener )： AdjustPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

この例では、購入認証レスポンスがログdaemonに出力されます。