链接解析

对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置连接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。

请注意:
请咨询您的营销团队，决定应用是否需要链接解析。随后，您就可以针对不同用例设置链接解析域了。

工作原理

仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。

链接解析工作原理：

  1. 当现有用户点击重定向链接时，iOS 会打开您的应用。
  2. 应用将重定向 URL 传送至 Adjust SDK 中的 resolveLinkWithUrl 链接解析方法。
  3. Adjust SDK 中的连接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种：
  • 域不匹配 - 方法会按原样返回深度链接 URL。
  • 域匹配 - 方法解析链接并返回解析所得的深度链接

在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向 (redirect)，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。

  1. 您的应用收到返回的 URL，打开并向用户展示深度链接内容。应用也会使用返回的 URL 在 Adjust SDK 中调用 appWillOpenUrl 方法，这样，已解析的 URL 就会发送给 Adjust 后台用于跟踪。
请注意:
如果未安装应用的用户点击了重定向 URL，那么 iOS 就会以正常网页 URL 方式进行处理，将用户重定向至 App Store。链接解析不适用这种情况。

使用案例

下列情况中适用链接解析：

电子邮件营销

电邮营销人员开展推广时，电邮营销平台会通过其自有的点击跟踪重定向 URL 包装所有链接。这样，电邮营销人员就能在平台上看到点击数据。不过，如果电邮中包含通用链接，那么重定向 URL 会导致 iOS 无法正确解析通用链接。

电邮营销平台

关键术语

电邮服务提供商 (ESP)

关键术语

电子邮件合作伙伴

关键术语

设置

  1. 在您的域上创建专门用于电子邮件跟踪的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，我们推荐您重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的电邮重定向域。

示例：email.example.com。

  1. 在 Xcode 中向您的 Associated Domain (关联域) 配置添加电邮重定向域。 示例：​ applinks:email.example.com

  2. 设置您的通用链接。

  3. 确保已向resolveLinkWithUrl 链接解析方法的 resolveUrlSuffixArray 添加了您的电邮重定向域。

  4. 在您的电邮营销平台/ESP 端将电邮重定向域配置为自定义跟踪域。

  5. 设置内容分发网络 (content delivery network，简称 CDN)，如 Amazon CloudFront、CoudFlare 或 Fastly，处理传入电邮重定向域的请求。请在 CDN 上进行下列设置：

    1. SSL 证书 - iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。
    2. AASA (Apple-App-Site-Association) 文件 - 您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。

    您可以为通用链接下载托管在该路径上的 AASA 文件：https://example.go.link/.well-known/apple-app-site-association。请将该路径的域变更为您的通用链接域。您可以复制 Adjust 通用链接 AASA 文件，用于电邮重定向域 AASA 文件。 如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 就要通过电邮重定向域的相应路径提供该文件：https://email.example.com/.well-known/apple-app-site-association 3. 将电邮重定向域的所有传入请求 (适用情况下 AASA 文件除外) 导向电邮合作伙伴的重定向服务器。 示例：​ redirect.example.net

  6. 进行 DNS 配置，让电邮重定向域指向 CDN。

请访问我们帮助中心的 ESP 集成版面，了解与上述操作对应的具体合作伙伴操作说明。

电邮服务合作伙伴支持​

要使用链接解析，您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 (或子域)。在这种情况下，您可以将合作伙伴的重定向服务指向您自己的自定义域。

示例：​

  • Braze - 根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。

  • Iterable - Iterable 的 URL 重定向服务支持自定义域。

  • Mailchimp - Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。

示例

URL 缩短服务

有时，营销人员需要在特定类型的推广活动用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，好在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会正确解析通用链接。

设置

  1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，我们依旧推荐您重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。

  2. 在 Xcode 中向您的 Associated Domain (关联域) 配置添加短 URL 域。 示例：​ applinks:short.example.com

  3. 设置您的通用链接。

  4. 确保已向resolveLinkWithUrl 链接解析方法的 resolveUrlSuffixArray 添加了您的电邮重定向域。

  5. 设置支持通用链接的 URL 缩短服务。请注意：Adjust 不提供任何 URL 缩短服务。 示例：​ short.io

  6. 在短 URL 生成服务平台上，将短 URL 生成域配置为自定义域。您需要进行 DNS 配置，才能让短 URL 生成域指向短 URL 生成服务的服务器。(在 short.io 中添加自定义域的参考文档)。

  7. 在 URL 缩短服务中配置通用链接。(在 short.io 中设置通用链接的参考文档)。

示例