Unity購入認証移行ガイド

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

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

1. 購入認証SDKを初期化します。

   1
   var adjustPVConfig = new ADJPConfig(
   2
       adjustAppToken,
   3
       ADJPEnvironment.Production
   4
   );
   5
   
   6
   adjustPVConfig.SetLogLevel(ADJPLogLevel.Info);
   7
   new GameObject("AdjustPurchase").AddComponent<adjustpurchase>();
   8
   
   9
   AdjustPurchase.Init(adjustPVConfig);

2. 購入を検証します。

   1
   // purchase verification request on iOS
   2
   AdjustPurchase.VerifyPurchaseiOS("{Receipt}", "{TransactionID}", "{ProductId}", VerificationInfoDelegate);
   3
   
   4
   // purchase verification request on Android
   5
   AdjustPurchase.VerifyPurchaseAndroid("{ItemSKU}", "{ItemToken}", "{DeveloperPayload}", VerificationInfoDelegate);
   6
   
   7
   // ...
   8
   
   9
   private void VerificationInfoDelegate(ADJPVerificationInfo verificationInfo)
   10
   {
   11
       Debug.Log("Verification info callback!");
   12
       Debug.Log("Message: " + verificationInfo.Message);
   13
       Debug.Log("Status code: " + verificationInfo.StatusCode);
   14
       Debug.Log("Verification state: " + verificationInfo.VerificationState);
   15
   }

3. 検証の結果に応じて、 AdjustEventオブジェクトを設定し、Adjustに送信します。

   1
   AdjustEvent adjustEvent = new AdjustEvent("abc123");
   2
   adjustEvent.setRevenue(6.0, "EUR");
   3
   adjustEvent.setProductId("product-id");
   4
   adjustEvent.setTransactionId("transaction-id");
   5
   adjustEvent.setPurchaseToken("purchase-token"); // Android only
   6
   adjustEvent.setReceipt("receipt"); // iOS only
   7
   Adjust.trackEvent(adjustEvent);

SDK v5では、このワークフローは簡素化されています。Adjust.verifyAndTrackAppStorePurchase()とAdjust.verifyAndTrackPlayStorePurchase()メソッドを使用すると、Adjustのサーバーにイベントを送信し、認証ステータスをコールバックで受け取ることができます。Adjustは、イベントと認証ステータスを自動的に記録します。

ガイド

購入認証SDKからSDK v5のビルトイン購入認証機能に移行するには、このガイドをご覧ください。

1. 購入認証SDKをアンインストールする

この機能を利用するには、まずはAdjust購入認証SDKをアンインストールしてください。

2. 購入認証SDKコードを削除する

Adjustの購入認証SDKをアンインストールしたら、プロジェクトから全ての購入認証コードを削除する必要があります。

3. SDK v5の購入認証に移行する

既存の購入認証コードを削除したら、SDK v5に組み込まれた購入認証メソッドを使用してください。Adjust SDKで購入認証を行うには、次の2つの方法があります。

1. 購入を表すAdjustEventオブジェクトを作成し、ターゲットストアの購入プロパティを設定します。
2. 購入を表すAdjustAppStorePurchase （Apple App Store）またはAdjustPlayStorePurchase （Google Play ストア）オブジェクトを作成します。

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

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.TransactionId = "transaction-id";
4
adjustEvent.ProductId = "product-id";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

1
AdjustEvent adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.SetRevenue(6.66, "CAD");
3
adjustEvent.ProductId = "product-id";
4
adjustEvent.PurchaseToken = "purchase-token";
5
Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>
6
{
7
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
8
    Debug.Log("Code: " + verificationResult.Code);
9
    Debug.Log("Message: " + verificationResult.Message);
10
});

購入認証のみの場合

1
AdjustAppStorePurchase purchase = new AdjustAppStorePurchase("transaction-id", "product-id");
2
Adjust.VerifyAppStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});

1
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");
2
Adjust.VerifyPlayStorePurchase(purchase, verificationResult =>
3
{
4
    Debug.Log("Verification status: " + verificationResult.VerificationStatus);
5
    Debug.Log("Code: " + verificationResult.Code);
6
    Debug.Log("Message: " + verificationResult.Message);
7
});