OneLink™ redirections setup guide

OneLink template configuration

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).

You cannot delete a OneLink template. If you want to delete a OneLink template, contact your customer success manager or email us to hello@appsflyer.com.

Each mobile app under an AppsFlyer account can be defined in multiple OneLink templates. For details on assigning an app to more than one OneLink template go here.

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 Engagement & Deep Linking section, click OneLink Configuration 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.

OneLink configuration page

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

• 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 OneLink deep linking options for iOS toggle the Enable Universal Links for deep linking button to On.
  
  
• App ID Prefix
  Application-identifier key in your app's entitlements
  
• 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.

  

• iPad
  If you have a separate iPad app version, select it in the iPad dropdown menu, to redirect iPad users to it.   
  

   Note

  As of iPadOS 13.1 Apple handles iPad users as desktop users. The result:

  • iPadOS 13.1 users are redirected to the defined website URL (under the af_web_dp URL parameter)
  • If the website URL (see below) isn't defined in the attribution link, users are redirected to the iOS mobile app page in the app store specified in the app settings page.
  • As a workaround - consider setting the website URL with the iPad app page URL.

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 URL

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. If no URL is defined, the user is redirected to the app's page in Apple's App Store.

Creating custom links from the OneLink template

Now your OneLink template is ready, you can create parameter-rich attribution links using it. These attribution 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 attribution links manually using the custom attribution links setup window. For details click here.

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

You cannot delete a OneLink template. If you want to delete a OneLink template, contact your customer success manager or email us to hello@appsflyer.com.

Testing OneLink's redirections

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

1. Create a Multi-platform 'test' custom attribution link

2. Select the OneLink configuration the attribution link is intended for

3. Fill in the media source and campaign names. 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

4. Generate the attribution link and use either the long or short URL for testing

Example:

https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections

5. 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 attribution links that use it, you can override them with custom parameters. Placing the following destination parameters on the attribution 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, complicate 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:

To learn more about attributing mobile users coming from Facebook to landing pages go here.

For performing deep linking from social media posts with OneLink go to the deep linking guide.

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 attribution 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 attribution link from the setup window and save it to an external document.
3. For your iOS app, repeat steps 1+2.

Now build the attribution link:

4. Make sure OneLink is properly set up
5. Create a basic OneLink URL in the Custom Attribution Link window and save it to an external document. When you create the basic OneLink URL, use "test" as the media source name:
   
   

   

6. After you click Generate Link, you see the following screen:
   

   

7. Copy the long link.
8. In the long link, Replace the "test" media source with the exact PID of the integrated partner to the link https://greatapp.onelink.me/U8ru?pid=network_int&c=MyCampaign
9. Add ALL parameters from BOTH attribution links
   If the attribution 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.

https://greatapp.onelink.me/3287867539?pid=network_int&c=email&
idfa{$IDFA}&gaid={$GAID}&clickid=$SITEID&
af_sub1=[pixel_code]&af_sub2=[creative]

FAQs