English
Log In
You can then view all documents
Installation/常见问题接入指南说明/SDK Test Device/Android自测工具集成说明
Android自测工具集成说明
Last updated 2023-03-15 14:42:15

注意事项:

  1. 穿山甲开发者接入测试工具,仅支持开发者在接入穿山甲SDK时,在测试状态下进行调用
  2. 测试工具检测/显示的相关信息,只用于对开发者进行重要接入项检测提醒,使用测试工具预览的广告均为测试广告,不会产生任何线上影响
  3. 开发者在测试结束后,上线前切记将调用测试工具的相关代码删除/屏蔽,以免对应用体验产生影响
  4. SDK版本要求:3702及以上版本


一、产品简介

在接入阶段,通过测试工具进行接入过程必要操作check,提高开发者接入测试的效率:

  • 基础信息检测:检测应用、设备、sdk的相关信息
  • 全局配置检测:检测相关参数、权限等是否成功配置
  • 代码位检测:检测测试代码位的基础信息、设置测试代码位需要请求展示的广告类型

二、测试工具接入流程

  1. 参考穿山甲SDK接入文档,app先接入穿山甲SDK。
  2. 从接入zip中获取 tool_release.aar 包,放在工程能引用到的目录下。
  3. 使用gradle引入本地的aar包,例如:
复制
  1. 在任意位置添加Listener,调起测试工具,进入测试工具主页面:
复制

三、测试工具使用指南

1.测试功能的使用

1.1 基础信息检测(首页)

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

示意图

检测内容

工具-1.png

SDK版本号:接入的SDK的版本
测试应用:应用包名
AppID:测试应用对应的应用商店ID
设备ID:did(预览广告之后才能显示)
os_version:操作系统_版本
manufacturer:设备制造商
imei:设备唯一标识符
oaid:安卓匿名id
environment:系统支持的最小sdk版本号和最大sdk版本号

1.2 全局配置检测

进入全局配置检测页面,可检测sdk初始化后必要的参数是否配置,根据检测结果,检查必要/重要参数是否已配置正确,提高接入的准确性

示意图

检测内容

工具-2.png
工具3.png

SDK初始化:检测SDK初始化是否成功
代码混淆:检测是否进行了代码混淆配置
provider(Required):检测是否进行了provider配置
权限配置:检测相关权限是否配置
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播放时必要)
隐私配置:检测相关隐私权限是否配
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

1.3 代码位检测(定向预览特定类型测试广告)


1.3.1 代码位基础信息检测


示意图

检测内容

代码位检测(一级页面)

工具4.png

在这个页面可以看到所有已接入的代码位(广告位)id,点击选择对应代码位id,可进入对应的代码位详情页

代码位详情页(二级页面)

工具5.png
工具6.png

代码位名称
代码位ID
参数配置:检测开发者配置的代码位请求参数(请求广告之后能显示)
请求素材宽
请求素材高
请求广告次数:一次请求的广告条数
设置请求广告类型:可选择配置需要预览的测试广告类型,进行特定广告预览
选择广告类型:选择穿山甲提供的测试广告类型进行预览
手动输入:若穿山甲提供的测试广告类型无法满足测试要求,可根据需要申请建立对应的测试广告,由穿山甲侧提供新建的测试广告aid、cid,进行特定测试广告预览

1.3.2 定向预览特定类型测试广告
  • 使用接入测试工具预览广告流程


工具7.png
  • 图例
工具8.png
1.3.3 测试广告预览相关说明(重要)
  • 测试广告位在穿山甲平台上,必须是测试状态才能进行广告预览
  • 手动输入的测试广告aid、cid,必须是经过申请配置通过后,才能正常预览(需BD向PM申请)
  • 穿山甲提供了五种类型的测试广告,为了保证测试效果,请根据测试广告位类型选择对应可支持的测试素材进行预览

测试广告类型

支持的素材类型

可支持预览的广告位类型

落地页-表单提交
Playable(试玩广告,只支持在激励视频广告位预览、只支持横板视频素材)
下载-商店直投
下载-直接下载
下载-落地页下载
调起类

竖版视频

draw视频、激励视频、全屏视频

竖版大图

开屏

横版大图

信息流、banner、插屏

小图

信息流、banner、插屏

组图

信息流、banner、插屏

横版视频

信息流、draw视频、激励视频、全屏视频

  • 退出定向预览测试广告,需要返回测试工具,将配置的aid、cid信息清除,否则一致拉取的测试广告都是测试广告
  • 上线前check:在测试阶段结束后,切记需要将调用测试工具的代码删除/屏蔽才能上线


Contents
Contact us