Standard deeplink setup (indirect deeplinks)

With the deep_link parameter Adjust can automatically track deeplinks for existing users, defer deeplinks for new app users, conditionally redirect users to app stores, and more. Learn how to append the deep_link parameter to your tracker URLs in the steps below.

To find setup instructions for tracking direct deeplinks, click here.

Notes:
  • In all instances, deeplink and deep_link are equally valid parameters.
  • On devices with iOS 9 and higher, indirect deeplinking is not supported. Confirm setup for your use case. 
  • The following instructions contain minimum-length tracker tokens. Always use the entire tracker token as displayed in your Adjust Campaign Wizard.

Set up indirect deeplinks

For a single Adjust tracker token

Follow these instructions if: 
  • You have a single tracker token for a single-platform app—i.e., you've separated your app by OS version in the Adjust dashboard, or;
  • You have a single tracker token for a multi-platform app—i.e., you've combined your OS versions into a single app in the Adjust dashboard. Tracker URLs for multi-platform apps are automatically cross-platform.
    • If you've separated your app by OS version in the Adjust dashboard and would like to create a cross-platform tracker URL with multiple tracker tokens and deeplink functionality, use these instructions.

Requirements

Instructions

 

1. Navigate to your app and select your app options caret (^)

2. Select Tracker URLs

3a. Identify the Adjust tracker URL that you want to use or create a new tracker for your campaign.

3b. In our example, the tracker token is bkrn68.

4a. Identify the custom uniform resource identifier (URI) that you want to include in your tracker URL. This will be a specific location or landing page within your own app. In our example, the custom URI is myamazingapp://super/exclusive/promotion

4b. All custom URIs must be encoded to ensure that no data is lost. An encoded URI will appear as follows: myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

5. In a plain text file, append the deep_link parameter and your encoded custom URI to the query string of your Adjust tracker URL. Remember to begin your query string with a ?.

6. Append any preferred Adjust parameters. (All Adjust parameters are compatible with the deep_link parameter).

    In the Adjust dashboard
    1. Navigate to your app and select your app options caret (^)
    2. Select Tracker URLs
    3. Identify the Adjust tracker URL that you want to use or create a new tracker for your campaign. In our example, the tracker token is abc123.

      https://app.adjust.com/abc123
    Internally
    1. Identify the custom uniform resource identifier (URI) that you want to include in your tracker URL. This will be a specific location or landing page within your own app. In our example, the custom URI is: 
      myamazingapp://super/exclusive/promotion
      All custom URIs must be encoded to ensure that no data is lost. An encoded URI will appear as follows: 
      myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    1. In a plain text file, append the deep_link parameter and your encoded custom URI to the query string of your Adjust tracker URL. Remember to begin your query string with a 
      https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    2. Append any preferred Adjust parameters. (All Adjust parameters are compatible with the deep_link parameter).
      https://app.adjust.com/abc123?campaign=My_Performance_Campaign&adgroup={publisher_id}&creative=Flashy_Image&deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

    When you have completed the steps above, your Adjust tracker URL is ready for use in your mobile campaign.

    For multiple Adjust tracker tokens

    Follow these instructions if you've separated your app by OS version in the Adjust dashboard and would like to create a cross-platform tracker URL with multiple tracker tokens and deeplink functionality. 

    Requirements

    Instructions

     

    1. Navigate to your app and select your app options caret (^)

    2. Select Tracker URLs

    3a. Identify the Adjust tracker tokens that you want to use or create an Adjust tracker URL for your new campaign.

    3b. In our example, the tracker tokens are bkrn68 and abc123.

    4a. Identify the custom uniform resource identifier (URI) that you want to include in your tracker URL. This will be a specific location or landing page within your own app. In our example, the custom URI is myamazingapp://super/exclusive/promotion

    4b. All custom URIs must be encoded to ensure that no data is lost. An encoded URI will appear as follows: myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

    5. In a plain text file, append the deep_link parameter and your encoded custom URI to the query string of your Adjust tracker URL with both tracker tokens, separated by an underscore. Remember to begin your query string with a ?.

    6. Append any preferred Adjust parameters. (All Adjust parameters are compatible with the deep_link parameter).

    In the Adjust dashboard

    1. Navigate to your app and select your app options caret (^)
    2. Select Tracker URLs
    3. Identify the Adjust tracker tokens that you want to use or create an Adjust tracker URL for your new campaign. In our example, the tracker tokens are abc123 and def456

      https://app.adjust.com/abc123
      https://app.adjust.com/def456
    Internally
    1. Identify the custom URI that you want to include in your tracker URL. This will be a specific location or landing page within your own app. In our example, the custom URI is: 

      myamazingapp://super/exclusive/promotion

      All custom URIs must be encoded to ensure that no data is lost. An encoded URI will appear as follows: 

      myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion  
    1. In a plain text file, append the deep_link parameter and your encoded custom URI to the query string of your Adjust tracker URL with both tracker tokens, separated by an underscore. Remember to begin your query string with a ?

      https://app.adjust.com/abc123_def456?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    2. Append any preferred Adjust parameters. All Adjust parameters are compatible with the deep_link parameter.

    When you have completed the steps above, your Adjust tracker is ready for use in your mobile campaign. 

    Finalize setup with testing

    Test as a new app user

    To simulate a deferred deeplink experience, proceed with the following instructions:

    1. To test as a new user, you must operate a fresh device that has never been tracked by Adjust. For good measure, it's always our recommendation to clear your device from our system prior to testing.

    2. Once you've verified that you're working with a fresh device, click on the deeplink tracker URL

      • Upon click, you will be redirected to the appropriate app store

    3. In the app store, download the app

    4. Open your app—this will be counted as an install in Adjust

      • After the app has launched, you will be redirected to a specific in-app location, as determined by the custom URI set within the deep_link parameter

    Test as an existing app user

    To simulate a deeplink experience, proceed with the following instructions:

    1. Install your app on to the test device—if you are downloading the app onto the device for the very first time, remember to open your app at least once, prior to proceeding with your test 

    2. Once you've verified that your device has installed a recent version of your app, click on the deeplink tracker URL

    3. Upon click, your app will launch, and you will be directed to a specific in-app location (as determined by the custom URI set within the deep_link parameter)

    On this topic