Unity 收入验证迁移指南

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

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

初始化收入验证 SDK。

1
var adjustPVConfig = new ADJPConfig(
2
    adjustAppToken,
3
    ADJPEnvironment.Production
4
);
5

6
adjustPVConfig.SetLogLevel(ADJPLogLevel.Info);
7
new GameObject("AdjustPurchase").AddComponent<adjustpurchase>();
8

9
AdjustPurchase.Init(adjustPVConfig);

验证您的购买。

1
// purchase verification request on iOS
2
AdjustPurchase.VerifyPurchaseiOS("{Receipt}", "{TransactionID}", "{ProductId}", VerificationInfoDelegate);
3

4
// purchase verification request on Android
5
AdjustPurchase.VerifyPurchaseAndroid("{ItemSKU}", "{ItemToken}", "{DeveloperPayload}", VerificationInfoDelegate);
6

7
// ...
8

9
private void VerificationInfoDelegate(ADJPVerificationInfo verificationInfo)
10
{
11
    Debug.Log("Verification info callback!");
12
    Debug.Log("Message: " + verificationInfo.Message);
13
    Debug.Log("Status code: " + verificationInfo.StatusCode);
14
    Debug.Log("Verification state: " + verificationInfo.VerificationState);
15
}

根据验证结果配置AdjustEvent对象并将其发送至 Adjust。

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setRevenue(6.0, "EUR");
3
adjustEvent.setProductId("product-id");
4
adjustEvent.setTransactionId("transaction-id");
5
adjustEvent.setPurchaseToken("purchase-token"); // Android only
6
adjustEvent.setReceipt("receipt"); // iOS only
7
Adjust.trackEvent(adjustEvent);

在 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 验证购买的方法有两种：

创建代表购买的AdjustEvent对象并为目标商店配置购买属性。
创建代表购买的AdjustAppStorePurchase (Apple App Store) 或AdjustPlayStorePurchase (Google Play 商店) 对象。

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

使用您的事件识别码实例化AdjustEvent对象并设置以下参数：
- ProductId (string)：已被成功售出货品的产品识别码。
- TransactionId ( string )：要验证的交易 ID。
请使用下列参数调用 Adjust.VerifyAndTrackPlayStorePurchase 方法：
- event ( AdjustEvent ): 您的实例化事件对象。
- callback ( Action )：接收AdjustPurchaseVerificationResult对象作为参数的委托回传函数。

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

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.TransactionId = "transaction-id";
4
adjustEvent.ProductId = "product-id";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

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

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

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

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.ProductId = "product-id";
4
adjustEvent.PurchaseToken = "purchase-token";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

仅验证购买

App Store
Google Play

如需发送独立的 App Store 购买并监听收入验证状态，请按照下列步骤操作：

使用以下参数实例化AdjustAppStorePurchase对象：
- TransactionId ( string )：要验证的交易 ID。
- ProductId (string)：已被成功售出货品的产品识别码。
请使用下列参数调用 Adjust.VerifyAppStorePurchase 方法：
- purchase ( AdjustAppStorePurchase ): 您的实例化事件对象。
- callback ( Action )：接收AdjustPurchaseVerificationResult对象作为参数的委托回传函数。

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

1
AdjustAppStorePurchase purchase = new AdjustAppStorePurchase("transaction-id", "product-id");
2
Adjust.VerifyAppStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});

如需发送独立的 Play 商店购买并监听收入验证状态，请按照下列步骤操作：

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

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

1
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");
2
Adjust.VerifyPlayStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});