中文

后可查看全部文档

帮助文档

新手引导

合作注册

流量管理

业务规范

开发测试

GroMore

电商联盟

内容输出

闭环电商

财务结算

GroMore/开发测试/Gromore预览工具

Gromore预览工具

最近更新 2026-03-26 16:28:46

一、简介

聚合广告预览工具是一款可以针对接入链路、广告配置、广告样式的测试辅助工具，可以协助开发者在测试阶段校验广告请求链路是否跑通、配置信息是否正确、各ADN广告加载是否正常等信息；同时还支持SDK初始化检测、三方SDK接入信息&Adapter检测、manifest配置检测、平台单个代码位广告请求、展示并查看相关回调信息等多种能力，极大地帮助您提升聚合SDK的接入效率。聚合广告预览工具仅需要开发者前置申请使用权限，后续集成对应的SDK即可使用。

注意事项：

使用场景：GroMore SDK广告预览工具仅支持测试环节调试使用（Debug包），广告预览工具只用于对开发者进行重要接入项检测提醒，预览的广告均为测试广告，不会对线上产生影响，考虑用户体验，开发者在上线前务必将调用测试工具的相关代码删除/屏蔽
版本要求：Android 7200版本及以上，iOS 7200版本及以上
使用权限：需通过工单或联系技术支持同学申请使用权限，提供APPID开通测试工具白名单
代码位类型：支持标准代码位、服务端竞价代码位、客户端竞价代码位
预览配置

使用时需将聚合功能打开，Android打开穿山甲预览工具和M预览工具调用的方法不同，但IOS根据configuration.useMediation参数来判断，如果要使用GroMore SDK聚合预览工具，注意设置configuration.useMediation = YES
接入广告预览工具后需开启“全局广告预览模式”开关才可以加载预览测试广告

二、集成使用

1、接入测试

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

Android

参考融合SDK接入文档接入融合SDK。
从SDK压缩包中获取 tool_release.aar 包，放在工程可引用到的目录下，示例代码如下：

复制

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

复制

IOS

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

复制

鸿蒙

接入方式同穿山甲SDK广告

2、产品能力介绍

基本信息

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

示意图	检测内容
	该模块主要检测接入基本信息：手机系统：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_PHONESATE 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

Q：打开测试工具展示与文档中描述不一致

A：查看SDK是否初始化成功

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

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

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

Q：已更改预览需求，但预览工具中未更新

A：可重新初始化SDK后查看是否更新

本篇目录

示意图	页面说明
	全局广告预览模式开关：开启后可以在项目中使用测试链路加载广告。如果需要使用测试工具加载预览广告，该开关必须打开。应用中所有广告位id列表，可点击进详情页查看或编辑预览类型。
	广告位详情页：可查看当前广告位类型、素材类型、广告类型。可清除或保存更改的预览类型。预览广告样式是通过广告位中的兜底代码位预览，没有配置兜底代码位，在广告预览模块中检测不到对应广告位
	素材类型：可查看当前可选择预览的所有素材类型。目前支持的素材类型有：小图、横版大图、组图、横版视频、竖版视频、竖版大图、直播拉流广告类型：可查看当前可选择的所有广告类型。目前支持的广告类型有：小程序、落地页、快应用、下载类