OneLink™ Basic Setup Guide

Introduction

OneLink™ is a unique AppsFlyer tracking link which advertisers can use to utilize 3 primary features with a single click:

1. Device Detection And Redirection: OneLink is able to detect the device type (Android, iOS, desktop etc.) when clicked and redirect the user to a matching destination.
2. Deep Linking: If the advertised mobile app is already installed, OneLink is able to support launching the app after click and/or serving the user with personalized content (such as sending a user to a specific activity/page in the app).
3. Deferred Deep Linking: If the advertised mobile app is not installed, OneLink is able to support serving a user with personalized content (such as sending a user to a specific activity/page in the app) on the first launch of the app after install. 

Advertisers usually deploy OneLink with their owned media, such as email and SMS campaigns, website banners and landing pages, viral posts on social media or even QR codes on physical posters. Nevertheless, it's also possible to use OneLink with integrated partners.

This guide covers OneLink basic setup, which enables device detection and redirection.

Once this basic setup is complete you can continue to the step-by-step deep Linking Guide.

Device Detection And Redirection Flow

When you are using an engaged device and click on OneLink the following steps occur:

1. You are redirected to AppsFlyer's servers
2. There, your click URL and its parameters are saved for later, for attribution and deep linking purposes, should you choose to install the app
3. Immediately afterwards, based on the user agent of the device, the device type is detected 
4. You are then redirected to the designated destination according to OneLink's template (see below), which fits your device type

There are two stages required for OneLink's setup to achieve these steps:

1. Configuring OneLink template
2. Creating custom links from OneLink's template

OneLink Template Configuration

Each mobile app under an AppsFlyer account can be defined in a single OneLink template.

The OneLink template is where all the different destinations per device types are defined.

Once the basic OneLink setup is complete, you can create many custom links with different parameters, that lead to the same destinations stated in the OneLink template (except if overridden).

OneLink List Page

The OneLinks list window is at account level, meaning it is common between all apps and contains all the OneLink templates of the account.

1. From the dashboard of any of your apps, under the Configuration section, click Configure OneLink to open the OneLinks list window

Each generated OneLink has its own unique OneLink ID (provided the OneLink sub domain is defined): http://myapp.onelink.me/onelinkid.

Each OneLink also has its own custom name.

2. For a new OneLink template click . 

3. To work on an existing OneLink template click the respective OneLink name.

After selecting an existing OneLink template, or adding a new one, the OneLink configuration page opens.

From here you can set the destinations for iOS, Android and Windows phone devices. In addition, there are some more advanced destinations you can set. The following explains each of these options.

OneLink Template Name

Set the OneLink name here, preferably for the participating apps in the template. This is optional, but if you don't set the name, the default name "Untitled OneLink" is generated for the template. 

You can change the OneLink name at any time.

iOS Apps

Using the dropdown menu, select the iOS app you want the user to be redirected to in the App Store.

Advanced Options

1. Custom Landing Page 
   To redirect iOS users to a destination different from the App Store, populate a destination URL in the Custom iOS Landing Page URL field.
   
   To set the remaining advanced OneLink options for iOS toggle the Enable Universal Links for deep linking button to On.
   
   
2. App ID Prefix
   Application-identifier key in your app's entitlements
   
3. iOS Test Apps
   If you are using a test app to develop your iOS app, you can test it using OneLink.
   Complete the App ID prefix (same as 2) and the iOS App Bundle ID, as defined on XCode. 
   

    Note

   Both values are found on developers.apple.com in the Identifiers >> App IDs section. Just click the corresponding registered App ID as shown below.

   

4. iPad 
   If your iOS app has a different iPad version, you can redirect iPad users to it. Use the iPad dropdown menu to select a different iOS app from your account, that the iPad user is redirected to in the App Store.

Android Apps

Using the dropdown menu, select the Android app that you want the user to be redirected to in Google Play.

Custom Android APK URLAdvanced Options

