测试 - iOS SDK (v4)

在 Airbridge 面板进行的 SDK 测试

您可以在 Airbridge 面板测试 Airbridge SDK 是否正常运行。请在测试前先安装 Airbridge SDK。

完成 Airbridge iOS SDK 的必要设置后,即可通过实时记录和测试网站检查 iOS SDK 是否正常运行。在测试前,请准备以下信息:

SDK 运行测试

检查 App 安装事件的收集

1. 请准备未安装您 App 的测试设备,或在测试前删除该 App。

2. 请将 SDK 日志级别 设置为 debug

3. 请在测试设备上安装 App。安装后需要启用 App,才能收集到 App 安装事件。请启用 App。

Airbridge 将首次收集的打开(Open)事件记录为安装(Install)事件。因此,如果收集到安装(Install)事件,打开(Open)事件可能不会被记录。

4. 请在 Airbridge 面板前往 [原始数据]>[App 实时记录],查看由测试设备的 IDFA 触发的事件。如果安装事件被正常收集,将显示安装(Install)事件。请注意,可能会有最长 10 分钟的延迟。

5. 如果经过足够时间后仍未在 [App 实时记录] 中查到安装(Install)事件,请在 SDK 日志中检查是否有安装事件发生。如果有,请从测试设备卸载 App 后重新安装。

如果反复无法查到安装事件,请将 SDK 日志一并发送给 CSM 咨询。如果没有指定的 CSM,请通过 [帮助] 提交请求。

检查 App 安装事件的归因

当目标事件发生时,Airbridge 开始进行 归因。App 安装是目标事件之一。通过检查 App 安装是否被正确归因,可以确认事件收集后到归因过程是否正常运行。

注意

进行测试的 App 必须提供弹出窗口,要求用户选择是否允许 ATT(App Tracking Transparency, 应用跟踪透明度)。如果无法确认用户是否允许,或者用户不允许,则无法检查 App 安装事件的归因。

1. 请准备未安装您 App 的测试设备,或在测试前删除该 App。请将 Tracking Authorize Timeout(TAT) 设置为足够长的时间。

2. 请将 SDK 日志级别 设置为 debug

3. 请在测试设备上访问 归因测试网站

4. 请输入 App 名称和 IDFA 后,点击 “Submit”。App 名称 可在 Airbridge 面板的 [设置]>[Token] 获取。

5. 点击 “Test Install Attribution” 将转到 Apple App Store。如果 Apple App Store 上的 App 未安装 Airbridge iOS SDK,则需通过连接 IDE 的方式安装带有 SDK 的 App。

6. 请在测试设备上安装 App。安装后需要启用 App,才能收集到 App 安装事件。请启用 App。在提示是否允许 ATT 时,请选择允许。

Airbridge 将首次收集的打开(Open)事件记录为安装(Install)事件。因此,如果收集到安装(Install)事件,打开(Open)事件可能不会被记录。

7. 请检查 SDK 日志。如果 App 安装事件已成功发送至 Airbridge 服务器,日志中将显示 add ABInstallEvent to queue

8. 请在 Airbridge 面板前往 [原始数据]>[App 实时记录],查看由测试设备的 IDFA 触发的事件。如果安装事件被正常收集,将显示安装(Install)事件。请注意,可能会有最长 10 分钟的延迟。

9. 请检查 App 安装事件的信息如下。只有当信息与下列相符时,才能确认归因过程正常运行。

  • Event Category:Install

  • ifa:在归因测试网站输入的 IDFA

  • attributionResult.channel:test_sdk

  • attributionResult.attributedTouchpointOriginURLhttps://abr.ge/@${YOUR_APP_NAME}/test_sdk?campaign=test_sdk_campaign&device_uuid=${YOUR_IDFA}

10. 如果经过足够时间后仍未在 [App 实时记录] 中查到安装(Install)事件,请在 SDK 日志中检查是否有安装事件发生。如果有,请从测试设备卸载 App 后重新安装。

