Android購入認証移行ガイド

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

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

1. 購入認証SDKを初期化します。

1
String yourAppToken = "{YourAppToken}";
2
String environment = ADJPConstants.ENVIRONMENT_SANDBOX;
3

4
ADJPConfig config = new ADJPConfig(yourAppToken, environment);
5

6
AdjustPurchase.init(config);

2. 購入を検証します。

1
AdjustPurchase.verifyPurchase(purchase.getSku(),
2
                              purchase.getToken(),
3
                              purchase.getDeveloperPayload(),
4
                              new OnADJPVerificationFinished() {
5
    @Override
6
    public void onVerificationFinished(ADJPVerificationInfo info) {
7
        // process ADJPVerificationInfo
8
    }
9
});

3. 検証の結果に応じて、 AdjustEventオブジェクトを設定し、Adjustに送信します。

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setRevenue(6.0, "EUR");
3
adjustEvent.setProductId("product-id");
4
adjustEvent.setPurchaseToken("purchase-token");
5
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
val adjustEvent = AdjustEvent("abc123")
2
adjustEvent.setRevenue(6.0, "EUR")
3
adjustEvent.productId = "product-id"
4
adjustEvent.purchaseToken = "purchase-token"
5
Adjust.trackEvent(adjustEvent)
6

7
Adjust.verifyAndTrackPlayStorePurchase(adjustEvent) {
8
    result -> Log.d("Verification status: ", result.verificationStatus)
9
    Log.d("Code: ", result.code)
10
    Log.d("Message: ", result.message)
11
}

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setRevenue(6.0, "EUR");
3
adjustEvent.setProductId("product-id");
4
adjustEvent.setPurchaseToken("purchase-token");
5
Adjust.trackEvent(adjustEvent);
6

7
Adjust.verifyAndTrackPlayStorePurchase(adjustEvent, new OnPurchaseVerificationFinishedListener() {
8
    @Override
9
    public void onFinished(AdjustPurchaseVerificationResult result) {
10
       Log.d("Verification status: ", result.verificationStatus);
11
       Log.d("Code: ", result.code);
12
       Log.d("Message: ", result.message);
13
    }
14
});

購入認証のみの場合

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

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

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

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

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

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

1
val purchase = AdjustPlayStorePurchase("product-id", "purchase-token")
2
Adjust.verifyPlayStorePurchase(purchase) {
3
    result -> Log.d("Verification status: ", result.verificationStatus)
4
    Log.d("Code: ", result.code)
5
    Log.d("Message: ", result.message)
6
}

1
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");
2
Adjust.verifyPlayStorePurchase(purchase, new OnPurchaseVerificationFinishedListener() {
3
    @Override
4
    public void onFinished(AdjustPurchaseVerificationResult result) {
5
       Log.d("Verification status: ", result.verificationStatus);
6
       Log.d("Code: ", result.code);
7
       Log.d("Message: ", result.message);
8
    }
9
});