OneLink Setup Guide

OneLink™ is a single, unique tracking link - capable of recognizing your mobile device and redirecting users to either Google Play or iTunes, if the app is not yet installed.  Alternatively, it can launch the app if it is already installed on the device (with deeplinking capabilities). 

In addition, you can redirect desktop, iOS and Android users to any web URL, such as your website or landing page, or the Google Play/App Store page of your app.

To start using OneLink™, follow these three simple steps described below:

  1. OneLink™ Integration - Enable deeplink in your app and integrate the AppsFlyer SDK.
  2. OneLink™ Set up – Configure it using the AppsFlyer dashboard.
  3. OneLink™ Link Generation – Generate the link quickly and easily.

OneLink™ Integration

To enable deeplinking and to integrate the AppsFlyer SDK in your app, refer to the OneLink™ Integration Guide link at the bottom of this article.

Setting up OneLink™ Configuration for your App

1.  From the dashboard under the Configuration section click Configure OneLink to open the OneLink Configuration window opens. 


Here you configure the apps and the website you want your OneLink™ to be associated with. 


2.  For an existing OneLink, click the name of the OneLink to open the window to make changes:

Select the apps you want to associate with the OneLink™ (the app being viewed is automatically selected) – one application for each platform.  You can leave the alternative app empty if you only wish to associate one app with this OneLink™.

NOTE:  If an app already has OneLink attached to it, you are unable to attach another one.  If you do, you receive an error message.

3.  Complete the website URL to redirect desktop users. If you leave this field empty, desktop users are redirected to your app's app-store web URL.

NOTE:  Clicks generated on desktop lead to the configured web URL and are tracked as organic installs and not as installs generated through the OneLink™ campaign.

For a new app, click on New OneLink to open the configuration window:

4.  You can configure either custom iOS landing page URLs or custom Android APK URL as show below:





5.  Configure your Custom URL Scheme to enable deeplinking. See additional information in the OneLink™ Integration Guide.

6.  Scroll down for addtional configurations, add as required.


Updating your App to Support Deeplink FunctionalityEdit section

This is a mandatory step requiring some code change so that you can receive the deeplink attribution inside the app.  More importantly, it is necessary to have the AppsFlyer SDK aware of apps being opened using deeplinks.

For more details refer to the Reporting Deeplinks for Re-Targeting Attribution section in the iOS SDK Integration Guide.

Generating a OneLink™ LinkEdit section

1.  From the dashboard under the Configuration section click Integrated Partners.

The Integrated Partners Configuration window opens:

2.  Click Custom Tracking Link.


The OneLink Configuration window opens:

3.  In the Custom Media Source window, click the widget for the type of media source required.

4.  Enter a name for the Media Source and Campaign (optional).

5.  Select the Enable OneLink™ checkbox.

6.  If you want your OneLink™ to be associated with more than one platform, select the Enable Multi Platform checkbox (selected by default).

7.  For a retargeting campaign, select the Retargeting Campaign checkbox.

8.  To enable deeplinking, select the Enable Deeplinking checkbox and configure the deeplink schemes.


Tracking Link

You can shorten and copy the newly configured OneLink™, by clicking the Shorten Link and Copy Link buttons.  It is immediately ready to be used.

To run multiple campaigns using OneLink™, manually alter the different parameters in the link (for example, the campaign name).

Known Limitations

  • Using target="_blank" in the HTML href tag does not result in redirecting to Google Play app as it is blocked by the above limitation.
  • When sharing a post on Facebook using a OneLink URL the functionality of opening the deeplinking up works only if you click on the logo and not the URL itself.  (The URL will re-direct you to the App Store or Google Play Store).  This is a Facebook limitation.
  • Due to an iOS limitation if Universal Links are enabled for any OneLink it cannot be shortened on the custom tracking link screen

Instagram Limitations

  • Due to the way Instagram renders the text of a page post, links do not become clickable when entered in a post's caption.
  • Instagram profile descriptions do not support clickable links.
  • Linking from profile website links is possible, however it directs to the App Store all the time since Universal Links are not supported in Instagram (iOS only).

OneLink Integration

For details of how to perform the OneLink Integration, click here.

Using OneLink for Debugging iOS Test App

For details click here.


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Powered by Zendesk