1. Introduction to OneLink
OneLink is AppsFlyer’s solution for platform attribution, redirection and deep linking.
OneLink detects the device type upon device click and redirects the user to the matching destination, such as the Google Play Store, iOS App Store, third-party app store, or web page.
OneLink™ is a unique AppsFlyer attribution link that allows advertisers to operate 3 main functions with a single click:
-
Device Identification and Redirection OneLink is able to identify the device type (Android, iOS, desktop, etc.) when a user clicks a link and redirect the user to the matching destination.
-
Deep linking: If the promoted app is installed, OneLink can launch the app on click or provide the user with customized content (e.g. taking the user to a specific action/page in the app).
-
Deferred deep linking: OneLink can serve users with personalized content when the app is not installed and take users to specific activities/pages in the app when they first launch the app after installation.
Advertisers typically deploy OneLink into their own media , such as emails, SMS campaigns, website banners and landing pages, widely shared posts on social media, and QR codes on physical posters. OneLink can also be used with connected advertising platforms.
Example:
AwesomeCom 发布了新的 Android 和 iOS 应用。移动推销人员 Jill 决定使用 AwesomeCom 的用户手机号码数据库进行**短信营销活动**。短信中会包含对一项操作的调用以及**单一的 OneLink URL**。{0}点击该链接的所有 Android 用户会被重定向至 Google Play 上该应用的页面。点击同一链接的所有 iOS 用户将被重定向至 iTunes 上该应用的页面。{0}该营销活动通过 OneLink 成功地将 AwesomeCom 23.5% 的注册用户转化成移动用户。
If you are using an interactive device and click OneLink, the following steps will be triggered:
-
You are redirected to AppsFlyer's servers
-
If you choose to install the app, the URL you click and its parameters will be saved to this server for future use and for attribution and deep linking purposes
-
Afterwards, the device type will be detected immediately based on the device's user agent .
-
You will then be redirected to the specified destination based on the OneLink template (below) that matches your device type
Setting up OneLink requires two phases to achieve these steps:
-
Configure OneLink template
-
Create custom links from OneLink templates
2. OneLink template configuration
Different destinations for each device type are defined in the OneLink template.
After completing the basic setup of OneLink, you can create multiple custom links with different parameters, all pointing to the same destination in the OneLink template (unless the settings are overridden ) .
You cannot delete OneLink templates. If you want to delete a OneLink template, please contact your account manager or email us at [email protected] .
Each mobile app under an AppsFlyer account can be defined in a unique OneLink template. For more information on apps using multiple OneLink templates, click here .
尽管可以在多个 OneLink 模板中定义同一个移动应用,但在大多数情况下不需要。通常，一个应用应该仅在一个OneLink 模板中设置。
使用此设置可以创建许多具有不同属性但指向相同目标的自定义归因链接。
1. OneLink list page
The OneLinks list window is account-level, which means it is a common list across all apps and contains all OneLink templates for that account.
(1) From the "Configuration" of any application's control panel, click Configure OneLink to open the OneLinks list window.
Each OneLink generated has its own unique OneLink ID (if the OneLink subdomain is defined):
http://myapp.onelink.me/onelinkid{0}{0}
Each OneLink also has its own custom name.
(2) To create a new OneLink template, click Add OneLink.
(3) To edit an existing OneLink template, click the corresponding OneLink name.
Notice
Once OneLink is set, it cannot be deleted. This is because any existing attribution links based on the deleted OneLink template will become invalid, potentially redirecting users to a 404 page (Page Not Found).
Instead, you can edit an existing OneLink template directly.
2. OneLink configuration page
On this page, you can set destinations for iOS, Android, and Windows Phone devices. Additionally, you can make some other advanced settings. The following sections are descriptions of each option.
(1), OneLink template name
Set the name of OneLink here, preferably for the related application in the template. This setting is optional, if you do not set a name, a default name of "Untitled OneLink" will be generated for the template.
You can change the name of OneLink at any time.
(2), iOS application
Using the drop-down menu, select the iOS app you want users to be redirected to in the App Store.
-
Custom Landing Page To redirect iOS users to a landing page outside of the App Store, fill in the landing page URL in the URL field of Custom iOS Landing Page .
To set other options for iOS OneLink, drag the Enable Deep Linking Universal Link switch to On .
-
App ID Prefix Application identifier key for app permissions
-
iOS Test App If you are developing an iOS app using a test app, you can use OneLink to test it . Completely fill in the application ID prefix defined in XCode (same as step 2) and iOS application package name
(3), Android application
Using the drop-down menu, select the Android app in Google Play that you want users to be redirected to.
Custom Android APK link
-
Custom Android APK URL https://support.appsflyer.com/hc/en-us/articles/207447023 If your Android app is not from Google Play, insert the link of the app here and Android users will be redirected here Link.
-
Enable App Links for Deep Linking https://support.appsflyer.com/hc/en-us/articles/115005314223-Deeplinking-Users-with-Android-App-Links "App Linking" is an advanced method for Deep linking is performed on Android devices running Android OS 6.0 and above. For more details, please click here .
3. Test and use
(1) Create a custom link from the OneLink template
Now, the OneLink template is ready and you can use it to create attribution links with various parameters. These attribution links may vary by value such as media channel and marketing name (e.g. email, website, banner, etc.), but the basic OneLink redirects are the same for all links (unless you override this setting ).
You can manually create OneLink attribution links using the Custom Attribution Link Settings window.
(2) Test OneLink redirection
To test your newly configured OneLink template, follow these instructions:
-
Create a multi-platform 'test' custom attribution link
-
Select the apps you want to use this OneLink with
-
Fill in the media channel and campaign names. 1. Create a 'test' custom link - You can create different links for any type of test you run. However, AppsFlyer recommends using all test media channel names.
hint
当您使用 AppsFlyer 进行任何测试时，务必使用 ***&pid=test***，从而可以在 'test' 媒体渠道下面查看所有测试结果。把测试类型添加到广告系列名称参数（&c={test type}，如&c=redirections）以通过营销活动名称参数区分不同的测试类型。
-
Generate attribution links and test with long or short links
-
For each operating system version configured on the OneLink configuration page:
Send test URL - sent to the corresponding whitelist device via email, QR code, etc.
Click the test URL - verify that the device is redirected to the configured destination (Google Play, iTunes, web, etc.)
Install mobile app - Install and launch the app on your device
Check the results - In the overview page of the dashboard, find the new click and install record redirect case under the 'test' media channel and campaign name where you entered the URL (as a redirect)
4. Override the destination in the OneLink template
Override destinations in OneLink templates
Although the redirect configured in a OneLink template is common to all tracking links that use that template, you can override it using custom parameters. Setting the following destination parameter in a tracking link will redirect users who click the link to the value specified in the link, rather than the value configured in the template.
Destination parameters
| Destination parameter name | describe | Tips for AppsFlyer |
|---|---|---|
| of_ios_url | Direct iOS users to a different URL app page than on iTunes. | This is used as a fallback page when the landing page jumps or the deep link fails. Note - Mac users with Safari 13.0.0 and above are redirected based on af_ios_url, not af_web_dp. |
| of_android_url | Redirect Android users to a different URL instead of the app page in Google Play | This is used as a fallback page when the landing page jumps or the deep link fails. |
| of_r | Redirect users on all operating systems and platforms to the specified URL | This method is used to jump to the landing page. |
| of_web_dp | Redirect desktop users to a different web page than the one configured in the OneLink template | This parameter is used to keep attribution data for desktop users on other platforms (such as Google Analytics or Omniture, etc.). |
| of_dp | A path that deep links users to an in-app activity. | You can use this method for deep linking and remarketing. |
| of_ios_fallback | Provide fallback URL for users on iOS 10.3 and above | Use this parameter to improve the interrupt flow for iOS 10.3 users. |
| of_param_forwarding | When set to 'No', parameters in attribution links will not be forwarded to the redirect page | Use this if you want to get a cleaner looking redirect page, or to avoid attribution link parameters that might cause problems with the query parameter handling of the redirect page. |
warn
Do not use any of the following characters as part of the target parameter value (not even for URL encoding). Use them to block OneLink redirect or deep link activity. Illegal characters are: []<>;(){}'`"
Example
Android users who click the example link below will be redirected to google.com instead of the default Android app page on Google Play. iOS users who click this link will be redirected to apple.com:
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