OneLink™ 3/4: Deep linking existing users to specific pages

At a glance: Use this guide to create a link to retarget your existing app users and send them directly into a specific experience (e.g. a specific page) within your app (without being directed to the app store or app home page first). These users are attributed using retargeting attribution.


Scope of work

Who's involved

  • Marketer: Set up deep links for existing Android and iOS users. 
  • iOS developer: Implement deep linkingdetect deep link data parameters (from the link) and route app users accordingly.
  • Android developerImplement deep linkingdetect deep link data parameters (from the link) and route app users accordingly.

Note: This guide indicates when and how the marketer needs to involve the developers.


Time required

Approximately 3 hours (depending on the supported use cases), working together with your mobile developers.


In OneLink 2/4 you created a custom link, that sends existing users to open your app. OneLink 3/4 covers how to send existing app users who click your link directly to specific content in your app. To do this, you will use the deep linking data from AppsFlyer's SDK.
This applies to ALL deep linking methods: Universal Links, Android App Links, and URI scheme. 


Mark the marketer's Facebook post (from the previous guide's example) had mild success in getting existing users to return to the app. However, not many users who click the link and open the app actually convert to place an order.

Mark decides to increase conversion by offering a free bag of peaches, apples, or avocados with every purchase. For this, Mark creates a smooth, deep-linking experience for existing users. He sends his user base a detailed email stressing the benefits of these 3 healthy fruits. 

For each fruit mentioned in the email, Mark includes a deep link powered by OneLink, configured (with the help of mobile developers) to:

  • Take existing app users (regardless of platform) straight to the relevant fruit page.
  • Direct new users without the app installed to the appropriate app store or landing page, based on their device.

Mark can then create many more links without any additional developer work, deep linking to any product page in any given link.


To create a custom link, you need to choose parameters and values. When a user clicks your custom link, AppsFlyer delivers the parameters and values to your app's internal code. 

Inside your app, the code written by the mobile developer receives the parameter information via the AppsFlyer SDK (if integrated) and makes the app do something specific, e.g. navigate to a particular page.

Complete the following procedures to set up a custom link (with parameters and values) that sends existing iOS or Android app users directly to specific content within the app. 

1. Creating a custom deep link

To create a custom deep link:

  1. The developers implement the desired behavior of the parameter in the code. 
    Contact your iOS and Android developers to plan parameter names and values to set on your links. Share this guide with the developers to understand the technical flow and see examples.

    There are two options for naming parameters and values to pass data to your app:

    Parameter/value naming method




    Use AppsFlyer official subscriber parameters.

    af_sub1, af_sub2



    Subscriber parameters are parsed by AppsFlyer and have their own columns in attribution data and raw data reports.

    • Parameter names can't be changed 

    • Up to 5 such parameters available

    Create custom parameters. 

    store_page, content_id



    You can choose any parameter name.

    Requires parsing in order to analyze the attribution and raw data. 


    The marketer and developers need to decide together on the best long term system for naming parameters to minimize subsequent app updates.

    We strongly recommend agreeing with your developers on a system that allows for you to enter dynamic values on your chosen parameter, so you can generate many different deep links that go to different content within the app, without any further changes to the app code by the developers.

    See the following URL examples. The parameter fruit_name was chosen by the marketer and developer together. And the developers made the values dynamic, so the marketer could enter any fruit without the need for further work by the dev team.

  2. After receiving confirmation from the developers that the app behaves according to the selected parameters and values, in the AppsFlyer dashboard, go to Engagement & deep linking > OneLink Custom Links.
  3. Click the link you created in the previous guide.
    The Custom attribution link page opens.
  4. In the Attribution tab, enter the parameters and values according to what you decided with the developers.
  5. Recommended - consider entering the same deep linking data in attribution parameters, such as Ad set name, or Ad name. This will help you analyze the success of different offerings to your users. For example, entering the relevant fruit name in Ad set name (in addition to af_sub3) enables Mark to see the success of apples, peaches, and avocados ad sets in the Fruit campaign.
  6. Click Update link.


Once parameters and dynamic values are implemented by the developers, the marketer can use OneLink API to automatically generate thousands of custom links. Learn more

2. Testing


An Android and/or iOS device with the app installed. Make sure it is the app source and version where the developer(s) made changes.

To test your link:

  1. In the AppsFlyer dashboard, go to Engagement & deep linking > OneLink Custom Links.
  2. Hover over the Actions icon of the link you want to test and click Get URL
  3. Send the short or long URL to your phone. You can either:
    • Scan the QR code with your phone camera or QR scanner app.
    • Email or WhatsApp yourself the link, and open it on your phone.
      Note: Do not paste into iOS notes, or directly into a mobile browser. Often, the mobile operating system intentionally will not open the app in this context.
  4. Click the link on your mobile device.
    The app should open to the specific content you specified in the link parameters. 
  5. Go to the AppsFlyer Retargeting dashboard.
    Look for a new click and re-engagement (app open) under your link's media source (e.g. test) and the campaign name you put in the URL.

Next step

If you completed the procedures in this article, then congratulations! You have created a link you can send to existing app users to direct them straight to specific content (or get a personalized experience) in your app and receive retargeting attribution data. 

What if NEW users click on your custom link? Follow the instructions in OneLink 4/4 to give new users the same deep linking experience existing users get by using deferred deep linking. This will take new users first to the app store, and then directly to specific content inside your app.

Was this article helpful?