一、简介

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

• 基础信息监测：检测应用、设备、SDK的相关信息、相关参数、权限等是否成功配置
• 广告样式预览：通过工单或在线渠道申请的对应appid的预览配置权限后，点击代码位id进入详情页自行配置要预览广告的交互类型和素材类型。

二、接入测试

1. 集成使用

1.1 Android

• 参考穿山甲SDK接入文档先接入穿山甲Android SDK；
• 从SDK压缩包中获取 tool_release.aar 包，放在工程能引用的目录下；
• 使用gradle引入本地的aar包，为了确保应用体验开发者应避免将测试工具带上线；

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

1.2 iOS

• 参考穿山甲SDK接入文档先接入穿山甲iOS SDK。
• 接入测试工具：为了确保应用体验开发者应避免将测试工具带上线
• 方式一：Pod 方式引入// 68版本pod方式 pod 'BUAdTestMeasurement', '6.8.xx' // 69版本pod方式 pod 'Ads-CN-Beta','6.9.xx', :subspecs => ['BUAdSDK', 'BUAdTestMeasurement']
• 方式二：Framework引入：从SDK压缩包中获取BUAdTestMeasurement.framework，BUAdTestMeasurement.bundle引入工程。在SDK初始化前设置debug模式

• 根据具体需求展示测试工具

1.3 鸿蒙

• 1）将平台下载的SDK包解压后获取testtool_1.x.0.har，并将testtool_1.0.0.har copy到工程中
• 2）在应用中的 oh-package.json5 中添加测试工具的依赖配置

• 3）在项目中的build-profile.json5中添加

• 4）在工程级别的build-profile.json5中配置

• 5）打开测试工具

2. 产品能力介绍

2.1 信息检测

进入测试工具首页，即可进行基础信息检测，在此页面可查看应用、设备、接入的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播放时必要）

2.2 广告预览

成功接入SDK、tools-release.aar/BUAdTestMeasurement后，可根据以下操作示例进行广告预览配置

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

2.3 加载广告

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

三、常见问题FAQ

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

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

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

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

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

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

注：其他接入问题可联系在线技术客服/工单进行处理