Configure deep link settings

Requirements

• Admin permissions in the Adjust dashboard for branded domain setup
• Editor permissions or higher in the Adjust dashboard for app settings management

Create an app

Create an app in the Adjust dashboard.

Please note that the Adjust dashboard only supports one bundle ID (com.example.app) and app scheme (example://) for each app. If your app uses different bundle IDs and/or app schemes for your release and debug builds, create a separate debug app.

Add iOS platform

Add iOS in the platform settings for your app. This step requires entering the bundle ID. If you’re not sure of the bundle ID for your app build, enter a temporary value (com.example.app) to save the platform settings. Follow the rest of this guide to collect all required data points, then return to platform settings in the dashboard to finish the configuration.

Set up a branded domain

In the Adjust dashboard, set up a branded domain using Adjust’s go.link domain (for example: brandname.go.link).

If your iOS app and Android app use separate apps in Adjust, ensure that you select the same branded domain (brandname.go.link) for both apps in the Adjust dashboard.

If you use separate apps for release and debug builds, create a separate branded domain for your debug app (brandnamedebug.go.link). If your debug apps use separate apps for iOS and Android in Adjust, ensure that you also select this same branded domain for both debug apps in the Adjust dashboard.

Make note of your branded domains to configure in Xcode in the next section.

Configure settings in Xcode

Configure universal links

1. Open your Xcode project.

2. In the navigator pane, select the project name to access the project settings.

3. In the project settings, under Targets, select the appropriate target (usually your app’s name).

4. Select the Signing & Capabilities tab.

5. Complete these steps for both the Release and Debug sub-tabs:

   • Make note of the value in the Bundle Identifier field. This is your app’s bundle ID (“Release Bundle ID” or “Debug Bundle ID,” respectively), which you need to configure in the iOS platform settings in the Adjust dashboard.

   • In the Associated Domains section, add an entry for each of your branded domains. For the example domain brandname.go.link, here is the required entry:

     applinks:brandname.go.link

Troubleshoot missing or problematic Associated Domains settings

• If you don’t see the Associated Domains section you might need to enable it first:
  1. Next to the Release or Debug sub-tab (wherever it’s missing), click + Capability.
  2. Search for “Associated Domains” and select it.
• If you get an error message, such as “Provisioning profile {profile_name} doesn’t support the Associated Domains capability” when trying to enable Associated Domains, your provisioning profile likely needs to be updated:
  • For automatic signing, make sure “Automatically manage signing” is selected at the top of the Signing & Capabilities page.
  • For manual signing:
    1. Go to the Apple Developer portal and enable the Associated Domains capability for your app.
    2. Download and import the updated provisioning profile into Xcode.

Retrieve or configure app scheme

App scheme is required for certain use cases where iOS doesn’t support universal links. You can reuse an existing app scheme for Adjust deep linking.

1. In the Xcode navigator pane, select the project name to access the project settings.
2. Under Targets, select the appropriate target (usually your app’s name).
3. Select the Info tab.
4. Expand the URL Types section.

If your app already has an app scheme, there will be URL Type entries, each of which has a single value for URL Schemes. Use the table below to determine your app schemes based on your URL Types configuration. Make note of the app schemes to configure them in the Adjust dashboard later.

URL Schemes field	App Scheme
Static value, such as example	example:// is the “Release App Scheme”
Static values, such as example, exampleDebug in separate URL Types entries	example:// is the “Release App Scheme” exampleDebug:// is the “Debug App Scheme”
Dynamic build setting variable, such as $(APP_SCHEME)	Go to Build Settings tab -> search for variable name, such as “APP_SCHEME” -> values for Release and Debug are the “Release App Scheme” and “Debug App Scheme,” respectively

If you need to create an app scheme, follow these steps:

• Select the + button to add a new URL Type.
• Fill in the following fields:
  • Identifier: $(PRODUCT_BUNDLE_IDENTIFIER)
  • Role: Editor
  • URL Schemes: Enter your desired app scheme value (enter example, not example://). Don’t use http, https, or reserved iOS schemes like mailto, tel, sms, or facetime. Entering a static value here will create a single app scheme used for both release and debug builds.
• Once created, make note of the app scheme for configuration in the Adjust dashboard later.

Retrieve App ID Prefix from Apple Developer Portal

1. Log into the Apple Developer portal.
2. Under Certificates, IDs & Profiles, select Identifiers.
3. Select your app.
4. Near the top of the page, make note of the App ID Prefix to configure in the Adjust dashboard in the next section.

Finish configuring iOS platform settings

In the Adjust dashboard, finish configuring iOS platform settings for your apps using the below data points that you collected.

Data Point	Example	Requirement
Release Bundle ID	com.example.app	Required.
Debug Bundle ID	com.example.debug	Required if Debug Bundle ID is different than Release Bundle ID.
Release App Scheme	example://	Required for use cases where iOS doesn’t support universal links.
Debug App Scheme	exampleDebug://	Required if Debug App Scheme is different than Release App Scheme.
App ID Prefix	ABCDE12345	Required.