通用链接

通用链接是适用于 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. 选择保存
将原始通用链接提交给您的应用开发者以继续集成过程。
 

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

选择所有设置

选择平台

选择通用链接

输入应用的 iOS BUNDLE ID(由 Apple App Store 分配)

输入APP PREFIX(载于 Apple 开发者账户摘要中) 

输入 APP SCHEME(由应用开发者决定)

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

如需在应用中将特定于应用的子域加入白名单,请将原始通用链接发送给应用开发者。开发者可以按照我们 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 控制面板中选择菜单 > 深度链接生成器

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

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

      选择所有设置

      选择平台

      选择通用链接

      在这个示例中,原始通用链接为:u7f3.adj.st

      确定要用于跟踪推广活动的 Adjust 跟踪码,或为您新的推广活动创建一个 Adjust 跟踪链接。(此识别码应为最低层级分类,如您 Adjust 推广活动结构参数中所定义)。为找到现有跟踪码,请导航到应用并选择应用的选项插入符号 (^)...

      然后选择跟踪链接

      本示例中的跟踪码为:bkrn68

      在纯文本文件中,将 https:// 添加到您的原始通用链接中

      将 Adjust 跟踪码和参数 adjust_t 一起添加到这个的 URL 上。注意,请以 ? 作为请求字符串的开头

      添加应用内路径(若适用)

      必要时可附加额外重要参数匹配,这些内容将自定义至您的应用和推广活动。


      在 Adjust 控制面板中
      1. 查找应用并选择应用的选项插入符号 (^)
      2. 选择所有设置 >(设置)平台 > 通用链接
      3. 复制原始通用链接
      4. 查找或创建需要使用的跟踪链接
      5. 复制跟踪码
      在首选文本编辑器中

      1. 添加 https:// 至您的原始通用链接 
      https://z9pm.adj.st/
      2. 添加一个 ? 并将跟踪码附加至带有 adjust_t 参数的 URL
      https://z9pm.adj.st/?adjust_t=klm012
      3. 添加应用内路径(若适用) 
      https://z9pm.adj.st/my/path?adjust_t=klm012
      4. 添加其他任何 Adjust 参数(若适用) 
      ​https://z9pm.adj.st/my/path?adjust_t=klm012&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=klm012

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

      创建多平台通用链接

      多平台通用链接会利用单个 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">
      

      有关设置 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 是否正确。选择所有设置 > 平台 > 通用链接即可查看此设置。

      有关此主题