This guide shows you how to migrate from Adjust’s Purchase verification SDK to SDK v5’s built-in purchase verification features. The SDK v5 purchase verification workflow is a streamlined approach to purchase verification.
With the Purchase Verification SDK, verification is split into three steps:
-
Initialize the Purchase Verification SDK.
var adjustPVConfig = new ADJPConfig(adjustAppToken,ADJPEnvironment.Production);adjustPVConfig.SetLogLevel(ADJPLogLevel.Info);new GameObject("AdjustPurchase").AddComponent<AdjustPurchase>();AdjustPurchase.Init(adjustPVConfig); -
Verify your purchase.
// purchase verification request on iOSAdjustPurchase.VerifyPurchaseiOS("{Receipt}", "{TransactionID}", "{ProductId}", VerificationInfoDelegate);// purchase verification request on AndroidAdjustPurchase.VerifyPurchaseAndroid("{ItemSKU}", "{ItemToken}", "{DeveloperPayload}", VerificationInfoDelegate);// ...private void VerificationInfoDelegate(ADJPVerificationInfo verificationInfo){Debug.Log("Verification info callback!");Debug.Log("Message: " + verificationInfo.Message);Debug.Log("Status code: " + verificationInfo.StatusCode);Debug.Log("Verification state: " + verificationInfo.VerificationState);} -
Depending on the outcome of the verification, configure an
AdjustEventobject and send it to Adjust.AdjustEvent adjustEvent = new AdjustEvent("abc123");adjustEvent.setRevenue(6.0, "EUR");adjustEvent.setProductId("product-id");adjustEvent.setTransactionId("transaction-id");adjustEvent.setPurchaseToken("purchase-token"); // Android onlyadjustEvent.setReceipt("receipt"); // iOS onlyAdjust.trackEvent(adjustEvent);
In SDK v5, this workflow is simplified. The Adjust.verifyAndTrackAppStorePurchase() and Adjust.verifyAndTrackPlayStorePurchase() methods allow you to send an event to Adjust’s servers and receive the verification status as a callback. Adjust records the event and the verification status automatically.
Guide
Follow the steps in this guide to migrate from the Purchase Verification SDK to SDK v5 built-in purchase verification.
1. Uninstall the Purchase Verification SDK
To get started, uninstall the Adjust Purchase Verification SDK.
2. Remove Purchase Verification SDK code
Once you’ve uninstalled the Adjust Purchase Verification SDK, you must remove all Purchase Verification code from your project.
3. Migrate to SDK v5 purchase verification
Once you’ve removed the existing purchase verification code, you can replace it with SDK v5’s built-in purchase verification methods. There are two ways to verify purchases with the Adjust SDK:
- Create an
AdjustEventobject that represents your purchase and configure purchase properties for the target store. - Create an
AdjustAppStorePurchase(Apple App Store) orAdjustPlayStorePurchase(Google Play Store) object representing the purchase.
If you use revenue events to measure your purchases in Adjust, you should use the AdjustEvent class. If you only want to verify a purchase but don’t want to associate it with an event, use the AdjustAppStorePurchase or AdjustPlayStorePurchase class.
Record event and verify purchase
To send a revenue event for verification and listen for the purchase verification status, follow these steps:
- Instantiate an
AdjustEventobject with the your event token and set the following parameters:ProductId(string): The product identifier of the item that was successfully purchased.TransactionId(string): The ID of the transaction you want to verify.
- Call the
Adjust.VerifyAndTrackPlayStorePurchasemethod with the following arguments:event(AdjustEvent): Your instantiated event object.callback(Action): A delegate callback function that receives anAdjustPurchaseVerificationResultobject as an argument.
In this example, the purchase verification response is output to the logging daemon.
AdjustEvent adjustEvent = new AdjustEvent("abc123");adjustEvent.SetRevenue(6.66, "CAD");adjustEvent.TransactionId = "transaction-id";adjustEvent.ProductId = "product-id";Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>{ Debug.Log("Verification status: " + verificationResult.VerificationStatus); Debug.Log("Code: " + verificationResult.Code); Debug.Log("Message: " + verificationResult.Message);});To send a revenue event for verification and listen for the purchase verification status, follow these steps:
- Instantiate an
AdjustEventobject with the your event token and set the following parameters:ProductId(String): The ID of the product that has been purchased.PurchaseToken(String): The purchase token associated with the purchase.
- Call the
Adjust.VerifyAndTrackPlayStorePurchasemethod with the following arguments:ajustEvent(AdjustEvent): Your instantiated event object.callback(Action): A delegate callback function that receives anAdjustPurchaseVerificationResultobject as an argument.
In this example, the purchase verification response is output to the logging daemon.
AdjustEvent adjustEvent = new AdjustEvent("abc123");adjustEvent.SetRevenue(6.66, "CAD");adjustEvent.ProductId = "product-id";adjustEvent.PurchaseToken = "purchase-token";Adjust.VerifyAndTrackPlayStorePurchase(adjustEvent, verificationResult =>{ Debug.Log("Verification status: " + verificationResult.VerificationStatus); Debug.Log("Code: " + verificationResult.Code); Debug.Log("Message: " + verificationResult.Message);});Only verify purchase
To send a standalone App Store purchase and listen for the purchase verification status, follow these steps:
- Instantiate an
AdjustAppStorePurchaseobject with the following arguments:ProductId(string): The product identifier of the item that was successfully purchased.TransactionId(string): The ID of the transaction you want to verify.
- Call the
Adjust.VerifyAppStorePurchasemethod with the following arguments:purchase(AdjustAppStorePurchase): Your instantiated event object.callback(Action): A delegate callback function that receives anAdjustPurchaseVerificationResultobject as an argument.
In this example, the purchase verification response is output to the logging daemon.
AdjustAppStorePurchase purchase = new AdjustAppStorePurchase("product-id", "transaction-id");Adjust.VerifyAppStorePurchase(purchase, verificationResult =>{ Debug.Log("Verification status: " + verificationResult.VerificationStatus); Debug.Log("Code: " + verificationResult.Code); Debug.Log("Message: " + verificationResult.Message);});To send a standalone Play Store purchase and listen for the purchase verification status, follow these steps:
- Instantiate an
AdjustPlayStorePurchasewith the following arguments:ProductId(string): The ID of the product that has been purchased.PurchaseToken(string): The purchase token associated with the purchase.
- Call the
Adjust.VerifyPlayStorePurchasemethod with the following arguments:purchase(AdjustPlayStorePurchase): Your instantiated purchase object.verificationResultCallback(Action): A delegate callback function that receives anAdjustPurchaseVerificationResultobject as an argument.
In this example, the purchase verification response is output to the logging daemon.
AdjustPlayStorePurchase purchase = new AdjustPlayStorePurchase("product-id", "purchase-token");Adjust.VerifyPlayStorePurchase(purchase, verificationResult =>{ Debug.Log("Verification status: " + verificationResult.VerificationStatus); Debug.Log("Code: " + verificationResult.Code); Debug.Log("Message: " + verificationResult.Message);});