在 Airbridge 面板进行的 SDK 测试

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

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

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

测试设备的 IDFA

App 安装是 Airbridge iOS SDK 自动收集的事件，无需单独设置也能收集到 App 安装事件。

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

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

AirBridge.setLogLevel(.LOG_ALL)
AirBridge.getInstance("YOUR_APP_SDK_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

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

Airbridge 将首次收集的 App 打开（Open）事件记录为 App 安装（Install）事件。因此，如果已经收集到 App 安装事件，App 打开事件可能不会被记录。

4. 请前往 Airbridge 面板的 [原始数据]>[App 实时记录]，搜索测试设备的 IDFA。如果 App 安装事件被正常收集，您将看到 Install 事件。请注意，可能会有最长 10 分钟的延迟。

5. 如果经过充分时间后仍未在 [App 实时记录] 中查到 Install 事件，请在 SDK 日志中检查是否有 App 安装事件发生。如果有，请卸载 App 后重新安装。

如果反复无法查到 Install 事件，请联系您的 CSM。

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

注意

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

1. 请准备未安装您 App 的测试设备，或在测试前删除该 App。请将 Tracking Authorize Timeout 设置为充分的时长。

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

AirBridge.setLogLevel(.LOG_ALL)
AirBridge.getInstance("YOUR_APP_SDK_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

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

4. 请在 App Name 栏输入 App 名称、在 Device UUID（GAID or IDFA）栏输入 IDFA 后，点击 Submit。App 名称 可在 Airbridge 面板的 [设置]>[App 设置] 获取。

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

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

Airbridge 将首次收集的 App 打开（Open）事件记录为 App 安装（Install）事件。因此，如果已经收集到 App 安装事件，App 打开事件可能不会被记录。

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

8. 请前往 Airbridge 面板的 [原始数据]>[App 实时记录]，搜索测试设备的 IDFA。如果 App 安装事件被正常收集，您将看到 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 事件，请卸载 App 后重新安装。

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

如果反复无法查到 Install 事件，请联系您的 CSM。

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

通过 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 iOS SDK 收集用户 ID、邮箱等用户信息，有助于更丰富地使用 Airbridge，例如与第三方解决方案集成。

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

通过 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 名称，包括大小写。

如果要测试更改后的深度链接地址，请在 Deeplink URL 栏输入 Scheme 深度链接。Scheme 深度链接具有 {YOUR_SCHEME}://... 格式。

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

请点击 Submit 以继续。

3. 点击下方任意按钮将触发深度链接打开（Deeplink Open）事件。请根据您要测试的深度链接类型，点击以下按钮之一。

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

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

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