adjust-icon

iOS 收入验证迁移指南

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

使用收入验证 SDK 时,验证分为三个步骤:

  1. 初始化收入验证 SDK。
#import "AdjustPurchase.h"
// or #import <AdjustPurchaseSdk/AdjustPurchase.h>
NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJPEnvironmentSandbox;
ADJPConfig *config = [[ADJPConfig alloc] initWithAppToken:yourAppToken andEnvironment:environment];
[AdjustPurchase init:config];
  1. 验证您的购买。
[AdjustPurchase verifyPurchase:receipt
forTransaction:transaction
productId:@"product-id"
withResponseBlock:^(ADJPVerificationInfo *info) {
// process ADJPVerificationInfo object
}];
  1. 根据验证结果配置AdjustEvent对象并将其发送至 Adjust。
NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
NSData *receipt = [NSData dataWithContentsOfURL:receiptURL];
ADJEvent *event = [ADJEvent eventWithEventToken::@"your-event-token"];
[event setRevenue:6.0 currency:@"EUR"];
[event setTransactionId:@"transaction-id"];
[event setProductId:@"product-id"];
[event setReceipt:receipt];
[Adjust trackEvent:event];

在 SDK v5 中,此工作流程得到了简化。[Adjust verifyAndTrackAppStorePurchase]方法允许您向 Adjust 服务器发送事件并通过回传接收验证状态。Adjust 会自动记录事件和验证状态。

指南

按照本指南中的步骤从收入验证 SDK 迁移至 SDK v5 内置收入验证功能。

1. 卸载收入验证 SDK

要开始迁移,请卸载 Adjust 收入验证 SDK 。

2. 移除收入验证 SDK 代码

卸载 Adjust 收入验证 SDK 后,您必须从项目中移除所有收入验证代码。

3. 迁移至 SDK v5 收入验证功能

移除现有收入验证代码后,您就转而使用 SDK v5 的内置收入验证方法了。通过 Adjust SDK 验证购买的方法有两种:

  1. 创建代表购买的ADJEvent对象并添加以下属性:

    • productId (NSString):已被成功售出货品的产品识别码。
    • transactionId ( NSString ):要验证的交易 ID。
  2. 使用您的产品 ID、交易 ID 和收据创建一个ADJAppStorePurchase对象。

记录事件并验证购买

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

  1. 使用您的事件识别码实例化ADJEvent对象并设置以下参数:

    • productId (NSString):已被成功售出货品的产品识别码。
    • transactionId ( NSString ):要验证的交易 ID。
  2. 请使用下列参数调用 Adjust.verifyAndTrackPlayStorePurchase 方法:

    • event ( ADJEvent ): 您的实例化事件对象。
    • callback ( ADJVerificationResultBlock ):接收ADJPurchaseVerificationResult对象作为参数的委托回传函数。

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

仅验证购买

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

  1. 使用以下参数实例化ADJAppStorePurchase

    • productId (NSString):已被成功售出货品的产品识别码。
    • transactionId ( NSString ):要验证的交易 ID。
  2. 请使用下列参数调用 Adjust.verifyAppStorePurchase 方法:

    • purchase ( ADJAppStorePurchase ): 实例化的购买对象。
    • callback ( ADJVerificationResultBlock ):接收ADJPurchaseVerificationResult对象作为参数的委托回传函数。

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