- 04 Feb 2024
- 1 分钟阅读
- 打印
- 黑暗模式白天模式
SDK 集成测试
- 更新于 04 Feb 2024
- 1 分钟阅读
- 打印
- 黑暗模式白天模式
SDK 集成测试工具
在 Tenjin 面板上,你可以通过 SDK Live Event Tool,来测试 SDK 的集成是否正确。向 Tenjin 发送事件时,可使用 Tenjin SDK 实时调试事件工具调试事件是否按预期触发。通过测试设备(向实时调试工具)发送的任何事件都不会记录在面板报告中。
SDK 实时事件工具可在面板这里找到。
如何使用 SDK 测试工具
详细信息
要开始使用该工具从你的应用中实时调试和跟踪事件,需要以下几个步骤:
点击此处添加你的测试设备,点击 Test Devices 。
点击 + New Test Device 来新增测试设备以验证应用是否正常向 Tenjin 发送事件。
选择你的 App 并输入你的测试设备 ID。 具体查询设备 ID 的办法,请依据测试手机的不同生产厂商,自行上网搜索。(iOS 平台为IDFA或IDFV;安卓平台为GAID ,全称 Google advertising ID,中文为广告 ID,只要手机有 Google 的服务框架,就有 GAID;安卓中国及海外华为如无 GAID,请输入 OAID)。
跳转至 SDK Live tool ,打开 App,确保已经集成 Tenjin SDK 并已经提交设备 ID。正常运行的话你会看到下面的截图中类似的内容,如果你刚刚完成设备注册,需要等15-20分钟才能触发。如果超过30分钟依旧没有显示,则说明你的 SDK 集成有问题,请你的技术团队检查,并严格按照文档进行 SDK 集成。
在面板上检查 SDK 集成状态
详细信息
测试没有问题后,Tenjin 的控制面板同样可让你实时查看 SDK 是否已经正确集成。你可以从 Apps 标签页中选择要集成的应用程序,查看所有相关事件,以确保正确的设置。绿色的 received 表明我们已经收到相关事件。
你可以看到 App 的版本,会话,ASA,ILRD 、带收据的内购,以及正确出发的所有自定义事件。
SDK 集成检查清单
详细信息
在提交 App 之前,请务必严格遵循清单进行 SDK 集成,避免不必要的麻烦,降低数据出现问题的可能性。
如果您正在使用 Test Flight 应用程序,即使注册了 'advertising_id',也无法在 SDK Live event 实时事件测试工具中看到事件。这是因为 Apple 的政策要求每一次用户打开应用时,Test Flight 都要使用新的 advertising_id。
App open 事件
确保你能看到 App open 事件。App open事件将在 SDK 初始化时自动触发,具体事件数量级别取决于你的 App 所处的生命周期。
ASA 追踪数据 (iOS)
Tenjin 可以自动由 SDK 获取 Apple Search 追踪数据。不需要添加额外的广告计划设置(如追踪链接,回调等)。集成指引: Tenjin iOS SDK
Android Referrer Install
Android referrer 可以在广告 ID 不存在的时候用来追踪。请参见一下:
- 确保已集成 Google’s Install Referrer Library。
dependencies {
implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
implementation 'com.android.installreferrer:installreferrer:{version}'
}
- 内购
Tenjin 有6种 purchase_states,沙盒(sandbox)账号产生的的应用内购对应的是 purchase_state = 4. 只有 purchase_state 0 或 3 会显示在控制面板上,所以用使用测试工具对内购进行验证非常重要(沙盒内购交易可以在 SDK 集成测试工具中显示)。应用内购的数值可以有小数。
内购上报时,请确保币种、价格、产品号码及数量准确无误的传递到 Tenjin. 例如,你可以测试用不同的币种如 Yen/USD/CAD 来测试内购,并查看测试工具即时收到的记录。
不同的内购状态如下:
0 = UNKNOWABLE 未知 (没收到收据的上报,所以没法与应用商店验证内购的真实性)
1 = UNVERIFIED 未验证(收到收据上报,但是与应用商店验证时发生错误)
2 = FRAUDULENT 可疑(可疑交易)
3 = VERIFIED 已验证(收据经过应用商店验证)
4 = SANDBOX 沙盒交易(沙盒测试)
5 = DUPLICATE 重复交易(重复交易,与历史交易的 transaction_id 重复)
6 = STALE (内购发生在3天前,非实时)
订阅收入(如有)
自定义事件
确保你看到所有自定义事件正确名称和数值。
- Ad Mediation Impressions 展示级收益数据
Tenjin 支持从以下平台接收 Impression Level Ad Revenue (ILRD,展示层级广告变现) 数据:
- AppLovin
- IronSource
- HyperBid
- AdMob
- TopOn
此功能允许接收与广告收入相对应的事件,用于分析各项广告对变现的影响。
展示层级收益数据为付费功能,如有需要请联系你的客户经理或者发邮件至 support@tenjin.com 启用此功能。