購入認証を有効にしている場合、Adjust SDKを使用して購入認証をリクエストできます。
購入認証を使用するには、まずAdjustで購入認証を行うためにアプリを設定してください。手順については、アプリの購入認証の設定を参照してください。
Adjust SDKで購入認証を行うには、次の2つの方法があります。
-
購入を示す
ADJEventオブジェクトを作成し、以下のプロパティを追加します。transactionId(NSString)：認証したいトランザクションのID。productId（NSString）：購入に成功したアイテムのプロダクトID。
-
トランザクションIDとプロダクトIDを使用して
ADJAppStorePurchaseオブジェクトを作成します。
収益イベントを使用してAdjustで購入を計測する場合は、 ADJEventクラスを使用してください。購入のみを確認したいが、イベントと関連付けない場合は、 ADJAppStorePurchaseクラスを使用してください。
Adjust SDKで購入情報を送信すると、Adjustは以下を実行します。
- 情報をApp Storeに送信し、ステータスのレスポンスを待ちます。
- ステータスレスポンスをAdjust SDKに転送します。
コールバックを使用することで、購入認証ステータスにアクセスできます。結果は、以下のプロパティを含むADJPurchaseVerificationResultオブジェクトとして返されます。
verificationStatus(NSString): 購入のステータス。code(int)：購入のステータスコード。message(NSString)：App Storeから返される全てのメッセージ。
イベントの記録と購入認証
- (void)verifyAndTrackAppStorePurchase:(nonnull ADJEvent *)event withCompletionHandler:(nonnull ADJVerificationResultBlock)completion;購入認証の目的で収益イベントを送信し、購入認証ステータスを受け取るには、以下の手順に従ってください。
-
イベントトークンを使用して
ADJEventオブジェクトをインスタンス化し、以下のパラメーターを設定します。transactionId(NSString)：認証したいトランザクションのID。productId（NSString）：購入に成功したアイテムのプロダクトID。
-
次の引数を使用して
Adjust.verifyAndTrackPlayStorePurchaseメソッドを呼び出します：event(ADJEvent)：インスタンス化されたイベントオブジェクト。callback(ADJVerificationResultBlock)：ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
let event = ADJEvent(eventToken: "g3mfiw")!event.setProductId("product-id")event.setTransactionId("transaction-id")
Adjust.verifyAndTrackAppStorePurchase(event) { verificationResult in print("Verification status: \(verificationResult.verificationStatus)") print("Code: \(verificationResult.code)") print("Message: \(verificationResult.message)")}ADJEvent *event = [[ADJEvent alloc] initWithEventToken:yourEventToken];[event setProductId:@"product-id"];[event setTransactionId:@"transaction-id"];
[Adjust verifyAndTrackAppStorePurchase:event withCompletionHandler:^(ADJPurchaseVerificationResult * _Nonnull verificationResult) { NSLog(@"Verification status: %@", verificationResult.verificationStatus); NSLog(@"Code: %d", verificationResult.code); NSLog(@"Message: %@", verificationResult.message);}];購入認証のみの場合
- (void)verifyAppStorePurchase:(nonnull ADJAppStorePurchase *)purchase withCompletionHandler:(nonnull ADJVerificationResultBlock)completion;独立して購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。
-
以下の引数で
ADJAppStorePurchaseをインスタンス化します：transactionId(NSString)：認証したいトランザクションのID。productId（NSString）：購入に成功したアイテムのプロダクトID。
-
次の引数を使用して
Adjust.verifyAppStorePurchaseメソッドを呼び出します：purchase(ADJAppStorePurchase)：インスタンス化された購入オブジェクトcallback(ADJVerificationResultBlock)：ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。
この例では、購入認証レスポンスがログdaemonに出力されます。
let appStorePurchase = ADJAppStorePurchase(transactionId: yourTransactionId, productId: yourProductId;
Adjust.verifyAppStorePurchase(appStorePurchase) { verificationResult in print("Verification status: \(verificationResult.verificationStatus)") print("Code: \(verificationResult.code)") print("Message: \(verificationResult.message)")}ADJAppStorePurchase *appStorePurchase = [[ADJAppStorePurchase alloc] initWithTransactionId:yourTranscationId productId:yourProductId];
[Adjust verifyAppStorePurchase:appStorePurchase withCompletionHandler:^(ADJPurchaseVerificationResult * _Nonnull verificationResult) { NSLog(@"Verification status: %@", verificationResult.verificationStatus); NSLog(@"Code: %d", verificationResult.code); NSLog(@"Message: %@", verificationResult.message);}];購入認証を有効にしている場合は、購入イベントと共に追加情報を送信して、購入イベントを認証する必要があります。Adjustのサーバーがこの情報をADJEventオブジェクトで受け取ると、情報をAppleに転送して購入を確認します。
購入認証を行うには、イベントトークンを使用してADJEventオブジェクトをインスタンス化し、以下のプロパティを設定してください。
transactionId（NSString）：正常に完了した購入のtransactionIdentifier値productId（NSString）：購入に成功したアイテムのプロダクトIDreceipt（NSData）：正常に完了した購入に関する情報を含む署名済みレシート
ADJEventクラスの詳細については、イベント情報の送信をご覧ください。
let receiptURL = Bundle.main.appStoreReceiptURL;let receipt = try Data(contentsOf: receiptURL, options: .alwaysMapped)
let event = ADJEvent(eventToken: "abc123")event?.setRevenue(6.0, currency: "EUR");event?.setTransactionId("transaction-id");event?.setProductId("product-id");event?.setReceipt(receipt);Adjust.trackEvent(event)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];