此外,请确认是否已允许 ATT。如果已允许 ATT 但未能查到 Install 事件,请检查 TAT 时长是否充分。

如果反复无法查到安装事件,请将 SDK 日志一并发送给 CSM 咨询。如果没有指定的 CSM,请通过 [帮助] 提交请求。

信息收集测试

检查事件信息收集

您可在 Airbridge 面板或通过 SDK 日志检查事件是否按照 事件结构 被正确收集。

检查用户信息收集

提示

如果未在 Airbridge iOS SDK 设置用户信息收集,则无需以下检查。

您可在 Airbridge 面板或通过 SDK 日志检查用户信息是否按照设置被正确收集。

深度链接测试

提前准备

#{"width":"120px"}

#{"width":"240px"}

指南

#{"width":"140px"}

相关指南

HTTP 深度链接(App link)设置

- 必需设置。

- 面板设置

- 深度链接设置

URI Scheme 深度链接设置

- 必需设置。

- 面板设置

- 深度链接设置

延迟深度链接设置

- 自动设置,无需额外设置。

- 延迟深度链接设置

品牌域名设置

- 可选设置。

- 面板设置

App 安装

- 如果不测试延迟深度链接,请提前在测试设备上安装 App。

- 如果测试延迟深度链接,测试设备上不应安装 App。如果已安装,请提前卸载。

通过深度链接测试网站进行测试

1. 请在测试设备上访问 深度链接测试网站。您可以扫描下方 QR 码访问。

2. 请在 App Name 栏输入在 Airbridge 面板注册的 App 名称。App 名称可在 Airbridge 面板的 [设置]>[Token] 获取。

如果要测试特定深度链接地址,请在 Deeplink URL 栏输入 URI Scheme 深度链接。URI Scheme 深度链接具有 {YOUR_SCHEME}://... 格式。

如果要测试 品牌域名,请在 Custom Domain 栏输入品牌域名。

3. 请根据您要测试的深度链接类型,点击以下按钮之一。

请注意,延迟深度链接只能在测试设备未安装 App 的情况下进行测试。

#{"width":"120px"}

按钮

#{"width":"240px"}

说明

#{"width":"140px"}

示例

Test HTTP Deeplink Type-1

- 可以测试 https://{your_app-name}.abr.ge 格式的 HTTP 深度链接。

https://{your_app-name}.abr.ge/@{your_app-name}/test_sdk?...

Test HTTP Deeplink Type-2

- 可以测试 https://abr.ge 格式的 HTTP 深度链接。与 Test HTTP Deeplink Type-1 的地址格式不同。

https://abr.ge/@{your_app-name}/test_sdk?...

Test Scheme Deeplink

- 可以测试 URI Scheme 深度链接。

https://abr.ge/@{your_app-name}/test_sdk?...

Test Deferred Deeplink

- 可以测试延迟深度链接。

https://abr.ge/@{your_app-name}/test_sdk?...

Test Custom Domain Deeplink

- 仅在输入品牌域名时可用。

- 可以测试品牌域名。

https://{your_custom_domain}/@{your_app-name}/test_sdk?...

4. 如果深度链接打开事件被正常收集,可以在 Airbridge 面板的 [原始数据]>[App 实时记录] 中查看深度链接打开(Deeplink Open)事件。

在 [App 实时记录] 中确认深度链接打开事件后,请根据您点击的按钮,进一步检查以下项目。如果深度链接正常运行,所有项目都应符合。

问题排查

问题

解决方法

点击深度链接后,App 未启用,或 SDK 日志显示的内容与设置不符。

请参考 深度链接设置,检查深度链接设置是否正确。

点击深度链接后,App 已启用,但未跳转至设定的 App 页面。

您需要手动实现,使用户能够根据传递给 onSuccess 函数的深度链接路径进行跳转。请参考 深度链接设置

Was this page helpful?

Have any questions or suggestions?