中文
登录
后可查看全部文档
开发测试/常见问题接入指南说明/广告测试工具集合/GroMore SDK聚合预览工具
GroMore SDK聚合预览工具
最近更新 2025-10-16 10:57:23

注意事项

  • 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开通测试工具白名单

集成使用

Android
  1. 参考融合SDK接入文档,app先接入融合SDK。
  2. 从SDK zip文件中获取 tool_release.aar 包,放在工程可引用到的目录下,示例代码如下:
复制

注意:需在收到聚合SDK初始化成功void success()回调后再使用测试工具

复制
IOS
  1. 本工具可运行于iOS 11系统及以上,但仅限于测试阶段使用,请于上线前移除测试工具相关模块。
  2. 本工具是针对单独广告位 & 单独代码位进行测试的,仅做广告正常展示、回调正常展示内容的确认。依赖聚合SDK,但不影响聚合SDK。
  3. 在工程中导入:BUAdTestMeasurement.xcframework,在SDK初始化成功success回调后,调用如下示例方法,开启聚合预览测试工具。

注意聚合测试工具数据不做本地缓存,当退出再进入工具时,代表重新开始测试过程。

复制

产品能力介绍

基本信息

进入测试工具首页,即可进行基础信息检测,在此页面可查看应用、设备、已接入SDK的相关信息,开发者可根据显示信息检测接入信息是否正确。

示意图

检测内容

该模块主要为接入信息监测,根据config中ADN配置信息,进行三方联盟SDK接入状态判定

当未接入对应SDK时,显示红色图标/文字:未接入/未找到

当已接入对应ADN SDK时,显示绿色图标/文字:已接入/ADN版本号

手机系统:Android/iOS

SDK版本号:当前SDK版本号

应用名称:当前应用在穿山甲平台的名称

AppID:当前应用在穿山甲平台的ID

系统版本:当前设备Android系统版本设备厂商

imei:设备唯一标识符

oaid:安卓匿名id

environment:项目编译环境、

androidld:APP获取的系统唯一标识

SDK初始化:检测SDK初始化是否成功

代码混淆:检测是否进行了代码混淆配置

providerRequired):检测是否进行了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测试

示意图

页面说明

在Gromore测试列表页中,可以看到广告位下的所有代码位,并查看其测试状态,包括:

未测试:没有测试过,或者已经开始测试但仅完成加载,没有展示广告的状态。

失败:任一代码位出现填充失败。可以onAdFailedToLoad回调定义原因,如:①代码位问题:平台填写错误、代码位和渲染类型不匹配等;②底价过高;③网络错误。

已测试:代码位成功完成加载和展示。

点击具体的广告位进入详情页后,点击广告测试区域的“加载广告”及“展示广告”,即可进行广告测试。在详情页内可以查看广告加载成功 / 失败的具体信息,包括:

加载失败时,可以看到三方ADN返回的错误码和错误信息;

展示成功后,可以看到三方ADN返回的Prime_rit和CPM。

加载广告

在预览测试工具中打开全局广告预览模式开关,并配置好需要预览的广告后。可以调用广告load方法加载广告。具体可查看SDK接入文档。

其他

目前支持的素材类型有:小图、横版大图、组图、横版视频、竖版视频、竖版大图、直播拉流

目前支持的广告类型有:小程序、落地页、快应用、下载类

常见问题FAQ

问题:打开测试工具展示与文档中描述不一致

解决:查看SDK是否初始化成功

问题:配置预览但提示“预览流量不合法,请检查代码位是否在测试状态,填写预览的广告是否在白名单中”

解决:预览配置可能不正确或已失效,可重新联系配置同学更换预览配置,或提供抓包进行排查,抓包域名为:

https://api-access**/ad_union_qa/sdk/get_ads?**

问题:已更改预览需求,但预览工具中未更新

解决: 可重新初始化SDK后查看是否更新

注:其他接入问题可联系在线技术客服/工单,加入预览工具社群进行高效处理




本篇目录
联系我们