OneLink问题排查及疑难解答

只有媒体渠道（pid）是必须配置的参数。

可以，您可以在短链后添加任何参数。

重要提示！短链后拼接的参数无法覆盖该链接中已配置的参数。

您可以使用任何名称命名您的自有媒体。但是建议您不要使用organic来命名自定义媒体渠道，因为这会影响归因数据的可靠性。

如果您在付费媒体中使用OneLink：

• 请在OneLink自定义链接的媒体渠道参数中使用对接渠道专用的PID值（以 _int结尾）。切勿以googleadwords或facebook等SRN的名称来命名您的自定义媒体渠道，否则会影响归因数据的准确性。
• 对于您在OneLink模板中配置的所有应用，请确保该渠道已与AppsFlyer对接并且处于活跃状态（即“启用该渠道”开关已打开）。

您可以在OneLink中添加各种归因参数，帮助您对归因数据进行深入剖析。 

详情请见AppsFlyer的归因链接结构和参数。

可以，自定义参数会呈现在原始数据中的original url一列，但是不会单独分列显示。

如果您需要解析后的数据，请使用可配置参数af_sub1-5，这些参数在原始数据报告中会单独分列显示。 

区分。请确保您的参数名称和参数值中仅包含小写字母。如果参数名称或参数值中带有大写字母或大小写不一致，会在面板和原始数据中造成数据误差和差异。

如果您在社交应用的非付费帖子中投放广告，但无法根据受众群体的设备进行定向投放，您可以使用OneLink来解决这一问题。

但是部分应用针对iOS的Universal Link设置了一定的限制，使得OneLink的设备识别、跳转、归因、深度链接等基本功能的实现变得更加复杂。某些情况下，您可能需要通过社交应用落地页或URI scheme来为用户实现跳转或深度链接。

下表总结了目前常见的社交应用对OneLink的支持情况：

可以，但OneLink主要用于自有媒体，而非广告平台。 这是因为广告平台通常在流量侧应用中投放广告（也就是说，他们掌握用户的操作平台、设备ID等信息），因此您只需针对不同的应用和操作平台配置归因链接即可，无需使用OneLink。 但如果广告平台无法预判用户的操作平台（比如通过广告平台投放邮件或SMS广告时），就需要使用OneLink解决此问题。

请按以下方式设置广告平台的OneLink：

• 按照广告平台的归因链接说明进行操作，并在界面弹出OneLink提示时选择使用OneLink。

正确无误地将适用于安卓和iOS的所有参数添加到OneLink自定义链接后，用户点击该链接就能跳转到对应的平台，且用户激活应用后，必要参数会通过回传发送到广告平台。

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

Facebook等社交媒体应用在部分情况下会阻止iOS的Universal Link完成应用打开。建议您使用社交应用落地页来解决此类应用打开问题。

如果您不想使用社交媒体落地页，也可以配置一个URI scheme作为备用方案。但请注意以下事项：

• 将URI scheme作为Universal Link的备用方案时，其功能性会受到iOS相关限制的影响。
• 对于大部分浏览器（包括Safari），都必须在URL中添加 af_force_deeplink=true参数，才能将URI scheme作为备用方式打开应用。另请参考此文档了解详情。

可以，但请务必注意一下限制：

• Instagram对于帖子文案的渲染方式会使得帖子标题中的链接无法点击。

• Instagram支持安卓应用的调起和深度链接，没有特别需要注意的事项。但该平台不支持iOS应用的调起和深度链接。如需解决此问题，您可以使用以下任一方案：

  • 推荐：配置一个社交应用落地页。Clustered Poster和ShowAndTell模板最适合Insta上的帖子。另外，还建议您同时在的OneLink模板中设置一个URI scheme。
  • 在Instagram上投放OneLink时使用URI scheme和强制深度链接。在Instagram上的OneLink中使用af_force_deeplink=true时请务必注意以下链路：
    

    用户是否已激活应用	链接中是否带有af_force_deeplink=true？	结果
    否	是	点击后打开应用商店页面
    否	否	点击后打开应用商店页面
    是	是	点击后打开应用
    是	否	点击后打开应用商店页面

微信会覆盖安卓和iOS的深度链接，并让用户跳转到网页。用户必须在该网页中点击选项按钮，并选择“在浏览器中打开该页面”。这就会干扰用户体验的连贯性，致使用户脱离转化漏斗。

为了克服这个问题，OneLink会识别出微信中发生的点击，并打开一个专用的落地页，引导用户点击选项按钮并选择在浏览器中打开。完成该操作后，界面就会打开OneLink模板中设置的跳转链接页面。

如果用户将微信的语言设置为中文，OneLink会生成本地化版的落地页：

