Set up deeplinks using a tracker and deep_link parameter

In Adjust, you can set up deeplinks using an Adjust tracker URL with the deep_link parameter appended.

Here, you’ll learn how to create both single and multi-platform deeplinks and test their functionality.

Before you begin

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

Requirements

  • An app configured for deeplinking (iOS; Android)

Helpful information 

  • The deep_link parameter is compatible with all other Adjust parameters
  • Devices with iOS 9+ don’t support deeplinking using a tracker and deep_link parameter in most ad environments. Check your deeplink options.
  • The following instructions contain minimum-length tracker tokens. Always use the entire tracker token displayed in your Adjust Campaign Wizard.
  • Always remember to encode deeplinks

Set up deeplinks using an Adjust tracker URL

For tracker URLs with a single tracker token

To set up deeplinking for a single-token tracker, you can use our Deeplink Generator. This saves time and prevents errors. You can find the Deeplink Generator in the Adjust dashboard by selecting Menu > Deeplink Generator. 

If you want to manually set up your deeplink, follow these steps.

 

In our example, the tracker token is bkrn68.

Choose your custom URI scheme (this is your deeplink destination)

Encode your custom URI

In a plain text file, add to your tracker and append the deep_link parameter and encoded custom URI

Append any further Adjust parameters

     

    1. In the Adjust dashboard, find or create a tracker URL. The example tracker token here is abc123.

    https://app.adjust.com/abc123 
    2. Choose your custom URI scheme (this is your deeplink destination)  
    myamazingapp://super/exclusive/promotion
    3. Encode your custom URI scheme 
    myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    4. In a plain text file, add ? to your tracker URL and append the deep_link parameter and encoded custom URI scheme  
    https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    5. Append further Adjust parameters to add functionality or campaign details to your tracker URL 
    https://app.adjust.com/abc123?campaign=My_Performance_Campaign&adgroup={publisher_id}&creative=Flashy_Image&deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

    Well done! Your deeplink setup is complete. Now your Adjust tracker URL will deeplink users into your app.

    For tracker URLs with multiple Adjust tracker tokens

    To deeplink a multi-platform tracker URL, both of your apps must share the same URI scheme. To set up your deeplink, follow these steps. 

    Choose your custom URI scheme (this is your deeplink destination)

    Encode your custom URI

    In a plain text file, add to your tracker and append the deep_link parameter and encoded custom URI

    Append any further Adjust parameters

     

    1. In the Adjust dashboard, create a multi-platform tracker URL. The example tracker tokens here are abc123 and bkrn68

    https://app.adjust.com/abc123_bkrn68 

    2. Choose your custom URI scheme (this is your deeplink destination)  

    myamazingapp://super/exclusive/promotion
    3. Encode your custom URI scheme 
    myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    4. In a plain text file, add ? to your tracker URL and append the deep_link parameter and encoded custom URI scheme  
    https://app.adjust.com/abc123_bkrn68?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
    5. Append further Adjust parameters to add functionality or campaign details to your tracker URL 
    https://app.adjust.com/abc123_bkrn68?campaign=My_Performance_Campaign&adgroup={publisher_id}&creative=Flashy_Image&deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

    Good job! Your multi-platform deeplink setup is complete. Now your Adjust tracker URL will deeplink users into your app.

    Test your deeplink

    Always test your deeplink before using it in a campaign. There are many factors that affect deeplink functionality, and unexpected behavior can affect your attribution data. If during testing you encounter problems, check our Troubleshooting guide for more information. 

    As an existing user

    To test your deeplink as an existing user with the app installed, follow these steps.

    1. On your test device, install your app and open it at least once  
    2. Click your deeplink tracker URL
    3. Upon click, your app will launch and deeplink you to the specific location written in your custom URI scheme

    If your app opens after the click, then your Adjust setup is complete. 

    If your app doesn’t open in the correct place within the app, this means your app can’t properly handle the deeplink content. Speak with your development team to check paths within the app are set up properly.

    As a new user (deferred deeplinking)

    To test a deeplink as a new user without your app installed, follow these steps.

    1. Uninstall the app completely from the device (empty app trash if applicable)
    2. Run forget_device via the Testing Console in the Adjust dashboard
    3. Click your deeplink tracker URL and wait to be redirected to the app store
    4. Download the app and open it - this will trigger an install in Adjust
    5. At app open, you will be deeplinked to the specific location written in your custom URI scheme

    If you are deeplinked to the correct place after opening the app then your Adjust setup is complete. 

    If you are not deeplinked to the correct place after opening the app, run the test again as an existing user and check to see if you are attributed to the click. If you are attributed, but still not deeplinked to the correct place, then there may be a problem with how your deeplink was passed. This may be because the deeplink parameter was cut off or due to an encoding error. Check our troubleshooting guide or contact support@adjust.com for help.

    On this topic