iOS購入認証移行ガイド

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

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

購入認証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で購入認証を行うには、次の2つの方法があります。

購入を示すADJEventオブジェクトを作成し、以下のプロパティを追加します。
- productId （NSString）：購入に成功したアイテムのプロダクトID。
- transactionId ( NSString )：認証したいトランザクションのID。
プロダクトID、トランザクションID、受領証でADJAppStorePurchaseオブジェクトを作成します。

イベントを記録し購入を認証する

購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。

イベントトークンを使用してADJEventオブジェクトをインスタンス化し、以下のパラメーターを設定します。
- productId （NSString）：購入に成功したアイテムのプロダクトID。
- transactionId ( NSString )：認証したいトランザクションのID。
次の引数を使用してAdjust.verifyAndTrackPlayStorePurchaseメソッドを呼び出します：
- event ( ADJEvent )：インスタンス化されたイベントオブジェクト。
- callback ( ADJVerificationResultBlock )： ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

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

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）：購入に成功したアイテムのプロダクトID。
次の引数を使用してAdjust.verifyAppStorePurchaseメソッドを呼び出します：
- purchase ( ADJAppStorePurchase )：インスタンス化された購入オブジェクト
- callback ( ADJVerificationResultBlock )： ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

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

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