Facebook上的广告通常支持应用调起和深度链接。但如果出现以下情况，Facebook就不支持现有用户通过OneLink URL打开应用。这时，所有用户（包括已安装应用的现有用户）都会跳转到OneLink模板中设定的URL，或af_android_url、af_r或af_custom_android_url参数中指定的地址：

• 用户使用安卓移动端设备。
• 用户在Facebook应用中点击链接。
• 链接所指的HTML页面设置为在Facebook WebView中打开（移动端网站或社交应用落地页）。
• HTML页面中的链接同时包含af_dp参数（带有URI scheme）和URL跳转设置（通过OneLink模板、af_android_url、af_r或af_custom_android_url参数设置）。

在社交媒体应用中投放OneLink时，您可以使用社交应用落地页为用户打造无缝衔接的应用间跳转。一般情况下，在转化漏斗中添加额外的步骤会降低转化率。但在该场景中，如果没有落地页，用户链路就会出现断裂，导致转化率低靡。

如果您还不确定社交应用落地页是否确实有必要，可以先测试一下。

以有/无社交应用落地页为变量，对社交媒体应用中的自定义链接进行A/B测试：

请按以下步骤对社交应用落地页进行A/B测试：

1. 创建一条OneLink链接（命名为Link1），用于社交媒体应用中的投放，且不为该链接配置社交应用落地页。
2. 添加af_adset归因参数。
3. 添加af_ad归因参数，将参数值设为“no lp”。 
4. 在社交媒体应用以外的环境中测试Link1，确认该链接确实可正常生效并打开您的应用。
5. 创建Link1的副本，并将其命名为Link2。
6. 将af_ad归因参数的值更改为“using lp”。 
7. 仅为Link2创建社交媒体落地页。
8. 在同一个社交媒体应用中使用Link1和Link2分别发2个贴子。
   这里可以忽视两个链接之间的点击量差异，重点关注每个链接最终的转化率。
9. 产生足够流量后，查看A/B测试的结果。
   1. 进入AppsFlyer总览面板，向下滚动到汇总效果报告表。
   2. Link1和Link2具有相同的媒体渠道、广告系列和广告组名称，因此需要切入到广告组维度查看数据。
   3. 对比用户点击Link1和Link2后的转化率（以及其他指标）。

如果您在测试OneLink时看到要求您选择应用的对话框，请务必选择给应用签名，而非调试应用。您给应用签名时使用的证书就是您为App Link配置OneLink时用来生成SHA256数字指纹的证书。

建议您的开发人员使用Unified Deep Linking（UDL）方案来实现深度链接功能。详情请见深度链接指南。

iOS的Universal Link和安卓的App Link是用于调起应用的方法，不会为用户实现深度链接（即让用户进入应用内的具体页面）。URI scheme可以打开应用并进行深度链接（通过af_dp自定义链接参数实现），但建议您仅将该方法用于应用调起。该方法最主要的用途是作为Universal Link和App Link的备用方案，以及为6.0版本以前的安卓用户打开应用。

通过上述任一方法打开应用时，AppsFlyer SDK会上报自定义归因链接中deep_link_value参数的值。这个值需要通过开发人员配置的UDL方式来传递。

可以，但不建议这样操作。最理想的方法是使用deep_link_value来实现深度链接，并将URI scheme作为应用打开的备用方案，不带有通过af_dp参数实现深度链接功能。但如果您已经设置了深度链接的URI scheme，并在其中添加了其他的URI路径参数（如greatapp://param1/param2），也无需更改现有的配置或代码；该URI scheme仍可正常生效。

建议您在自定义链接设置页面中添加自定义参数。

不论您将广告投放在付费渠道还是自有媒体，通过UDL实现的深度链接对iOS用户的体验没有任何影响。但以历史方式实现的深度链接可能会出现问题。

IDFA或IDFV可用时，AppsFlyer会使用这两种ID进行归因/数据上报。如果IDFA和IDFV都不可用，AppsFlyer会通过概率模型进行归因。从iOS 14.5+开始，概率模型的使用场景仅限于自有媒体、交叉推广和授权用户的网页到应用归因。

不论您将广告投放在付费渠道还是自有媒体，通过UDL实现的延迟深度链接对iOS用户的体验都没有任何影响。但以历史方式实现的延迟深度链接可能会出现问题。

IDFA或IDFV可用时，AppsFlyer会使用这两种ID进行归因/数据上报。如果IDFA和IDFV都不可用，AppsFlyer会通过概率模型进行归因。从iOS 14.5+开始，概率模型的使用场景仅限于自有媒体、交叉推广和授权用户的网页到应用归因。如果您想要在付费渠道和自有媒体的投放中使用延迟深度链接，建议您使用AppsFlyer的iOS SDK V6.1.0+，以支持ATT授权（如有需要）、缓解归因方面的影响，并缩短响应时间。