1. Insert here the link for your Android app, if it is out of Google Play, Android users are redirected to this link. 
2. Enable App Links for deep linking
   "App Links" is an advanced method for performing deep linking on Android devices from Android OS version 6.0 and above. For more details go here.

Windows Phone App

Select the Windows Phone app that you want the user to be redirected to in the Windows Phone store, and add its URL in the Custom Windows Phone URL box.

Additional Configuration

Kindle Fire: Populate an Amazon Store ASIN or an alternative URL for Kindle Fire users

Website URL: Populate any destination URL for desktop users.

Creating Custom Links from the OneLink Template

Now your OneLink template is ready, you can create parameter-rich tracking links using it. These tracking links can differ by values such as the media source and campaign names (e.g. emails, website, banners etc.), but the basic OneLink redirections are common for all links (except if you override them).

You can create OneLink tracking links manually using the custom tracking links setup window. For details click here.

Alternately, if you want to automatically create OneLink tracking links or by bulk, you can do this using the OneLink REST API.

Testing OneLink's Redirections

To test your newly-configured OneLink template follow these instructions:

1. Create a 'test' custom link - You can create different links for any type of tests you run.  However, AppsFlyer recommends using the test media source name for all of them.

2. Select Enable OneLink

3. Copy the OneLink URL at the bottom of the window (highlighted in green in the capture below) 

Example: https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections
4. For every OS version configured in the OneLink configuration page:

• Send the test URL - To the respective whitelisted device using email, QR code etc.
• Click on the test URL - Verify the device is redirected to the configured destination (Google Play, iTunes, web page etc.)
• Install the mobile app - On the device and launch it
• Check results - On the dashboard's overview page look for a new click and install under 'test' media source and the campaign name you put in the URL (e.g. redirections)

Overriding OneLink's Template Destinations

Although OneLink's template-configured redirections are common for all tracking links that use it, you can override them with custom parameters. Placing the following destination parameters on the tracking link sends clicking users to the values stated in the link instead of the template's configured values.

Destination Parameters

https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections&af_android_url=http%3A%2F%2Fwww.google.com&af_ios_url=http%3A%2F%2Fwww.apple.com 

OneLink & Social Apps

Advertisers may want to use OneLink with "viral" posts on social apps, as potential users that are exposed to such posts cannot be targeted in advance according to their devices.

Unfortunately, limitations set mainly by Apple's Universal Links, in conjunction with restrictions of some of the social apps, prevent the use of OneLink for deep linking, or even sometimes for basic device recognition, redirection and attribution. 

The following table summarizes what you can do with OneLink in today’s popular social apps:

Using OneLink with Integrated Networks

OneLink is mainly used with owned media, and not with ad networks. 

It is rare for ad networks to require OneLink since they usually advertise on apps. This enables them to know the user's platform, device ID etc., so their app and platform-specific tracking links suffice.

However, sometimes ad networks don't know their users' platform in advance, for example when they run email or SMS campaigns themselves. 

OneLink Setup with Integrated Networks

1. Go to Integrated Partners on your Android app's dashboard and select the relevant ad network.
2. Copy the app's tracking link from the setup window and save it to an external document.
3. For your iOS app, repeat steps 1+2.

Now build the tracking link:

4. Make sure OneLink is properly set up
5. Create a basic OneLink URL in the Custom Tracking Link window and save it to an external document. For example: https://greatapp.onelink.me/3287867539?
6. Add the exact PID of the integrated partner to the link https://greatapp.onelink.me/3287867539?pid=network_int&
7. Add ALL parameters from BOTH tracking links
   If the tracking link of the iOS and Android app are identical, simply copy the parameters from either one of the links. Otherwise make sure you have all the parameters from both links. 

If all the integrated network parameters are added correctly, once OneLink is clicked and redirected to the right platform, the required parameters are sent to the network within a postback after the user installs. 

FAQs