OneLink™ overview

At a glance: Many app owners have owned media assets such as websites, banners, social media posts, user emails, and telephone numbers. OneLink is a single link technology that converts owned media users into mobile app users, regardless of device, operating system, channel, or platform.


About OneLink

  • Helps marketers engage their users by providing links that work across all owned media marketing channels. 
  • Redirects users to the correct app store (e.g. App Store or Google Play), landing page, or app (if users already have the app installed).
  • Opens the app to the default activity (using App Links, Universal Links, and URI scheme, as set in the OneLink template). 
  • Drastically increases user engagements and conversions by deep linking existing users, or by using deferred deep linking for new users, to specific content and experiences within the app (as set in the OneLink custom link and implemented by the developer).
  • OneLink setup has 2 components: A OneLink template, and a OneLink custom link.
  • A OneLink template represents the routing logic at the core of your links, to redirect users to the correct app store and open the app. A OneLink template is not a clickable link for your end-users; it is the foundation for generating many custom links. Based on the template, you can create many OneLink custom links for the users to click on. A single OneLink template can be the basis for creating many links. It is rare to need more than one or two OneLink templates in the lifetime of an app (outside of testing).
  • Free of charge to all account plans.

Introduction video

OneLink setup

Setting up OneLink requires two different roles within an organization to work together:

Role Tasks Resources

Marketer/product manager

  • Set up OneLink
  • Use OneLink custom links
    in marketing campaigns
  • AppsFlyer dashboard
  • Help center docs
Mobile developers 
  • Implement OneLink functionality
    in mobile apps

OneLink four-part guide for marketers

Marketers should follow the four-part guide to fully setup OneLink. The guides include clear indications on when to involve developers (who use the developer hub and sample app).

Click the guide images that follow to visit them.

Part1_180X408.png Part2_180X408.png Part3_180X408.png Part4_180X408.png

Using OneLink to detect the user's device type upon click and redirect them to the correct destination.

For example, Android users are redirected to Google Play, iOS users to the App Store, desktop users to a webpage.

Using OneLink to directly send existing app users who click your link to the default activity in the app (set in the OneLink template). 

Clicks (and future in-app events) are correctly attributed using retargeting.

Using OneLink during retargeting campaigns to directly serve existing app users who click your link with personalized content in the app (set in the OneLink custom link). Using OneLink during retargeting campaigns to serve new installing app users who click your link with personalized content in the app (set in the OneLink custom link).

Advanced OneLink options

After completing some or all of the four-part guides, consider implementing the advanced OneLink features described below.

Note: All features are included as part of the AppsFlyer Zero and Growth plans, except OneLink API, which is a premium feature. 

  • Mobile web-to-app attribution solutions: Convert your mobile website visitors into app users with the mobile web-to-app attribution solutions provided by AppsFlyer, Smart Banners and Smart Script.
  • OneLink API: Scale and run multiple campaigns at once, and create thousands of OneLinks quickly and easily, saving you time and effort, and letting you focus on your campaign and marketing efforts instead.
  • Measuring push notification re-engagement campaigns: Use push notifications with OneLink to measure mobile users' re-engagements.
  • QR code desktop-to-app conversion: Convert desktop website visitors into mobile app users by using QR codes generated with OneLink.
  • Texting desktop users a link to your app: Desktop users usually have their mobile devices less than 2 feet away from them. Learn how to convert desktop users to mobile app users. 
  • User invite attribution: User invites are very effective in converting new users. Learn how to use SDK methods to easily create and measure user invite campaigns.
  • Cross-promotion attribution: Your existing app users are excellent candidates for installing your other new apps. Learn how to use SDK methods to easily create and measure cross-promotion campaigns.
  • Long URLs: Add parameters to your OneLink custom links or generate a large number of OneLink custom links by applying your own simple formulas in a spreadsheet.
  • Attributing iOS Safari Smart App BannersSafari implements a Smart App Banner feature providing a standardized way to promote apps in the Apple App Store. Use this ONLY if you don't plan to use Smart Banners for your websites (which is the better option).

Email service providers (ESPs)

ESP email campaigns for mobile app users can cause attribution and deep linking issues.

To overcome those issues and work with the ESPs, you must follow their exact integration steps. 

Find the list of supported ESPs here.

Troubleshooting and FAQ

Quickly find solutions for testing and debugging OneLink custom link redirection/behavior issues with our OneLink troubleshooting guide.


  • OneLink is not supported by the Facebook mobile app install objective, where only Facebook App Links are accepted.
Was this article helpful?