测试深度链接

在使用深度链接的推广活动正式上线前,请务必测试您的链接,以确保:

  • 链接已正确设置。
  • 连接能将用户转到预期内容界面。
  • Adjust 正常开展跟踪。

操作前须知

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

  • Adjust SDK 环境设为 sandbox,日志级别设为 verbose (详细)。
  • 在 Xcode 中创建并运行应用。
  • 向营销团队索取示例深度链接。
    • 示例:https://example.com/summer-clothes?promo=beach

创建测试跟踪链接

要测试深度链接实装是否正确,请创建测试跟踪链接。为此,请进行下列操作:

  1. 登录 Adjust 控制面板。
  2. 在应用概览界面找到您的应用。
  3. 在应用选择卡底部点击插入符号 ( ^​ )。
  4. 选择 所有设置​ 。此时会打开侧栏菜单。
  5. 从侧栏菜单中选择 跟踪链接​ 。
  6. 选择 添加跟踪链接
  7. 输入您选择的 跟踪链接名称​ 。
  8. 渠道​ 菜单中选择 --无--​ 。
  9. 点击 自定义​ ,打开自定义菜单。
  10. 选择 归因设置​ 。
  11. 找到 基于点击的归因​ 部分,将 概率模型​ 设为 ​ ,
  12. 选择 应用​ 。

请在深度链接中附加从营销团队那里收到的跟踪码。

示例:https://example.go.link/summer-clothes?promo=beach&adj_t=abc123

测试直接深度链接

您可以测试下列通用链接配置:

  • Adjust 通用链接
  • 电邮重定向和短 URL 通用链接

检查通用链接域配置

重要提示:
如果在浏览器中直接输入通用链接,那么 iOS 就不会以深度链接的形式打开通用链接。您需要以超链接的形式点击通用链接。

请按照下列步骤操作,检查通用链接域配置。

  1. 打开 iOS 测试设备,将通用链接粘贴进 Apple 备忘录。
  2. 在 Apple 备忘录中长按并以 iOS 菜单方式打开通用链接。如果出现 " (您的应用) 中打开​ " 选项,说明 iOS 已成功关联您的应用和域。

如果该选项未出现,请参考下列说明查找问题。

Adjust 通用链接

电邮重定向和短 URL 通用链接

在应用中测试直接深度链接

使用测试设备,在应用关闭和后台运行情况下分别测试直接深度链接。

应用已关闭

  1. 将通用链接复制粘贴至 Apple 备忘录。
  2. 点击 home 按钮两次。如果应用处于打开状态,向上滑动将其关闭。
  3. 打开 Apple 备忘录​ 。
  4. 点击通用链接。

此时,应用应当打开并显示深度链接内容。如果未打开应用中的正确页面,请参考下列清单排查问题:

  • 检查深度链接中的路径或参数是否出错,例如用两个 ? 符号替代了&

  • 检查应用是否它通过下列方法正确处理深度链接:

    • 应用不使用场景 - application(_:continue:restorationHandler:) 方法
    • 应用使用场景 - scene(_:continue:) 方法
  • 请仔细检查,确保代码中没有干扰深度链接的其他内容。

  • 如果您设置了通用链接重定向,请仔细检查,确保重定向配置无误。

  • 请检查链接解析方法是否配置正确,确保已向 resolveUrlSuffixArray 添加了电邮重定向域或短 URL 生成域。

选择深度链接后,您的应用会调用 Adjust SDK 中的 AppWillOpen 方法,此时,您就会在 Xcode 日志中看到与下方类似的记录:

2022-09-28 09:19:30.873598+0900 example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900 example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900 example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900 example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900 example[1619:241845]  [Adjust]v: source   deeplink

如果 Xcode 日志中没有上述类似记录,请确保:

  • Adjust SDK 中的环境已设为 sandbox,日志级别设为 verbose (详细)。

    • Xcode 日志中的 [Adjust]v 即代表详细记录。
  • 您的应用在接收深度链接的方法中调用 appWillOpen 方法。

应用在后台运行

  1. 将通用链接复制粘贴至 Apple 备忘录。
  2. 点击 home 按钮两次。
  3. 通过应用图标打开应用。
  4. 点击 home 按钮两次,打开 Apple 备忘录​ 。
  5. 点击通用链接。

此时,应用应当显示深度链接内容。如果未打开应用中的正确页面,请参考下列清单排查问题:

  • 检查应用是否它通过下列方法正确处理深度链接:
    • 应用不使用场景 - application(_:continue:restorationHandler:) 方法
    • 应用使用场景 - scene(_:continue:) 方法

