Set up purchase verification for your app

To start working with Purchase verification, you need to ensure you have correctly set up the Adjust SDK in your app and provided Adjust with the necessary credentials to authorize purchases from the relevant store.

Before you begin

Requirements

• Admin, Editor or Custom Editor permissions in Adjust
• For creating and mananging app store credentials:
  • Google Cloud: Service Account Key Admin role on the project or service account.
  • App Store Connect: Admin rights.

What you need to know

• Purchase verification is intended only for in-app purchases made through the Google Play Store or Apple App Store. It does not work for the purchase of physical items.
• Available for iOS, Android and Unity apps.

1. Set up the Adjust SDK

To integrate Adjust Purchase Verification into your application, ensure you have the minimal required SDK version installed and complete the necessary implementation steps for sending purchase revenue events.

• Android v4.34.0 or later
• iOS v4.34.0 or later
• Unity v4.34.0 or later

Optional: Set up verification SDK callbacks

Set up SDK verification callbacks to receive the verification status of a purchase directly in-app. With this information delivered to your app in real-time, you can then enable the automatic delivery of the purchased item to a user.

Be aware that in-app verification SDK callbacks are only available for iOS and Android apps using Adjust's native SDK v5. Use the links below to find out how to migrate to the SDK v5, and how to set up the verification callbacks.

Migrate to the Adjust SDK v5:

• Android
• iOS
• Unity

Set up verification SDK callbacks:

• Android
• iOS
• Unity

2. Find your app store credentials

To verify purchases with a store, you need to provide Adjust with certain credentials that allow us to match your account.

Android:

iOS:

Follow the instructions for your store platform to find the necessary credentials.

For Android

To create a service account key for a project or service account, your user account must have the Service Account Key Admin role.

Enable the Google Play Android Developer API

1. In Google Play Console, navigate to APIs & Services.
2. Select + Enable APIs and Services.
3. Under the Mobile area, select Google Play Android Developer API.
4. Select Enable.
5. Set the necessary API credentials.
   1. From the Enabled APIs & Services area, select Google Play Android Developer API.
   2. Select Create Credentials.
   3. Under Select an API, select Google Play Android Developer API.
   4. Under What data will you be accessing?, select Application data.
   5. Select Next.

Create a service account

1. In Google Cloud, go to Create service account
2. Select your Google Cloud project.
3. Enter a service account name.
   • A service account ID is automatically generated.
4. Optional: Provide a service account description.
5. Select Create and continue.
6. Give the service account access to a project
   1. Assign the service account the Pub/Sub Admin role.
   2. Select + Add another role.
   3. Assign the service account the Monitoring Viewer role.
   4. Select Continue.
   5. Optional: Grant users access to this service account
   6. Select Done.

Create a new API key

1. In Google Cloud, go to IAM & Admin.
2. Select Service Accounts to view the service accounts for your project.
3. For the service account you created, select Actions (three dots icon).
4. Select Manage keys.
5. Select Add Key > Create new key.
6. Under Key type, select JSON.
7. The private key is automatically downloaded.

For iOS

You need to have Admin rights in App Store Connect to create and manage API keys.

Find your Issuer ID

1. In App Store Connect, select the Users and Access icon.
2. Select the Integrations tab.
3. Under the Key Type menu on the left, select In-App Purchase.
4. At the top of the page, next to Issuer ID, select Copy.

Generate a new API key

We recommend you generate an API key dedicated for Adjust in-app revenue verification.

Select + Generate API Key

Name the new key, then select Generate.

You can now see your new key in the active keys list. Select Download.

Confirm your intent to download the new API key.

1/4

(1/4)

(2/4)

(3/4)

(4/4)

1. Select Generate API Key or + icon to create a new key.
   • If you have not already requested API access in your App Store Connect account, complete the request to do so.
2. In the Name field, enter a name for the key.
3. Select Generate.
4. Your new API key appears in the list of active keys with its Key ID.
5. On the key you generated, hover over the value in the Key ID column. Select the Copy Key ID link that appears.
6. Select Download In-App Purchase Key.
7. Select Download to proceed.
8. Copy the entire API key from the downloaded file.

3. For iOS: Connect Adjust to App Store Connect

Follow these steps to add the App Store Connect credentials in the Adjust dashboard:

1. In Adjust, navigate to DataWorks > Connections.
2. Select + New Connection.
3. From the list, select App Store Connect (In-App Purchase).
4. Under Services, select Purchase Verification.
5. Enter your Issuer ID.
6. Enter your Key ID.
7. Open the .p8 file in a text editor and copy the whole of the Private key. Paste this into the Private key field.

4. Add Purchase verification to your app

Now, apply Purchase verification for your app:

1. In Adjust, navigate to AppView and select your app.
2. Navigate to the Protection tab.
3. Under Purchase Verfication, select Edit ().
4. Toggle ON Purchase verification.
5. Provide platform-specific information:
   • For iOS apps: If you have an iOS app, you need to select which App Store Connect account to use.
   • For Android apps: Upload the JSON key file you previously downloaded.
6. Select Save.

And that's it - you're all set up!

Share verified revenue data with partners

Adjust's purchase verification solution ensures that only verified revenue data is shared with your partners. This means that you can have confidence in the data that is shared and its use for campaign optimization.

If you have already set up in-app revenue sharing with partners in the Adjust dashboard, you do not need to make any changes. Adjust automatically only forwards the revenue data that carries the verified passed status.

To set up a new partner, and enable verified in-app revenue sharing, follow the instructions for ad network setup in Campaign Lab. When you reach the step to choose your data sharing options be sure to select in-app revenue.