iOS 收入验证迁移指南

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

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

初始化收入验证 SDK。

1
#import "AdjustPurchase.h"
2
// or #import <AdjustPurchaseSdk/AdjustPurchase.h>
3

4
NSString *yourAppToken = @"{YourAppToken}";
5
NSString *environment = ADJPEnvironmentSandbox;
6

7
ADJPConfig *config = [[ADJPConfig alloc] initWithAppToken:yourAppToken andEnvironment:environment];
8
[AdjustPurchase init:config];

验证您的购买。

1
[AdjustPurchase verifyPurchase:receipt
2
                forTransaction:transaction
3
                     productId:@"product-id"
4
             withResponseBlock:^(ADJPVerificationInfo *info) {
5
    // process ADJPVerificationInfo object
6
}];

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

1
NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
2
NSData *receipt = [NSData dataWithContentsOfURL:receiptURL];
3
ADJEvent *event = [ADJEvent eventWithEventToken::@"your-event-token"];
4
[event setRevenue:6.0 currency:@"EUR"];
5
[event setTransactionId:@"transaction-id"];
6
[event setProductId:@"product-id"];
7
[event setReceipt:receipt];
8
[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 验证购买的方法有两种：

创建代表购买的ADJEvent对象并添加以下属性：
- productId (NSString)：已被成功售出货品的产品识别码。
- transactionId ( NSString )：要验证的交易 ID。
使用您的产品 ID、交易 ID 和收据创建一个ADJAppStorePurchase对象。

记录事件并验证购买

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

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

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

Swift
Objective-C

1
guard let event = ADJEvent(eventToken: "g3mfiw") else { return }
2
event.setProductId("product-id")
3
event.setTransactionId("transaction-id")
4

5
Adjust.verifyAndTrackAppStorePurchase(event) { verificationResult in
6
   print("Verification status: \(verificationResult.verificationStatus)")
7
   print("Code: \(verificationResult.code)")
8
   print("Message: \(verificationResult.message)")
9
}

1
ADJEvent *event = [[ADJEvent alloc] initWithEventToken:yourEventToken];
2
[event setProductId:@"product-id"];
3
[event setTransactionId:@"transaction-id"];
4

5
[Adjust verifyAndTrackAppStorePurchase:event withCompletionHandler:^(ADJPurchaseVerificationResult * _Nonnull verificationResult) {
6
      NSLog(@"Verification status: %@", verificationResult.verificationStatus);
7
      NSLog(@"Code: %d", verificationResult.code);
8
      NSLog(@"Message: %@", verificationResult.message);
9
}];

仅验证购买

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

使用以下参数实例化ADJAppStorePurchase：
- transactionId ( NSString )：要验证的交易 ID。
- productId (NSString)：已被成功售出货品的产品识别码。
请使用下列参数调用 Adjust.verifyAppStorePurchase 方法：
- purchase ( ADJAppStorePurchase ): 实例化的购买对象。
- callback ( ADJVerificationResultBlock )：接收ADJPurchaseVerificationResult对象作为参数的委托回传函数。

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

Swift
Objective-C

1
 guard let appStorePurchase = ADJAppStorePurchase(transactionId: yourTransactionId,
2
                                                         productId: yourProductId) else { return }
3

4
Adjust.verifyAppStorePurchase(appStorePurchase) { verificationResult in
5
   print("Verification status: \(verificationResult.verificationStatus)")
6
   print("Code: \(verificationResult.code)")
7
   print("Message: \(verificationResult.message)")
8
}

1
ADJAppStorePurchase *appStorePurchase = [[ADJAppStorePurchase alloc]
2
                                             initWithTransactionId:yourTranscationId
3
                                             productId:yourProductId];
4

5
[Adjust verifyAppStorePurchase:appStorePurchase withCompletionHandler:^(ADJPurchaseVerificationResult * _Nonnull verificationResult) {
6
     NSLog(@"Verification status: %@", verificationResult.verificationStatus);
7
     NSLog(@"Code: %d", verificationResult.code);
8
     NSLog(@"Message: %@", verificationResult.message);
9
}];