选择深度链接后,您的应用会调用 Adjust SDK 中的 AppWillOpen 方法,此时,您就会在 Xcode 日志中看到与下方类似的记录:

2022-09-28 09:19:30.873598+0900 example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900 example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900 example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900 example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900 example[1619:241845]  [Adjust]v: source   deeplink

如果 Xcode 日志中没有上述类似记录,请确保:

  • Adjust SDK 中的环境已设为 sandbox,日志级别设为 verbose (详细)。

    • Xcode 日志中的 [Adjust]v 即代表详细记录。
  • 您的应用在接收深度链接的方法中调用 appWillOpen 方法。

测试带有自定义 URL 方案的直接深度链接

使用测试设备,测试在应用关闭/后台运行情况下带有自定义 URL 方案的直接深度链接。

找到 Apple Notes,选择通用链接。此时,应用应当打开并显示深度链接内容。

如果应用未打开,请检查下列项:

  • 您已经在 Xcode 中正确配置了 URL 方案。
  • 如果您测试的是应用的 debug 版本,请检查您是否使用了 debug 或 release 自定义 URL 方案。

如果未打开应用中的正确页面,请参考下列清单排查问题:

  • 检查深度链接中的路径或参数是否出错,例如用两个 ? 符号替代了&

  • 检查应用是否它通过下列方法正确处理深度链接:

    • 应用不使用场景 - application(_:continue:restorationHandler:) 方法
    • 应用使用场景 - scene(_:continue:) 方法
  • 请仔细检查,确保代码中没有干扰深度链接的其他内容。

选择深度链接后,您的应用会调用 Adjust SDK 中的 AppWillOpen 方法,此时,您就会在 Xcode 日志中看到与下方类似的记录:

2022-09-28 09:19:30.873598+0900 example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900 example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900 example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900 example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900 example[1619:241845]  [Adjust]v: source   deeplink

如果 Xcode 日志中没有上述类似记录,请确保:

  • Adjust SDK 中的环境已设为 sandbox,日志级别设为 verbose (详细)。

    • Xcode 日志中的 [Adjust]v 即代表详细记录。
  • 您的应用在接收深度链接的方法中调用 appWillOpen 方法。

测试延迟深度链接

要在测试设备上测试延迟深度链接,请按照下列步骤操作:

  1. 安装应用。
  2. 从您的 Xcode 日志中调取 Adjust 设备标识符 (ADID)。示例:
2022-09-28 09:19:35.609913+0900 example[1619:241847] [Adjust]v: Response: {"app_token":"2eb2na2w54c3","adid":"4446ab34861b99b78ee374c3bd38a350","timestamp":"2022-09-28T00:19:35.841Z+0000","message":"Attribution found","attribution":{"tracker_token":"abc123","tracker_name":"Organic","network":"Organic"}}
  1. 打开测试控制台,输入 Adjust ADID,然后选择 查看设备数据​ 。TrackerName 应当显示为 Organic(自然量)

    • 否则,请重复这些步骤:
    1. 卸载应用。
    2. 在测试控制台中,点击遗忘设备。
    3. 安装应用。
  2. 卸载应用。

  3. 在测试控制台中,将设备清除。

  4. 将您的通用链接或自定义 URL 方案深度链接粘贴进 Apple 备忘录。

  5. 点击深度链接。此时,您应当被重定向至 App Store。

  6. 从本地版本安装应用。请勿从应用商店安装。

  7. 打开应用。此时,应用应当打开并显示深度链接内容。

如果未打开应用中的正确页面,请参考下列清单排查问题:

  • 请仔细检查,确保代码中没有干扰深度链接的其他内容。示例:您的应用有新客户引导界面,或需要用户进行登录,但在打开深度链接前并没有完成这些操作的处理。此时,您就需要实装 adjustDeeplinkResponse 方法,在处理深度链接前完成新客户引导界面或用户登录。

  • 您的应用代码无法在 adjustDeeplinkResponse 方法中正确处理传入的深度链接。

  • Adjust 未能将安装归因至点击。打开测试控制台,选择 查看设备数据​ 。TrackerName 字段中应当显示您的测试跟踪链接。在开始测试前,请确保已进行下列操作:

    • 测试跟踪链接已启用概率模型。
    • 在测试控制台中,TrackerName 已设为 Organic
  • 检查您的链接格式。对于通用链接,可以使用如下格式: https://example.go.link/summer-clothes?promo=beach&adj_t=abc123

    • 对于自定义 URL 方案链接,则需要创建 Adjust 跟踪 URL。请按照如何设置深度链接中的说明进行操作。