对比项 | 测试工具(旧版) | 可视化测试工具 |
测试粒度 | 针对单App单设备维度进行测试,无法聚焦到代码位维度 | 支持查看代码位维度请求信息与具体回调 |
测试内容 | 仅支持查看单次瀑布流请求成功与否 | 支持查看各ADN SDK版本,Adapter版本,Manifest等信息,帮助归因问题 |
测试工具(旧版)内嵌在Gromore SDK内部,不需要做额外接入。
*注:Gromore SDK3200及以上版本不再支持测试工具(旧版)
若您的GroMoreSDK版本在2.7.0.0或以上,完成瀑布流配置后,您就可以通过可视化测试工具验证您应用的广告配置。
相比内嵌在聚合中的旧版自测工具,通过接入可视化自测工具,您可以一站式查看:
代码位类型 | ADN | 支持可视化测试的GroMore SDK版本 |
标准代码位 | 所有 | GroMore SDK 2700及以上版本 |
服务端竞价 | 穿山甲 | 安卓GroMore sdk 2700及以上版本 iOS GroMore sdk 2910及以上版本 |
服务端竞价 | Mintegral/Sigmob | GroMore SDK 3300及以上版本 |
客户端竞价 | 自定义ADN | GroMore SDK 3210及以上版本 |
请按照以下步骤接入可视化测试工具。
2.2.1 运行环境配置及说明
2.2.2 可视化测试工具引入
1. 在app中的build.gradle中添加:
2. 进行测试工具代码混淆,在proguard-rules.pro添加:
3. GroMore SDK初始化后,调用如下方法,开启可视化测试工具:
4. 可视化测试工具不进行本地数据缓存,若您退出后重新进入工具,代表重新开始测试。
2.3.1 运行环境配置及说明
2.3.2 可视化测试工具引入
1. 在app中的podfile添加:
2. GroMore SDK初始化后,调用如下方法,开启可视化测试工具:
*返回值为BOOL,当启动成功,返回YES。否则,为NO。
3. 退出可视化测试工具,请调用如下方法,测试工具会对GroMore数据进行还原,否则GroMore数据还原将依赖App关闭:
4. 可视化测试工具不进行本地数据缓存,若您退出后重新进入工具,代表重新开始测试。
*建议安卓设备优先选择imei,IOS设备优先选择idfa。
*在使用可视化测试工具进行测试前,请先完成广告位创建和ADN添加。
4. 右侧的界面可以查看已经创建完毕的测试工具:您可以点击顶部的Tab,在『可视化测试工具』和『旧版测试工具』间进行切换。
*新创建的测试工具将在5分钟后生效,24小时后失效; 测试前,请注意检查对应测试工具的状态。
【注意】:Gromore SDK3200及以上版本不再需要在平台配置任何内容,但仍需先完成广告位创建和ADN添加。
使用对应的设备打开需进行测试的应用,进入聚合测试工具首页,即可以实现以下功能:
*推荐使用Android 10以下 / iOS 14以下设备进行测试,测试前需要开启“设备信息权限” (安卓),“广告追踪权限”(iOS)
1. 查看组件整体接入情况:
根据config中的ADN配置信息列表,可以在列表页中查看对应的ADN SDK是否接入:
- 当未接入对应ADN SDK时,显示红色文字:未接入
- 当已接入对应ADN SDK时,显示绿色文字:已接入
点击具体的ADN进入详情页后,可以查看GroMore SDK和对应ADN的细节信息。
*百度 SDK 和Admob SDK较为特殊,通过API获取的版本号和其官方对外宣称的版本号不符,请您线下单独确认相关SDK引入的版本是否正确。
2. 查看广告位加载情况
如上图,在广告位列表页中,可以看到应用下的所有代码位,并查看其测试状态,包括:
- 未测试:没有测试过,或者已经开始测试但仅完成加载,没有展示广告的状态;
- 测试失败:任一代码位出现填充失败。可以onAdFailedToLoad回调定义原因,如:
- 代码位问题:平台填写错误、代码位和渲染类型不匹配等;
- 底价过高;
- 网络错误。
- 测试成功:代码位成功完成加载和展示。
点击具体的广告位进入详情页后,点击广告测试区域的“加载广告”及“展示广告”,即可进行广告测试。
在详情页内可以查看广告加载成功 / 失败的具体信息,包括:
- 加载失败时,可以看到三方ADN返回的错误码和错误信息;
- 展示成功后,可以看到三方ADN返回的Prime_rit和CPM。
1. 选择GroMore-测试工具tab,选择创建测试工具,在弹窗中选择旧版测试工具;
2. 选择并填写设备ID、填写设备名称、选择需要测试的广告网络和应用后,点击确定即可创建测试配置;
3. 测试配置启用约5分钟后,在终端设备上即可请求到该广告平台的线上广告。
使用测试工具(旧版)前,请注意:
1. 确保聚合平台有有效的waterfall配置作为测试数据源,且waterfall内还有需要测试的ADN;
2. 完成平台配置,确认ADN选择和测试设备信息录入无误;
3. 使用配置的测试设备安装聚合SDK Demo(或自己接入聚合SDK的Demo)进行测试;
4. 测试结果或信息会以Toast弹窗的形式展现在屏幕上。测试完成后,请删除测试设备,避免线上Toast弹出场景。
测试toast提示信息说明:
单个Rit填充成功 eg:"fill_suceess, test_adn:gdt,slot_id:1080958885885321"
单个Rit填充失败 eg:"test error_adn:gdt error_slot_id:1080958885885321 error_code:1111 error_message:error_message"
测试成功(广告最终展示) eg: "test_success,test_adn:gdt ,slot_id:1080958885885321"
聚合配置无效 eg:"slot setting error, 穿山甲 default ads will be displayed"
Android端
获取Android ID(推荐)
*需将GroMore SDK 版本升级至2700及以上
获取IMEI
- 技术方案:
- 直接调用对接接口获取imei信息:
- 实用方案:在测试设备上打开 设置-系统-手机相关设置,可以直接获取该设备的imei号,如果存在两个imei, 可以分别在平台上做尝试
- oaid相关信息需要调用接入的oaidSDK获取
iOS端
- 技术方案:在#import <AdSupport/AdSupport.h>库中,调用[[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];获取对应的设备id
- 实用方案:在苹果商店下载一个myIDFA相关的app,通过此类app查看本机的idfa信息
Appsflyer提供的DeviceID获取工具
https://play.google.com/store/apps/details?id=com.appsflyer.android.deviceid
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock