语言 

通用链接

通用链接是适用于 iOS 9 及更高版本的特定深度链接协议。

下文将介绍如何利用通用链接设置、测试和跟踪推广活动。

操作前须知

以下是您在操作前需要了解的内容。

要求

实用信息

  • 通用链接的构造方式与先前版本的 iOS,以及其他移动平台上使用的自定义 URL 方案不同。
  • 原始通用链接是不附加参数、应用内路径和键值对的通用链接。原始通用链接是在 Adjust 控制面板上生成的。
  • 要查找或创建原始通用链接,请在控制面板中按照下列步骤进行操作: 所有设置 > 平台 > iOS > 通用链接

设置通用链接

在 Adjust 控制面板中启用通用链接

  1. 导航到应用,点击应用的选项插入符号 (^)。
  2. 选择 所有设置​ > (设置) 平台​ 。
  3. 输入应用的 iOS BUNDLE ID​ (由 Apple App Store 分配)。
  4. 选择 通用链接​ 。
  5. 输入 APP PREFIX​ (载于 Apple 开发者账户摘要中) 和 APP SCHEME​ (由应用开发者决定)。
  6. 所有字段填写完成后,会显示一个原始通用链接。示例:http://z9pm.adj.st
  7. 选择 保存

将原始通用链接提交给您的应用开发者以继续集成过程。

导航到应用,点击您应用选项上的 ^ 符号

1/7

在应用中为通用链接添加支持

如需在应用中将特定于应用的子域加入白名单,请将原始通用链接发送给应用开发者。开发者可以按照我们 Github 开发者指南中的说明进行操作,或参阅 Apple 开发者文档了解更多信息。

利用 iOS 深度链接跟踪推广活动

您可以使用以下方式将用户深度链接至 iOS 应用中:

  • 通用链接
  • Javascript 通用链接
  • Adjust 跟踪链接 + deep_link 参数

如需针对 iOS 9 + 推广活动使用带跟踪链接和 deep_link 参数的深度链接,请务必在控制面板和 Xcode 项目中设置通用链接。设置后,Adjust 便能将跟踪链接转换为通用链接,将其发送给设备并打开应用。

最佳的链接方法能支持您的广告环境,用户能够在其中与您的广告进行交互。

在这里,您可以了解最适合您推广活动的设置。

广告环境推荐

Chrome 浏览器

通用链接 跟踪链接 + deep_link 参数

Safari 浏览器通用链接 跟踪链接 + deep_link 参数
Facebook Newsfeed通用链接 Javascript 通用链接 跟踪链接 + deep_link 参数

注意:必须附加路径
Facebook 浏览器通用链接 Javascript 通用链接 跟踪链接 + deep_link 参数

Facebook Messenger

通用链接 Javascript 通用链接 跟踪链接 + deep_link 参数

注意:必须附加路径

Facebook Messenger 浏览器通用链接

Javascript 通用链接(附加路径) 跟踪链接 + deep_link 参数(附加路径)
Instagram跟踪链接 + deep_link参数

注意:通用链接必须在应用中实施

Gmail

通用链接 (Universal Link)

Apple Mail

通用链接

跟踪链接 + deep_link 参数

Slack

通用链接 (Universal Link)

WhatsApp

通用链接

跟踪链接 + deep_link 参数

Snapchat 消息

通用链接

Javascript 通用链接

跟踪链接 + deep_link 参数

注意:必须附加 js 标记

SFSafariViewController 深度链接

通用链接

Javascript 通用链接

注意:必须附加 js 标记

警告:
以下应用环境不支持通用链接:Pinterest、Telegram、Twitter 以及微信

创建通用链接

附加了 Adjust 跟踪链接的原始通用链接是通用链接的标准格式。标准格式的通用链接简短、整齐,并能在 Web 推广活动中使用。

未附加跟踪链接的原始通用链接仅适用于装有 iOS 9+ 并已安装应用的用户。

重要提示:
iOS 不允许在 Safari 之外重定向至通用链接。这意味着无法在另外的 URL 中包装通用链接。如果您希望包装通用链接,请使用我们的 JSR 解决方案

深度链接生成器

如需设置通用链接,您可以使用我们的深度链接生成器。这将帮您节约时间,避免错误。

要找到深度链接生成器,请在 Adjust 控制面板中选择 菜单 > 深度链接生成器​ 。

手动设置

如需手动设置通用链接,请按以下步骤操作。

导航到应用,选择应用的选项插入符号 (^)

1/12

在 Adjust 控制面板中

  1. 找到应用,选择应用选项插入符号 (^)。
  2. 选择 所有设置​ > (设置) 平台​ > 通用链接​ 。
  3. 复制 原始通用链接​ 。
  4. 查找或创建需要使用的跟踪链接。
  5. 复制跟踪码

