在 Airbridge 面板进行的 SDK 测试

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

• 为营销人员的 Airbridge SDK 测试指南

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

测试设备的 IDFA

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，请通过 [帮助] 提交请求。

当目标事件发生时，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.attributedTouchpointOriginURL：https://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 日志检查事件是否按照 事件结构 被正确收集。

{
   ...
   "eventData": {
      ...
      "goal": {
         "category": "airbridge.ecommerce.order.completed",
         "semanticAttributes": {
            "value": 10000.0,
            "totalQuantity": 1000,
            "currency": "krw",
            "transactionID": "transaction_1",
            "products": [
               {
                  "quantity": 10,
                  "productID": "coca_1",
                  "price": 1.99,
                  "name": "Coca cola",
                  "currency": "usd",
                  "position": 1
               },
               {
                  "quantity": 5,
                  "productID": "fanta_1",
                  "price": 2.5,
                  "name": "Fanta Orange",
                  "currency": "usd",
                  "position": 2
               },
               {
                  "quantity": 1,
                  "productID": "terra_pack_1",
                  "price": 10.99,
                  "name": "Terra 12 Pack",
                  "currency": "usd",
                  "position": 3
               }
            ],
            "inAppPurchased": true
         }
      }
   },
   ...
}

提示

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

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

{
    ...
    "eventData": {
        ...
    },
    "user": {
        "externalUserID": {User ID},
        "externalUserPhone": {User Phone},
        "alias": {
            "key": {value}
        },
        "attributes": {
            "key": {value}
        },
        "isClientSideHashed": true
    },
    ...
}

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

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

若要测试特定深度链接地址，请在 Deeplink URL 栏中输入 URI Scheme 深度链接，格式应为 {YOUR_SCHEME}://...。

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

3. 请根据所需测试的深度链接类型，点击相应的按钮。

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

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

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