在 Airbridge 面板进行的 SDK 测试
您可以在 Airbridge 面板测试 Airbridge SDK 是否正常运行。请在测试前先安装 Airbridge SDK。
完成 Airbridge iOS SDK 的必要设置后,即可通过实时记录和测试网站检查 iOS SDK 是否正常运行。在测试前,请准备以下信息:
App 名称:可在 Airbridge 面板的 [设置]>[Token] 中获取。
App SDK Token:可在 Airbridge 面板的 [设置]>[Token] 中获取。
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 日志检查事件是否按照 事件结构 被正确收集。
您可在 Airbridge 面板的 [原始数据]>[App 实时记录] 中,查看以下信息:
Event Category:可在 eventData.goal.category
中查看。
Event Action:可在 eventData.goal.action
中查看。
Event Label:可在 eventData.goal.label
中查看。
Event Value:可在 eventData.goal.value
中查看。务必确认购买事件中的 Event Value 被正确收集。
Semantic Attribute:可在 eventData.goal.semanticAttributes
中查看。
Custom Attribute:可在 eventData.goal.customAttributes
中查看。
如果未进行 Hybrid App 设置,App 中 WebView 环境发生的事件会被记录为 Web 事件,这可能影响归因结果。在检查 WebView 环境中的事件收集前,请先完成 Hybrid App 设置。
可以通过 SDK 日志检查事件是否正确发送至 Airbridge 服务器。同时,SDK 日志也可用于问题排查。
问题 | 解决方法 |
---|---|
未输出 | 请检查是否在调用事件发送函数。 |
未输出 | 请检查网络状态是否支持将数据发送到外部服务器。 |
输出了 | Airbridge 面板的 [实时记录] 可能会有最长 10 分钟的延迟。 此外,1 MB 或以上大小的事件 Payload 无法正常收集,请将事件 Payload 调整到 1 MB 以下。 |
{
...
"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 日志检查用户信息是否按照设置被正确收集。
您可在 Airbridge 面板的 [原始数据]>[App 实时记录] 中,查看以下信息:
用户信息:可在 user
块中查看。收集的用户信息必须包含在 user
块中。
Client request: method={method} url={url} header={header} body={pretty printed json body}
:用于检查用户信息是否成功发送至服务器。
User data is modified: user={user json}
:用于检查现有用户信息是否发生变更。
{
...
"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 深度链接。URI Scheme 深度链接具有 {YOUR_SCHEME}://...
格式。
如果要测试 品牌域名,请在 Custom Domain 栏输入品牌域名。
3. 请根据您要测试的深度链接类型,点击以下按钮之一。
请注意,延迟深度链接只能在测试设备未安装 App 的情况下进行测试。
按钮 |
说明 |
示例 |
---|---|---|
Test HTTP Deeplink Type-1 | - 可以测试 |
|
Test HTTP Deeplink Type-2 | - 可以测试 |
|
Test Scheme Deeplink | - 可以测试 URI Scheme 深度链接。 |
|
Test Deferred Deeplink | - 可以测试延迟深度链接。 |
|
Test Custom Domain Deeplink | - 仅在输入品牌域名时可用。 - 可以测试品牌域名。 |
|
4. 如果深度链接打开事件被正常收集,可以在 Airbridge 面板的 [原始数据]>[App 实时记录] 中查看深度链接打开(Deeplink Open)事件。
在 [App 实时记录] 中确认深度链接打开事件后,请根据您点击的按钮,进一步检查以下项目。如果深度链接正常运行,所有项目都应符合。
如果点击了 Test HTTP Deeplink Type-1,请在 SDK 日志检查:
eventData.deeplink
应为 https://{YOUR_APP_NAME}.abr.ge...
。
{YOUR_SCHEME}://main...
被传递给深度链接回调函数。
如果在深度链接测试网站输入了 Deeplink URL,传递给深度链接回调函数的信息将被更改。例如,输入 {YOUR_SCHEME}://path
时,传递的是 ${YOUR_SCHEME}://path...
。
如果点击了 Test HTTP Deeplink Type-2,请在 SDK 日志检查:
eventData.deeplink
应为 https://{YOUR_APP_NAME}.airbridge.io...
。
{YOUR_SCHEME}://main...
被传递给深度链接回调函数。
如果在深度链接测试网站输入了 Deeplink URL,传递给深度链接回调函数的信息将被更改。例如,输入 {YOUR_SCHEME}://path
时,传递的是 ${YOUR_SCHEME}://path...
。
如果点击了 Test Scheme Deeplink,请在 SDK 日志检查:
eventData.deeplink
应为 {YOUR_SCHEME}://main...
。
{YOUR_SCHEME}://main...
被传递给深度链接回调函数。
如果在深度链接测试网站输入了 Deeplink URL,传递给深度链接回调函数的信息将被更改。例如,输入 {YOUR_SCHEME}://path
时,传递的是 ${YOUR_SCHEME}://path...
。
如果点击了 Test Deferred Deeplink,请在 SDK 检查:
eventData.deeplink
应为 {YOUR_SCHEME}://main...
。
{YOUR_SCHEME}://main...
被传递给深度链接回调函数。
如果在深度链接测试网站输入了 Deeplink URL,传递给深度链接回调函数的信息将被更改。例如,输入 {YOUR_SCHEME}://path
时,传递的是 ${YOUR_SCHEME}://path...
。
如果点击了 Test Custom Domain Deeplink,请在 SDK 日志检查:
eventData.deeplink
应为 https://{YOUR_CUSTOM_DOMAIN}...
。
{YOUR_SCHEME}://main...
被传递给深度链接回调函数。
如果在深度链接测试网站输入了 Deeplink URL,传递给深度链接回调函数的信息将被更改。例如,输入 {YOUR_SCHEME}://path
时,传递的是 ${YOUR_SCHEME}://path...
。
Was this page helpful?