简介
OneLink™ 是一种独特的 AppsFlyer 归因链接，广告主可以通过该链接以一次点击操作 3 大主要功能：
- 设备识别和重定向OneLink 能够在用户点击链接时识别设备类型（Android、iOS、台式电脑等）并将用户重定向至匹配的目的地。
- 深度链接：如果宣传的应用已安装，OneLink 能够在点击后启动应用或者为用户提供定制内容（例如将用户转至应用中的特定行为/页面）。
- 延迟深度链接： 在未安装 应用时，OneLink可以为用户提供个性化内容，并在安装后首次启动该应用时把用户带到应用中的特定活动/页面。
广告主通常会将 OneLink 部署到其自有媒体中，例如电子邮件、短信营销、网站横幅和落地页、社交媒体上广泛传播的帖子以及实物海报上的二维码等。OneLink 也可以用于已对接的广告平台。
此指南涵盖 OneLink 的基础设置，能够实现设备检测和重定向。
在完成此基础设置后，您可以继续参阅深度链接指南获取详细说明。
示例
AwesomeCom 发布了新的 Android 和 iOS 应用。移动推销人员 Jill 决定使用 AwesomeCom 的用户手机号码数据库进行短信营销活动。短信中会包含对一项操作的调用以及单一的 OneLink URL。{0}点击该链接的所有 Android 用户会被重定向至 Google Play 上该应用的页面。点击同一链接的所有 iOS 用户将被重定向至 iTunes 上该应用的页面。{0}该营销活动通过 OneLink 成功地将 AwesomeCom 23.5% 的注册用户转化成移动用户。
设备检测和重定向流
如果您使用的是一台有过互动的设备并且点击了 OneLink，则会触发以下步骤：
- 您被重定向至 AppsFlyer 的服务器
- 如果您选择安装该应用，您点击的 URL 及其参数就将保存到该服务器上以备日后使用，以及用于归因和深度链接目的
- 之后，根据设备的用户代理，将立即检测设备类型。
- 然后，根据与您的设备类型相符的 OneLink 模板（如下），您会被重定向至指定的目的地
OneLink 的设置需要两个阶段才能实现这些步骤：
注意
OneLink 还支持以下平台:
- Android - 基于Android系统的智能电视
- 苹果电视 (tvOS)
- Amazon Fire电视 - Amazon Fire电视请使用自定义Android APK URL选项
- Windows - 所有通用 Windows 平台，包括 Xbox
OneLink 模板配置
每一种设备类型对应的不同目的地都在该 OneLink 模板中定义。
在完成 OneLink 的基础设置后，您可以创建具有不同参数的多个自定义链接，所有这些链接都指向 OneLink 模板中的同一个目的地（除非设置被覆盖）。
您无法删除OneLink模板。如果要删除OneLink模板，请联系您的客户经理或发电子邮件给我们 hello@appsflyer.com 。
AppsFlyer 账户下的每一个移动应用都可以在一个唯一的 OneLink 模板中进行定义。有关应用使用多个 OneLink 模板的详细信息,请点击此处。
重要信息！
尽管可以在多个 OneLink 模板中定义同一个移动应用,但在大多数情况下不需要。通常，一个应用应该仅在一个OneLink 模板中设置。
使用此设置可以创建许多具有不同属性但指向相同目标的自定义归因链接。
OneLink 列表页面
OneLinks 列表窗口是账户级的，这意味着它是所有应用的共同列表，包含该账户的所有 OneLink 模板。
1. 从任意应用的控制面板的“配置”下面，点击配置 OneLink，即可打开 OneLinks 列表窗口
生成的每一个 OneLink 都有其自己的唯一 OneLink ID（如果 OneLink 子域已定义）：http://myapp.onelink.me/onelinkid。{0}{0}每一个 OneLink 也都有其自己的自定义名称。
2. 要新建 OneLink 模板，点击 https://support.appsflyer.com/hc/article_attachments/360000534589/OL_setup_2.png。
3. 要编辑现有的 OneLink 模板，点击对应的 OneLink 名称。
注意
OneLink 一经设定即不可删除。这是因为，基于已删除 OneLink 模板的任何现有归因链接都会失效，可能将用户重定向于 404 页面（页面未找到）。
取而代之，您可以直接编辑现有的 OneLink 模板。
在选择现有的 OneLink 模板，或添加新模板后，就会打开 OneLink 配置页面。
OneLink 配置页面
在该页面中，您可以设置 iOS、Android 和 Windows Phone 设备的目的地。此外，您还可以进行其他一些高级设置。以下部分是对各个选项的说明。
OneLink 模板名称
在此处设置 OneLink 的名称，最好是针对模板中相关的应用进行设置。此设置是可选项，如果您未设置名称，就会为该模板生成“Untitled OneLink”的默认名称。
您可以随时更改 OneLink 的名称。
iOS 应用
使用下拉菜单，选择您希望用户在 App Store 中被重定向至的 iOS 应用。
高级选项
-
自定义着陆页
若要将 iOS 用户重定向至 App Store 以外的落地页，在 自定义 iOS 落地页 的 URL 字段中填写落地页URL。
若要设置iOS OneLink 的其他选项，拖曳启用深度链接的Universal Link开关至开即可。
-
App ID Prefix
应用权限的应用程序标识符键
-
iOS 测试应用
如果你在使用测试应用开发iOS应用，你可以用OneLink来测试。
完整填写XCode中定义的应用ID前缀（同步骤2）和iOS应用包名。
注意
这两个值都可以在 developers.apple.com 中的 Identifiers >> App IDs 下面找到。如下所示，点击已注册的相应 App ID 即可。
- iPad
如果有独立的iPad应用版本，请在iPad下拉菜单中选择它，以将iPad用户重定向到该版本。
Android 应用
使用下拉菜单，选择您希望用户被重定向至 Google Play 中的 Android 应用。
自定义Android APK 链接
- 自定义 Android APK URLhttps://support.appsflyer.com/hc/en-us/articles/207447023如果您的 Android 应用不是来自于 Google Play，在此处插入应用的链接，Android 用户将被重定向至此链接。
- 为深度链接启用应用链接https://support.appsflyer.com/hc/en-us/articles/115005314223-Deeplinking-Users-with-Android-App-Links“应用链接”是一种高级方法，用于在 Android OS 6.0 及以上版本的 Android 设备上执行深度链接。更多详细信息, 请点击此处。
Windows Phone 应用
选择您希望用户被重定向至 Windows Phone 商店中 Windows Phone 应用，将其 URL 添加到自定义 Windows Phone URL 框中。
其他配置
注意
深度链接 (iOS9/Android 6 及以上)子域名字段不得包含"."。例如,MyApp 是有效的，但com.MyApp 无效。
Kindle Fire：填入 Amazon Store ASIN 或者用于 Kindle Fire 用户的 URL
网站URL ：为桌面用户填充任何目标URL。如果未定义URL，则将用户重定向到Apple App Store中的应用页面。
注意
“深度链接指南”中包含前两项其他配置的参数。
从 OneLink 模板中创建自定义链接
现在，OneLink 模板已经准备好，您可以使用该模板创建包含各种参数的归因链接。这些归因链接可能因媒体渠道和营销名称（如电子邮件、网站、横幅等）等值而有所不同，但基本的 OneLink 重定向对于所有链接都是相同的（除非您覆盖此设置）。
您可以使用自定义归因链接设置窗口手动创建 OneLink 归因链接。如需了解详情，请点击此处。
此外，如果您想要自动创建 OneLink 归因链接或进行批量创建，则可使用 OneLink REST API。
您无法删除OneLink模板。如果要删除OneLink模板，请联系您的客户经理或发电子邮件给我们 hello@appsflyer.com 。
测试 OneLink 重定向
若要测试新配置好的 OneLink 模板，请按以下说明操作：
1. 创建一个多平台的 '测试'自定义归因链接
选择要使用该OneLink的应用
3. 填写媒体渠道和广告系列名称。1. 创建一个 'test' 自定义链接 - 您可以针对您所运行的任意类型的测试创建不同的链接。但是，AppsFlyer 建议全部使用 test 媒体渠道名称。
提示
当您使用 AppsFlyer 进行任何测试时，务必使用 &pid=test，从而可以在 'test' 媒体渠道下面查看所有测试结果。把测试类型添加到广告系列名称参数（&c={test type}，如&c=redirections）以通过营销活动名称参数区分不同的测试类型。
4.生成归因链接，并使用长链或短链进行测试
示例：
https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections
5.对于在 OneLink 配置页面配置的每一个操作系统版本：
- 发送测试 URL - 通过电子邮件、二维码等发送到对应的白名单设备
- 点击测试 URL - 验证设备是否被重定向至配置好的目的地（Google Play、iTunes、网页等）
- 安装移动应用 - 在设备上安装并启动应用
- 检查结果 - 在控制面板的概览页面，在您输入 URL（如重定向）的 'test' 媒体渠道和营销活动名称下面找到新的点击和安装记录重定向案例
警告
成功完成以上测试仅表示您的应用已经准备好，可以进行 OneLink 重定向。关于深度链接测试，请点击此处。
覆盖 OneLink 模板中的目的地
虽然 OneLink 模板中配置的重定向通用于所有使用该模板的追踪链接，但您可以使用自定义参数覆盖它。在追踪链接中设置以下目的地参数会将点击链接的用户重定向至链接中指定的值，而不是模板中配置的值。
目的地参数
| 目的地参数名称 | 描述 | AppsFlyer 的提示 |
|---|---|---|
| af_ios_url | 将 iOS 用户引导至与 iTunes 上不同的 URL应用页面。 | 这个用于着陆页跳转或者深度链接失灵时的后备页。 注意-具有Safari 13.0.0及更高版本的Mac用户是根据af_ios_url重定向的，而不是根据af_web_dp重定向的。 |
| af_android_url | 将 Android 用户重定向至其他 URL，而不是 Google Play 中的应用页面 | 这个用于着陆页跳转或者深度链接失灵时的后备页 |
| af_r | 将所有操作系统和平台上的用户重定向到指定 URL | 此方法用于落地页跳转。 |
| af_web_dp | 将桌面用户重定向至其他网页，而不是 OneLink 模板中配置的网页 | 该参数用于将桌面端用户的归因数据保持在其他平台上（如Google Analytics或Omniture等)。 |
| af_dp | 把用户深度链接到某应用内活动的路径。 | 可用此方法进行深度链接和再营销。 |
| af_ios_fallback | 为 iOS 10.3 及以上的用户提供回退 URL | 使用此参数改善iOS 10.3用户的中断流程。 |
| af_param_forwarding | 当设置为‘否’时，归因链接里的参数不会被转发给重引导页面 | 若要获得看起来更干净的跳转页面，或者避免归因链接参数可能会因为跳转页面的查询参数处理而造成问题，可使用此项。 |
警告
请勿将下列任何字符用作目标参数值的一部分(甚至不要用于 URL 编码)。把他们用于屏蔽OneLink跳转或者深度链接活动。
非法字符有: []<>;(){}'`"
示例
点击以下示例链接的 Android 用户将被重定向至 google.com，而不是 Google Play 上的预设Android 应用页面。点击该链接的 iOS 用户将被重定向至 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
OneLink 和社交应用
广告主可能想要在社交应用的“病毒式”传播的帖子中使用 OneLink，因为无法根据其设备提前定位接触此类帖子的潜在用户。
然后，Apple 的通用链接设置的一些限制，以及某些社交应用的一些限制，会阻止将 OneLink 用于深度链接，甚至有时会阻止将 OneLink 用于基本的设备识别、重定向和归因。
下表汇总了在目前流行的社交应用中可以使用 OneLink 实现的功能：
| 社交应用 | Android 重定向 | Android 深度链接 | iOS 重定向 | iOS 深度链接 |
|---|---|---|---|---|
| Y | 有条件地 | Y | 有条件地 | |
| Facebook Messenger | Y | 有条件地 | Y | 有条件地 |
| Snapchat | Y | 有条件地 | Y | 有条件地 |
| Y | Y | Y | N （请参阅自定义Instagram落地页解决方法） |
|
| Line | Y | Y | Y | N |
| N | N | N | N | |
| Slack | Y | 有条件地 | Y | 有条件地 |
| Y | 有条件地 | Y | 有条件地 | |
| 微信 | 是{0}（参阅微信常见问答） | N | N | N |
| Y | Y | Y | Y |
社交应用的变通办法
为了避免上述的 OneLink 限制，仍然在社交应用的帖子中实现设备重定向和深度链接，我们建议使用着陆页。
用户流如下：{0}{0}1.
- 创建一个带“下载应用”按钮的落地页，把OneLink放在这个落地页后面
- 把这个跳转链接发布到社交应用
- 一个用户在社交应用内点击了这个跳转链接
- 该用户被重定向至着陆页
- 落地页中有“下载应用”按钮，落地页后面有OneLink用户点击了这个按钮
- 然后进入常规的 OneLink 流，包括使用指纹识别进行深度链接和归因。
注意
着陆页的转化率可能比原始渠道略低，因为需要用户的二次点击。
要了解更多关于将Facebook 移动用户归因给着陆页的信息,请访问此处。
更多关于在社交应用帖子中使用OneLink做深度链接的信息，请参阅深度链接指南。
将 OneLink 用于已对接广告平台
OneLink 主要用于自有媒体，而不是广告平台。
广告平台极少使用 OneLink，因为广告平台通常在应用中进行广告营销。这使得广告平台能够了解用户的平台、设备 ID 等，因而其应用和平台特定的追踪链接就已足够。
但是，有时广告平台事先并不知道其用户使用的平台，例如，当他们自己使用电子邮件或短信营销时。
重要信息！
用于已对接合作渠道的OneLink要使用长链OneLink。
OneLink 用于已对接广告平台时的设置
- 进入 Android 应用的控制面板下的已对接广告平台，选择相应的广告平台。
- 从设置窗口中复制应用的归因链接，将其保存到外部文档中。
- 对于 iOS 应用，重复第 1 和第 2 步。
然后，建立归因链接：
- 确保 OneLink 设置正确
-
在自定义归因链接窗口中创建基础 OneLink URL，将其保存到外部文档中。创建基础OneLink URL时,请使用"test"作为媒体源名称:
- 点击生成链接后，将会看到以下信息：
- 复制生成的长链接。
- 将已对接广告平台准确的 PID 添加至以下链接：https://greatapp.onelink.me/3287867539?pid=network_int&
- 添加两个归因链接的所有参数{0}如果 iOS 和 Android 应用的追踪链接完全一样，只需复制其中任意一个的参数即可。如果二者的归因链接不一样，则确保添加两个链接的所有参数。
如果已对接广告平台的所有参数都正确添加，用户点击 OneLink 并跳转至正确的平台，则会在用户安装应用后将所需参数回传给广告平台。
示例
https://greatapp.onelink.me/3287867539?pid=network_int&c=email&
idfa{$IDFA}&gaid={$GAID}&clickid=$SITEID&
af_sub1=[pixel_code]&af_sub2=[creative]
广告平台根据客户端设备平台使用 IDFA 或 GAID 参数，而忽略其他参数。
常见问题解答
有，在 HTML href tag 中使用 target="_blank" 则不会跳转至 Google Play。
有，Instagram 有以下限制：
- 由于 Instagram 渲染页面文本的方式，将链接添加到帖子的标题时，链接变为不可点击。
- Instagram 的个人资料描述不支持可点击链接。
- 可以添加来自个人资料网站的链接，但这种链接始终会被转向 App Store，因为 Instagram（仅限 iOS）不支持通用链接。
为了克服这个问题，OneLink 可以识别微信中的点击，加载一个专用的着陆页，引导用户点击选项按钮，然后点击 在浏览器中打开。这样就会打开 OneLink 配置中定义的重定向 URL。
如果用户的微信中设置的语言为中文，则 OneLink 会生成一个经过本地化的着陆页：
