- SDK广告预览工具仅支持测试环节调试使用(Debug包)
- 广告预览工具检测/显示的相关信息,只用于对开发者进行重要接入项检测提醒,预览的广告均为测试广告,不会对线上产生影响
- 开发者在测试结束后,上线前务必将调用测试工具的相关代码删除/屏蔽,以免对应用体验产生影响
- SDK版本要求:6600版本及以上版本
- 接入广告预览工具后需开启“全局广告预览模式”开关才可以加载预览测试广告
穿山甲SDK广告预览工具主要可以解决开发者在接入测试时,因平台策略导致的无广告填充问题,以及无法查看广告各类素材展示效果,导致无法满足测试需求,影响测试进度的问题。广告预览工具仅需要开发者前置申请使用权限,后续集成对应的SDK即可使用。
工具包含SDK基础信息检测功能、穿山甲广告预览功能。基础信息检测:1、检测应用、设备、SDK的相关信息;2、检测相关参数、权限等是否成功配置。SDK广告预览:通过工单或IM渠道申请的对应appid的预览配置权限后,可以在点击代码位id进入详情页自行配置要预览广告的交互类型和素材类型。
进入测试工具首页,即可进行基础信息检测,在此页面可查看应用、设备、接入的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.aar后,可根据以下操作示例进行广告预览配置
示意图 | 页面说明 |
![]() |
|
![]() |
|
![]() |
|
在测试工具中打开全局广告预览模式开关,并配置好需要预览的广告后。可以调用广告load方法加载广告。具体可查看SDK接入文档。
目前支持的素材类型有:小图、横版大图、组图、横版视频、竖版视频、竖版大图、直播拉流
目前支持的广告类型有:小程序、落地页、快应用、下载类
问题:打开测试工具展示与文档中描述不一致
解决:查看SDK是否初始化成功
问题:配置预览但提示“预览流量不合法,请检查代码位是否在测试状态,填写预览的广告是否在白名单中”
解决:览配置可能不正确或已失效,可重新联系配置同学更换预览配置,或提供抓包进行排查,抓包域名为:https://api-access**/ad_union_qa/sdk/get_ads?**
问题:已更改预览需求,但预览工具中未更新
解决: 可重新初始化SDK后查看是否更新
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点