adjust-icon

iOS認証購入移行ガイド

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

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

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

  1. 購入を示すADJEventオブジェクトを作成し、以下のプロパティを追加します。

    • productId （NSString）：購入に成功したアイテムのプロダクトID。
    • transactionId ( NSString )：認証したいトランザクションのID。

  2. プロダクトID、トランザクションID、受領証でADJAppStorePurchaseオブジェクトを作成します。

イベントの記録と購入認証

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

  1. イベントトークンを使用してADJEventオブジェクトをインスタンス化し、以下のパラメーターを設定します。

    • productId （NSString）：購入に成功したアイテムのプロダクトID。
    • transactionId ( NSString )：認証したいトランザクションのID。

  2. 次の引数を使用してAdjust.verifyAndTrackPlayStorePurchaseメソッドを呼び出します：

    • event ( ADJEvent )：インスタンス化されたイベントオブジェクト。
    • callback ( ADJVerificationResultBlock )： ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

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

購入認証のみの場合

独立して購入データを送信し、購入認証ステータスを受信するには、次の手順に従ってください。

  1. 以下の引数でADJAppStorePurchaseをインスタンス化します：

    • productId （NSString）：購入に成功したアイテムのプロダクトID。
    • transactionId ( NSString )：認証したいトランザクションのID。

  2. 次の引数を使用してAdjust.verifyAppStorePurchaseメソッドを呼び出します：

    • purchase ( ADJAppStorePurchase )：インスタンス化された購入オブジェクト
    • callback ( ADJVerificationResultBlock )： ADJPurchaseVerificationResultオブジェクトを引数として受け取るデリゲートコールバック関数。

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