在首选文本编辑器中

  1. 添加 https:// 至您的原始通用链接。

    https://z9pm.adj.st/
  2. 添加一个 ?并将跟踪码附加至带有 adjust_t 参数的 URL。

    https://z9pm.adj.st/?adjust_t=abc123
  3. 添加应用内路径 (若适用)。

    https://z9pm.adj.st/my/path?adjust_t=abc123
  4. 添加其他任何 Adjust 参数 (若适用)。

    https://z9pm.adj.st/my/path?adjust_t=abc123&adjust_campaign=Getaway_Vacation_Campaign_2-0&adjust_adgroup=35-42&adjust_creative=island_sunset

太棒了!您的通用链接可以使用了。

添加应用内路径

如果您的通用链接路径已包含查询参数,请避免使用 ? 附加 Adjust 参数。如果 URL 中使用了两个 ? 字符,第二个 ? 之后的任何信息都会被浏览器移除;如果尚未安装应用,则可能会导致 HTTP 404 错误。您可以使用下方的示例来确认设置,或查看我们的故障排查指南获取更多信息。

正确示例:https://z9pm.adj.st/my?path=location&client=name&adjust_t=abc123

错误示例:https://z9pm.adj.st/my?path=location&client=name?adjust_t=abc123

使用动态回传参数

如果您想在通用链接中发送 动态回传参数,请 不要 在参数前添加 adj_ 前缀。该前缀意味着此参数未被 Adjust 后端记录,并通过回传发送。请按照下方推荐设置进行操作。

DCP 设置​ :请 不要 在通用链接的参数前添加 adj_ 前缀。

示例:

下方是附加了示例 DCP 参数的一个通用链接。参数使用占位符 {dcp_example_parameter}。

https://abcd.adj.st/?adjust_t=abc123&example_parameter=such_value

创建多平台通用链接

多平台通用链接会利用单个 Adjust URL 来深度链接您的所有应用用户。使用我们的深度链接生成器,可轻松简便地进行设置。

要创建多平台通用链接,请首先确定您的 iOS 和安卓应用使用的是否为相同的路径和查询参数,从而确定要使用的格式。

下一步,请确认您的安卓 App Scheme 已经保存在 Adjust,该信息是用来打开应用的 URL 前缀,可在您的应用中进行配置,且根据移动平台 (iOS 和安卓) 的不同而有所差异。示例:my_android_app://

在控制面板中

  1. 查找您的安卓应用,选择应用的选项插入符号 (^)。
  2. 选择 所有设置 > (设置) 平台​ 。
  3. 输入您的 App Scheme​ 。
  4. 选择 保存

请注意:用户点击通用链接时,Adjust 始终会在转到商店之前尝试进行用户深度链接。只要应用的控制面板设置中保存有安卓 App Scheme,这种行为就不会改变。要立刻将安卓用户转到商店,请不要在控制面版设置中保存安卓 App Scheme。

iOS 和安卓应用的路径和查询参数相同

如果安卓和 iOS 应用的深度链接目的地拥有同样的路径和查询参数,请使用下列通用链接格式。

适用于 Adjust 中按平台区分的应用:

https://[原始通用链接]/[路径]?adjust_t=[IOS_跟踪链接]_[安卓跟踪链接]&[ADJUST 参数]

示例:
https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz

适用于在 Adjust 中配置为多平台的应用

https://[原始通用链接]/[路径]?adjust_t=[跟踪链接]&[ADJUST参数]

示例:
https://z9pm.adj.st/my/path?adjust_t=abc123

iOS 和安卓应用的路径和查询参数不同

如果安卓和 iOS 应用的深度链接目的地拥有不同的路径和查询参数,请使用下列通用链接格式。

请注意:使用这种格式时,即便您在控制面板中保存有安卓 App Scheme,Adjust 也会将用户深度链接至您指定的目的地。

适用于 Adjust 中按平台区分的应用:

https://[原始通用链接]/[IOS 通用链接路径]?adjust_t=[IOS_跟踪链接]_[ANDROID 跟踪链接]&adjust_deeplink=[经过编码的安卓 APP SCHEME + 路径]&[ADJUST 参数]

示例:
https://z9pm.adj.st/my/path&adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

适用于在 Adjust 中配置为多平台的应用

https://[原始通用链接]/[IOS 通用链接路径]?adjust_t=[跟踪链接]&adjust_deeplink=[经过编码的安卓 APP SCHEME + 路径]&[ADJUST 参数]

示例:
https://z9pm.adj.st/my/path&adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

创建 Javascript 通用链接

