注意事项

• SDK广告预览工具仅支持测试环节调试使用（Debug包）
• 广告预览工具检测/显示的相关信息，只用于对开发者进行重要接入项检测提醒，预览的广告均为测试广告，不会对线上产生影响
• 开发者在测试结束后，上线前务必将调用测试工具的相关代码删除/屏蔽，以免对应用体验产生影响
• SDK版本要求：6600版本及以上版本
• 接入广告预览工具后需开启“全局广告预览模式”开关才可以加载预览测试广告
• 仅支持竞价类型为【标准】的代码位

工具介绍

穿山甲SDK广告预览工具主要可以解决开发者在接入测试时，因平台策略导致的无广告填充问题，以及无法查看广告各类素材展示效果，导致无法满足测试需求，影响测试进度的问题。广告预览工具仅需要开发者前置申请使用权限，后续集成对应的SDK即可使用。

工具包含SDK基础信息检测功能、穿山甲广告预览功能。基础信息检测：1、检测应用、设备、SDK的相关信息；2、检测相关参数、权限等是否成功配置。SDK广告预览：通过工单或IM渠道申请的对应appid的预览配置权限后，可以在点击代码位id进入详情页自行配置要预览广告的交互类型和素材类型。

接入测试

注意事项

集成使用

Android

1. 参考穿山甲SDK接入文档，app先接入穿山甲SDK。
2. 从SDK zip文件中获取 tool_release.aar 包，放在工程能引用到的目录下。
3. 使用gradle引入本地的aar包，开发者应避免将测试工具带上线，不然可能会影响应用的体验

4. 在任意位置添加Listener，调起测试工具，进入测试工具主页面：

iOS

1. 参考穿山甲SDK接入文档，app先接入穿山甲SDK。
2. 接入测试工具
1. 方式一：Pod 方式引入

1. 方式二：Framework引入，从SDK zip文件中获取BUAdTestMeasurement.framework, BUAdTestMeasurement.bundle引入工程。
3. 在SDK初始化前设置debug，开发者应避免将测试工具带上线，不然可能会影响应用的体验。

4. 根据具体需求展示测试工具

产品能力介绍

信息检测

进入测试工具首页，即可进行基础信息检测，在此页面可查看应用、设备、接入的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_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、tools-release.aar/BUAdTestMeasurement后，可根据以下操作示例进行广告预览配置

示意图	页面说明
	全局广告预览模式开关：开启后可以在项目中使用测试链路加载广告。 如果需要使用测试工具加载预览广告，该开关必须打开。 应用中所有代码位id列表，可点击进详情页查看或编辑预览类型。
	代码位详情页：可查看当前代码位类型、素材类型、广告类型。 可清除或保存更改的预览类型。
	素材类型：可查看当前可选择预览的所有素材类型。 广告类型：可查看当前可选择的所有广告类型。

加载广告

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

其他

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

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

常见问题FAQ

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

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

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

解决：预览配置可能不正确或已失效，可重新联系配置同学更换预览配置，或提供抓包进行排查，抓包域名为：https://api-access**/ad_union_qa/sdk/get_ads?**

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

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

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