iOS app verification

An iOS app needs to be verified before you can receive any SKAdNetwork data or set up any conversion value mappings in Conversion Hub. Follow the instructions in this article to request and manage your iOS app verification.

Before you begin

Here's what you need to know before getting started.

Requirements

• Admin, Editor, or Custom Editor permissions

Why do I need to verify my app ID?

Once Adjust verifies your App ID, you can use Adjust's SKAdNetwork solution for your app.

SKAN postbacks are sent by Apple to the network running the ads, who can enrich certain fields before sending the postback on to Adjust. The postback only contains the explicit Apple App ID as an identifier Adjust can use to assign that postback data to a specific app within our system.

Since the Apple App ID is publicly available, app verification is essential to keep your data secure. It means that Adjust can check that you are the legitimate app owner, and no one can falsely add your app to the account and receive your app's SKAN postback data.

1. Log in to App Store Connect with your Apple ID

Log in to your App Store Connect account using your Apple ID.

2. Collect authentication parameters

Adjust requires the following parameters to generate a JSON Web Token (JWT), and authorize requests to the App Store Connect API.

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 App Store Connect API.
4. At the top of the page, next to Issuer ID, select Copy.

Generate a new API key

The App Store Connect API authorizes access to your app data in App Store Connect. We recommend you generate an API key dedicated for Adjust verification. Sharing the App Store Connect API key with Adjust does not provide any services to Adjust and is required for your iOS app verification process.

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. In the Access field, select Developer as the role.
4. Select Generate.
5. Your new API key appears in the list of active keys with its Key ID.
6. On the key you generated, hover over the value in the Key ID column. Select the Copy Key ID link that appears.
7. Select the Download () icon.
8. Select Download to proceed.
9. Copy the entire App Store Connect API key from the downloaded file.

Select + Generate API Key.

Name the new key and give it an access level. Developer access is the minimum level required for app verification. Next, 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)

3. Connect to App Store Connect in Connections

1. From the overview in Connections select + New connection.
2. Find App Store Connect in the list of partners.
3. Select iOS App Verification as the service.
4. Enter your Key ID.
   • This is the key that you copied in Generate a new API key - Step 6.
5. Enter your Issuer ID.
   • This is the key that you copied in Generate a new API key - Step 4.
6. Paste in your Private key.
   • This is the key that you copied in Generate a new API key - Step 9.
7. Select Connect.

After you request to connect your account, Adjust generates a JSON web token (JWT) and requests specific app information from the App Store Connect API.

If the authentication parameters you enter are valid, then the connection is set up. If there is a problem with the values you provide, you'll see an error.

4. Request app verification in AppView

Select AppView > All apps. Then, select your app from the list.

On the Platforms tab, enter your App ID. Select Request verification.

1/2

(1/2)

(2/2)

To request that Adjust verify your app ID, follow these steps in the Adjust dashboard.

1. Navigate to AppView > All apps.
2. Select your app from the list.
3. Select the Platforms tab.
4. Under Apple App Store, enter your App ID.
5. Select Request verification.
6. Check the app ID verification status as a badge on the App Store icon.

• Requested App ID verification, but App ID not verified – App Store icon displays a red badge with an iOS App ID verification requested message.
• App ID verified – App Store icon displays a green badge with an iOS App ID verified message.

If there is an issue with verifying your app ID, a modal will display stating verification has failed.

If you have not yet entered your authentication parameters in Connections, select Go to Connections, and follow the steps under the "Connect to App Store Connect in Connections" section above.

If you have already entered your authentication parameters in Connections, double-check that the app ID you entered in the Adjust dashboard matches the app ID in App Store Connect.

Once you have entered the authentication parameters in Connections and you have confirmed that the app ID is correct, select Request verification again. If you are still receiving the error modal, this can indicate another issue (e.g., authentication parameters are valid, but are for the wrong App Store Connect account). Please contact your Adjust representative or support@adjust.com for further assistance.

5. Remove Connection and Revoke Key

Adjust only requires the connection to the App Store Connect API for a one-time verification of your iOS apps. Once you have confirmed that the verification is complete, we recommend removing the connection as a proactive security measure. Follow the below steps in the Adjust dashboard to remove the connection:

1. Under DataWorks, select Connections.
2. In the list of partners, select App Store Connect.
3. Under the Actions column, select the Delete icon.
4. Select Delete.

When you are done verifying iOS apps, you can revoke the API key you created in App Store Connect by following the below steps:

1. Log in to your App Store Connect account using an Apple ID that has an admin role and has access to your apps.
2. Select the Users and Access icon.
3. Select the Keys tab.
4. To the right of the Active keys section, select the Edit button.
5. To the left of each key you want to revoke, select the checkbox.
6. Select Revoke Key.
7. Select Revoke.