At a glance: Use this guide to create a link to retarget your existing app users and send them directly into a specific experience (for example, 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.
![]() |
![]() |
![]() |
![]() |
Related reading: Deep linking with SRNs
Scope of work
Who's involved
Note: This guide indicates when and how the marketer needs to involve the developers. |
Prerequisites
|
Time required Approximately 3 hours (depending on the supported use cases), working together with your mobile developers. |
Outcome 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. |
Example
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.
Procedures
To create a custom link, you must 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, for example, 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:
- Contact your iOS and Android developers to plan the deep_link_value to set on your links.
- The deep_link_value is the value name for the specific in-app content that users will be directed to. The developers implement the desired behavior of the deep_link_value in the code.
- The developers implement the desired behavior in the code. Share the guide so they understand the technical flow and see examples:
- Unified deep linking (UDL) for Android and iOS: For deep linking AND deferred deep linking new or existing users, with or without your app.
Considerations for UDL: Requires SDK V6.1 or later. - Note: Customers already using OneLink for deep linking may be using the legacy methods for Android and iOS, instead of UDL.
Tip
The marketer and developers must decide together on the best long-term system for the deep_link_value (and any other parameters/values) to minimize additional app updates.
The deep_link_value can be based on a product SKU, social media post ID, URL path, or anything else. 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 deep_link_value of a fruit type 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.
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=apples...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=bananas...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=peaches...
- Unified deep linking (UDL) for Android and iOS: For deep linking AND deferred deep linking new or existing users, with or without your app.
- After receiving confirmation from the developers that the app behaves according to the selected parameters and values, in the AppsFlyer dashboard, go to Experiences & deep linking > OneLink.
- Click the link you created in the previous guide.
The Custom attribution link page opens. - In the Deep linking & redirection tab, enter the Deep link value according to what you decided with the developers.
- [Optional] If your deep linking requires more than one in-app experience (for example, you want to direct users to a product, and separately offer them a discount), you can add an Additional deep link value (with the parameter deep_link_sub1) to the deep linking data payload. You can add further deep link parameters (deep_link_sub2-10) in the Attribution tab.
- Contact your iOS and Android developers to plan the values.
- The developers implement the desired behavior in the code. Share the guides for Android and iOS with the developers to understand the technical flow and see examples.
- In the Attribution tab, go to the Additional attribution parameters section and add custom parameters deep_link_sub2-10 and values as required, according to what you decided with the developers.
- Click Update link.
Note
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
Prerequisites:
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:
- In the AppsFlyer dashboard, go to Experiences & deep linking > OneLink.
- Hover over the Actions icon of the link you want to test and click Get URL.
- 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.
- Click the link on your mobile device.
The app should open to the specific content you specified in the link parameters. - Go to the AppsFlyer Retargeting dashboard.
Look for a new click and re-engagement (app open) under your link's media source (for example, test) and the campaign name you put in the URL.
Link not behaving as expected? Check out our troubleshooting guide.
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.
- Continue to the next step
Next step
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.