中文
登录
后可查看全部文档
开发测试/常见问题接入指南说明/测试工具配置&接入指南/SDK广告预览工具
SDK广告预览工具
最近更新 2025-01-20 15:32:18

注意事项

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

工具介绍

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

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

接入测试

注意事项
  • 需确认当前SDK版本号,Android/iOS SDK版本需在66xx版本及以上才可使用
  • 需通过平台在线IM、工单或联系商务同学申请使用权限,提供APPID开通测试工具白名单
  • 集成使用

    Android
    1. 参考穿山甲SDK接入文档,app先接入穿山甲SDK。
    2. 从SDK zip文件中获取 tool_release.aar 包,放在工程能引用到的目录下。
    3. 使用gradle引入本地的aar包,开发者应避免将测试工具带上线,不然可能会影响应用的体验
    复制
    1. 在任意位置添加Listener,调起测试工具,进入测试工具主页面:
    复制
    iOS
    1. 参考穿山甲SDK接入文档,app先接入穿山甲SDK。
    2. 接入测试工具
      1. 方式一:Pod 方式引入
    复制
      1. 方式二:Framework引入,从SDK zip文件中获取BUAdTestMeasurement.framework, BUAdTestMeasurement.bundle引入工程。
    1. 在SDK初始化前设置debug,开发者应避免将测试工具带上线,不然可能会影响应用的体验。
    复制
    1. 根据具体需求展示测试工具
    复制

    产品能力介绍

    信息检测

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

    示意图

    检测内容

    手机系统: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、tools.aar后,可根据以下操作示例进行广告预览配置

    示意图

    页面说明

    • 全局广告预览模式开关:开启后可以在项目中使用测试链路加载广告。
    • 如果需要使用测试工具加载预览广告,该开关必须打开。
    • 应用中所有代码位id列表,可点击进详情页查看或编辑预览类型。


    • 代码位详情页:可查看当前代码位类型、素材类型、广告类型。
    • 可清除或保存更改的预览类型。



    • 素材类型:可查看当前可选择预览的所有素材类型。
    • 广告类型:可查看当前可选择的所有广告类型。
    加载广告

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

    其他

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

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

    常见问题FAQ

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

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


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

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


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

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


    本篇目录
    联系我们