
- GroMore SDK广告预览工具仅支持测试环节调试使用(Debug包)
- 使用时需将聚合功能打开,Android打开穿山甲预览工具和M预览工具调用的方法不同,但IOS根据configuration.useMediation参数来判断,如果要使用GroMore SDK聚合预览工具,注意设置configuration.useMediation = YES
- 广告预览工具检测/显示的相关信息,只用于对开发者进行重要接入项检测提醒,预览的广告均为测试广告,不会对线上产生影响
- 开发者在测试结束后,上线前务必将调用测试工具的相关代码删除/屏蔽,以免对应用体验产生影响
- SDK版本要求:Android 7200版本及以上,iOS 7200版本及以上
- 接入广告预览工具后需开启“全局广告预览模式”开关才可以加载预览测试广告
聚合广告预览工具是一款可以针对接入链路、广告配置、广告样式进行测试的工具,可以协助开发者在测试阶段校验:广告请求链路是否跑通、配置信息是否正确、各ADN广告加载是否正常等信息;同时还支持SDK初始化检测、三方SDK接入信息&Adapter检测、manifest配置检测、平台单个代码位广告请求、展示并查看相关回调信息等多种能力,极大地帮助您提升聚合SDK的接入效率。聚合广告预览工具仅需要开发者前置申请使用权限,后续集成对应的SDK即可使用。
需确认当前SDK版本号,Android/iOS SDK版本需在72xx版本及以上才可使用
需通过平台在线IM、工单或联系商务同学申请使用权限,提供APPID开通测试工具白名单
注意:需在收到聚合SDK初始化成功void success()回调后再使用测试工具
注意:聚合测试工具数据不做本地缓存,当退出再进入工具时,代表重新开始测试过程。
进入测试工具首页,即可进行基础信息检测,在此页面可查看应用、设备、已接入SDK的相关信息,开发者可根据显示信息检测接入信息是否正确。
示意图 | 检测内容 |
该模块主要为接入信息监测,根据config中ADN配置信息,进行三方联盟SDK接入状态判定 ①当未接入对应SDK时,显示红色图标/文字:未接入/未找到 ②当已接入对应ADN SDK时,显示绿色图标/文字:已接入/ADN版本号 手机系统:Android/iOS SDK版本号:当前SDK版本号 应用名称:当前应用在穿山甲平台的名称 AppID:当前应用在穿山甲平台的ID 系统版本:当前设备Android系统版本设备厂商 imei:设备唯一标识符 oaid:安卓匿名id environment:项目编译环境、 androidld:APP获取的系统唯一标识 | |
SDK初始化:检测SDK初始化是否成功 代码混淆:检测是否进行了代码混淆配置 provider(Required):检测是否进行了provider配置 隐私配置:检测相关隐私权限是否配 IS_CAN_USE_LOCATION GET_TT_LOCATION IS_CAN_USE_PHONESTATE GET_DEV_IMEI IS_CAN_USE_WIFI_STATE IS_CAN_USE_WRITE_EXTERNAL GET_DEV_OAID | |
直播配置:插件安装状态:检测直播插件是否安装成功直播插件版本号:直播插件安装成功后,获取插件版本号直播SDK初始化状态:检测直播SDK是否初始化成功直播初始化时版本号 权限配置:检测相关权限是否配置 INTERNET(必要权限) READ_PHONE_STATE ACCESS_NETWORK_STATE WRITE_EXTERNAL_STORAGE ACCESS_WIFI_STATE ACCESS_COARSE_LOCATION REQUEST_INSTALL_PACKAGES GET_TASKS ACCESS_FINE_LOCATION WAKE_LOCK(使用textureView播放时必要) | |
组件接入详情 ①当未接入对应SDK时,显示红色图标/文字:未接入/未找到 ②当已接入对应ADN SDK时,显示绿色图标/文字:已接入/ADN版本号 |
成功接入SDK、tools-release.aar/BUAdTestMeasurement后,可根据以下操作示例进行广告预览配置
示意图 | 页面说明 |
全局广告预览模式开关:开启后可以在项目中使用测试链路加载广告。 如果需要使用测试工具加载预览广告,该开关必须打开。应用中所有广告位id列表,可点击进详情页查看或编辑预览类型。 | |
广告位详情页:可查看当前广告位类型、素材类型、广告类型。可清除或保存更改的预览类型。 预览广告样式是通过广告位中的兜底代码位预览,没有配置兜底代码位,在广告预览模块中检测不到对应广告位 | |
素材类型:可查看当前可选择预览的所有素材类型。 广告类型:可查看当前可选择的所有广告类型。 |
示意图 | 页面说明 |
在Gromore测试列表页中,可以看到广告位下的所有代码位,并查看其测试状态,包括: 未测试:没有测试过,或者已经开始测试但仅完成加载,没有展示广告的状态。 失败:任一代码位出现填充失败。可以onAdFailedToLoad回调定义原因,如:①代码位问题:平台填写错误、代码位和渲染类型不匹配等;②底价过高;③网络错误。 已测试:代码位成功完成加载和展示。 | |
点击具体的广告位进入详情页后,点击广告测试区域的“加载广告”及“展示广告”,即可进行广告测试。在详情页内可以查看广告加载成功 / 失败的具体信息,包括: 加载失败时,可以看到三方ADN返回的错误码和错误信息; 展示成功后,可以看到三方ADN返回的Prime_rit和CPM。 |
在预览测试工具中打开全局广告预览模式开关,并配置好需要预览的广告后。可以调用广告load方法加载广告。具体可查看SDK接入文档。
目前支持的素材类型有:小图、横版大图、组图、横版视频、竖版视频、竖版大图、直播拉流
目前支持的广告类型有:小程序、落地页、快应用、下载类
问题:打开测试工具展示与文档中描述不一致
解决:查看SDK是否初始化成功
问题:配置预览但提示“预览流量不合法,请检查代码位是否在测试状态,填写预览的广告是否在白名单中”
解决:预览配置可能不正确或已失效,可重新联系配置同学更换预览配置,或提供抓包进行排查,抓包域名为:
https://api-access**/ad_union_qa/sdk/get_ads?**
问题:已更改预览需求,但预览工具中未更新
解决: 可重新初始化SDK后查看是否更新
注:其他接入问题可联系在线技术客服/工单,加入预览工具社群进行高效处理
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点