安卓收入验证迁移指南

本指南将向您介绍如何从 Adjust 收入验证 SDK 迁移至 SDK v5 的内置收入验证功能。SDK v5 收入验证流程是一种更简化的收入验证方法。

使用收入验证 SDK 时，验证分为三个步骤：

初始化收入验证 SDK。

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

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

6
AdjustPurchase.init(config);

验证您的购买。

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
});

根据验证结果配置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 验证购买的方法有两种：

创建代表购买的AdjustEvent对象并添加以下属性：
- productId (String)：已被成功售出货品的产品识别码。
- purchaseToken (String)：已成功完成的应用内购买的购买识别码。
使用您的产品 ID 和购买识别码创建AdjustPlayStorePurchase对象。

记录事件并验证购买

如需发送收入事件进行验证并监听收入验证状态，请按照下列步骤操作：

使用您的事件识别码实例化AdjustEvent对象并设置以下参数：
- productId ( String )：已购买产品的 ID。
- purchaseToken ( String ): 与购买关联的购买识别码。
请使用下列参数调用 Adjust.verifyAndTrackPlayStorePurchase 方法：
- event ( AdjustEvent ): 您的实例化事件对象。
- callback ( OnPurchaseVerificationFinishedListener )：接收AdjustPurchaseVerificationResult对象作为参数的委托回传函数。

在此示例中，收入验证响应被输出至日志后台进程。

Kotlin
Java

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
});

仅验证购买

要发送单独购买并监听收入验证状态，请按照下列步骤操作：

使用以下参数实例化AdjustPlayStorePurchase：
- productId ( String )：已购买产品的 ID。
- purchaseToken ( String ): 与购买关联的购买识别码。
请使用下列参数调用 Adjust.verifyPlayStorePurchase 方法：
- purchase ( AdjustPlayStorePurchase ): 实例化的购买对象。
- callback ( OnPurchaseVerificationFinishedListener )：接收AdjustPurchaseVerificationResult对象作为参数的委托回传函数。

在此示例中，收入验证响应被输出至日志后台进程。

Kotlin
Java

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
});