通用链接

通用链接是适用于 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 不允许重定向至通用链接。这意味着无法在另外的 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 来深度链接您的所有应用用户。设置取决于您在 Adjust 控制面板中配置应用的方式。

      对于 Adjust 中按平台区分的应用

      在 Adjust 控制面板中

      1. 查找 iOS 应用并选择应用的选项插入符号 (^)
      2. 选择所有设置 >(设置)> 平台 > 通用链接
      3. 复制原始通用链接
      4. 查找要包含在跟踪链接中的自定义 URI。这便是您想要将用户深度链接至安卓应用中的特定位置或登录页面。示例:​myamazingapp://super/exclusive/promotion​ 
      5. 对自定义 URI 进行编码
      6. 查找或创建需要用于跟踪推广活动的跟踪码。一个用于安卓的跟踪码,一个用于 iOS 的跟踪码。示例:abc123987xyz
      在首选文本编辑器中

      1. 添加 https:// 至您的原始通用链接   
      https://z9pm.adj.st/
      2. 添加 ? 并将由单下划线隔开的跟踪码附加至带 adjust_t 参数的 URL 
      https://z9pm.adj.st?adjust_t=abc123_987xyz
      3. 添加应用内路径(若适用)
      https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz
      4. 附加 adjust_deeplink 参数和经过编码的自定义 URI
      https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 添加其他 Adjust 参数(若适用)

      太棒了!跟踪链接现在会深度链接您的所有应用用户。

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

      选择所有设置

      选择选择平台

      选择通用链接

      找到 iOS 应用的原始通用链接。在我们的示例中,原始通用链接为 u7f3.adj.st

      确定要包含在跟踪链接中的自定义 URI。这是您应用中的特定位置或登录页面。

      以下示例中的自定义 URI 为: myamazingapp://super/exclusive/promotion

      必须对所有自定义 URI 进行编码,确保不会丢失任何数据。经过编码的 URI 显示如下::myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

      确定要用于跟踪推广活动的 Adjust 跟踪码,或为您新的推广活动创建一个 Adjust 跟踪链接。通常,您可能会创建一个用于安卓的跟踪码以及一个用于 iOS 的跟踪码。若要减少 Adjust 跟踪链接中的字符数量,您可以使用 Adjust 控制面板中生成的最低子层的跟踪链接(素材层)。

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

      将 Adjust 跟踪码附加到带 adjust_t 参数的 URL 上,并使用单下划线对跟踪码进行分隔。注意,请以 ? 作为查询字符串的开头

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

      附加 adjust_deeplink 参数和经过编码的自定义 URI。(必要时可附加其他关键值对,这些内容将随您的应用和推广活动做自定义。)

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

      在控制面板中

      1. 查找应用并选择应用的选项插入符号 (^)
      2. 选择所有设置 >(设置)平台 > 通用链接
      3. 复制您的原始通用链接 
      4. 查找要包含在跟踪链接中的自定义 URI
      5. 对自定义 URI 进行编码
      6. 查找或创建需要用于跟踪推广活动的跟踪码

      在首选文本编辑器中

      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_deeplink 参数和经过编码的自定义 URI

        https://z9pm.adj.st/my/path?adjust_t=abc123&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 添加其他 Adjust 参数(若适用)

      真棒!跟踪链接现在会深度链接您所有多平台应用的用户。
       

      用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像

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

      选择所有设置

      选择选择平台

      选择通用链接

      找到 iOS 应用的原始通用链接。在我们的示例中,原始通用链接为 u7f3.adj.st

      确定要包含在跟踪链接中的自定义 URI。这是您应用中的特定位置或登录页面。

      以下示例中的自定义 URI 为: myamazingapp://super/exclusive/promotion

      必须对所有自定义 URI 进行编码,确保不会丢失任何数据。经过编码的 URI 显示如下::myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

      确定要用于跟踪推广活动的 Adjust 跟踪码,或为您新的推广活动创建一个 Adjust 跟踪链接。若要减少 Adjust 跟踪链接中的字符数量,您可以使用 Adjust 控制面板中生成的最低子层的跟踪链接(素材层)。

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

      将 Adjust 跟踪码附加到带 adjust_t 参数的 URL 上,并使用单下划线对跟踪码进行分隔。注意,请以 ? 作为查询字符串的开头

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

      附加 adjust_deeplink 参数和经过编码的自定义 URI。(必要时可附加额外键值对,这些内容将随您的应用和推广活动做自定义。)

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

      有关此主题