Set up universal links

Universal links are a specific deep linking protocol available for iOS 9 and later.

Set up universal links for deep linking

Before you use universal links for reattribution, you need to set up universal links for deep linking. To do this, complete the following steps:

  1. Verify your setup in your Apple Developer account and Xcode.
  2. Define a custom URL scheme for your app.
  3. Enable universal links in your app. This generates a raw universal link. A raw universal link is simply a universal link without any parameters, in-app path, or key-value pairings appended.
  4. Configure Associated Domains in your Apple Developer account and Xcode.

1. Verify setup in Apple Developer account and Xcode (Developer)

  1. Verify that the value of Team Name in your Apple Developer account matches with Team in Xcode.

  2. Verify that the Bundle Identifier of your app in Xcode is available as one of the Bundle IDs in your Apple Developer account. Ensure that this Bundle ID is unique in your Apple Developer account. You need to provide this value in Adjust. Example: com.example.app

  3. In your Apple Developer Account, note the App ID Prefix for your Bundle ID. You need to provide this value in Adjust.

Note:
The App ID Prefix might be the Team ID in your Apple Developer account. For more information, see Apple's Developer documentation.

2. Define a custom URL scheme (Developer)

  1. Define the format of your custom URL scheme. If you are using a cross-platform framework, refer to the documentation for that framework to define the format of your custom URL scheme. You need to provide this value in Adjust. Example: exampleApp

  2. Register your custom URL scheme with your URL scheme and Bundle ID.

For more information, see Apple's Developer documentation.

3. Enable universal links in Adjust

Before you enable universal links in Adjust, ensure that you have the following values:

Complete these steps to enable universal linking for your app. Enabling universal links creates a raw univeral link. You need to provide this value in your Xcode.

4. Configure Associated Domains (Developer)

Before you configure Associated Domains, ensure that you have the raw universal link. This is the value that you noted in 3. Enable universal links.

Complete the following steps to configure Associated Domains:

  1. In your Apple Developer account, enable Associated Domains for your Bundle ID.

  2. In Xcode, enable Associated Domains, and provide the domain in the applinks:{Your raw universal link} format. Ensure no error message is displayed here.

Example: If your raw universal link is abcd.adj.st, then enter applinks:abcd.adj.st as the domain.

You're all set! You have successfully set up universal links for deep linking.

Next step: Set up universal links for reattribution (Developer)

To set up universal links for reattribution, complete the steps under Reattribution via deep links.