当点击和 HTTP 重定向发生在受支持的环境之外(例如,在电子邮件推广活动中)时,则会使用 Javascript 通用链接。通常,通用链接在这种情况下会受损并将所有用户发送至应用商店,即使用户已安装应用。

必须在应用和控制面板设置通用链接后,JSR 才能发挥作用。

对于 iOS 11 及更高版本

如需添加 JSR 链接参数至跟踪链接,请按以下步骤操作。

  1. 找到想要使用的通用链接。示例:https://ab12.adj.st/?adjust_t=abc123
  2. 对通用链接进行编码。
  3. 将经过编码的通用链接附加在此内容之后:https://app.adjust.com/jsr?url=

示例:

https://app.adjust.com/jsr?url=https%3A%2F%2Fab12.adj.st%2F%3Fadjust_t%3Dabc123

对于 iOS 10.3 及更早的版本

对于 Safari webview 或 iOS 11 之前版本中的用户,您可以将以下标记添加到 JSR 通用链接中:adjust_deeplink_js=1。此标记起着后备作用,提示需要通过方案打开的链接,并将用户重定向至应用商店(如果他们没有安装应用)或邀请他们在应用中打开该页面的弹出窗口。

示例:

https://app.adjust.com/jsr?url=https%3A%2F%2F6s45.adj.st%2F%3Fadjust_t%3D1uhwo6%26adjust_deeplink_js%3D1

归因来自 Safari Smart App Banner 的用户

Safari Smart App Banner 会自动确定用户的设备是否支持您的应用;如果不支持,则不会显示。点击横幅后,Safari Smart App Banner 则会检测用户设备上是否已安装应用。如果已安装,用户则会被深度链接至指定的应用内页面。如果未安装,则首先将用户转至 App Store 以下载并安装应用,然后再进行深度链接。

如需为 Smart App Banner 设置点击归因,请将您的深度链接添加至横幅 HTML 标签的 app-argument 参数。

完整的横幅如下所示:

<meta name="apple-itunes-app" content="app-id=myAppStoreID, affiliate-data=myAffiliateData, app-argument=myapp://landing_page" id="sl-md34a5">

有关设置 Smart App Banner 的更多信息,请查看 Apple 开发者指南

注意:​ 只有在用户已经安装该应用的情况下,Adjust 才会将安装再归因于 Safari Smart App Banner。在重新定向至应用商店后才下载应用的用户会被归因为 organic (自然量),或其他有效归因来源。

测试通用链接

如需查看通用链接设置是否正确,请在不同场景对其进行测试。因为通用链接必须在 Safari 或 Chrome 中打开,所以请将链接设置在浏览器环境中进行测试。如果在测试过程中遇到问题,请查看我们的故障排查指南获取更多信息。

作为现有用户

如需作为现有用户测试通用链接,请按以下步骤操作。

  1. 创建一个测试设备可以轻松访问的测试网页。
  2. 将原始通用链接添加至测试网页。
  3. 将完整的通用链接添加至测试网页。
  4. 使用 TestFlight 在设备上加载新的应用版本,或使用 xCode 安装应用的调试版本。然后,在浏览器中打开测试网页。
  5. 点击通用链接。安装新的应用版本后,您便会被自动深度链接到自己的应用。

如果应用已安装并在正确的页面上自动打开,则表示您可以用其来跟踪推广活动了。

如果应用未打开,请点击原始通用链接,以验证集成是否正确 (示例:https://z9pm.adj.st)。如果链接失败并返回 HTTP 404 错误 URL 未找到,请重新阅读我们的集成说明

注意:如需测试 JSR 链接,其最佳做法是在需要进行推广活动的环境中测试。

作为新用户(延迟深度链接)

如需作为新用户测试通用链接,请按以下步骤操作。

  1. 将应用从设备中完全卸载 (若适用,请清空应用垃圾)。
  2. 通过 Adjust 控制面板中的测试控制台来清除设备。
  3. 创建一个测试设备可以轻松访问的测试网页。
  4. 将通用链接添加至测试网页。
  5. 将通用链接跟踪码添加至测试网页。
  6. 点击深度链接跟踪链接,然后等待重定向至应用商店。
  7. 下载并打开应用 — 此操作会在 Adjust 中触发一次安装。
  8. 应用打开后,您将被深度链接到写入自定义 URI 方案中的特定位置。

如果您在应用打开后被转至正确位置,则表示已完成 Adjust 设置。

如果您的通用链接不适用于已卸载的应用,但适用于已安装的应用,请查看 Adjust 控制面板中输入的 App Scheme 是否正确。选择 所有设置 > 平台 > 通用链接​ 即可查看此设置。