Android自测工具集成说明-测试工具配置&接入指南-常见问题接入指南说明-开发测试-穿山甲广告平台

帮助中心

中文

后可查看全部文档

帮助文档

新手引导

合作注册

流量管理

开发测试

财务结算

业务规范

GroMore

增长参谋

成长工具

开发测试/常见问题接入指南说明/测试工具配置&接入指南/Android自测工具集成说明

Android自测工具集成说明

最近更新 2023-03-15 14:42:15

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

一、产品简介

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

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

二、测试工具接入流程

参考穿山甲SDK接入文档，app先接入穿山甲SDK。
从接入zip中获取 tool_release.aar 包，放在工程能引用到的目录下。
使用gradle引入本地的aar包，例如：

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

三、测试工具使用指南

1.测试功能的使用

1.1 基础信息检测（首页）

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

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

1.2 全局配置检测

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

示意图

检测内容

SDK初始化：检测SDK初始化是否成功代码混淆：检测是否进行了代码混淆配置provider（Required）：检测是否进行了provider配置权限配置：检测相关权限是否配置INTERNET（必要权限）READ_PHONE_STATEACCESS_NETWORK_STATEWRITE_EXTERNAL_STORAGEACCESS_WIFI_STATEACCESS_COARSE_LOCATIONREQUEST_INSTALL_PACKAGESGET_TASKSACCESS_FINE_LOCATIONWAKE_LOCK（使用textureView播放时必要）隐私配置：检测相关隐私权限是否配IS_CAN_USE_LOCATIONGET_TT_LOCATIONIS_CAN_USE_PHONESTATEGET_DEV_IMEIIS_CAN_USE_WIFI_STATEIS_CAN_USE_WRITE_EXTERNALGET_DEV_OAID

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

1.3.1 代码位基础信息检测

	示意图	检测内容
代码位检测(一级页面)		在这个页面可以看到所有已接入的代码位（广告位）id，点击选择对应代码位id，可进入对应的代码位详情页
代码位详情页（二级页面）		代码位名称代码位ID参数配置：检测开发者配置的代码位请求参数（请求广告之后能显示）请求素材宽请求素材高请求广告次数：一次请求的广告条数设置请求广告类型：可选择配置需要预览的测试广告类型，进行特定广告预览选择广告类型：选择穿山甲提供的测试广告类型进行预览手动输入：若穿山甲提供的测试广告类型无法满足测试要求，可根据需要申请建立对应的测试广告，由穿山甲侧提供新建的测试广告aid、cid，进行特定测试广告预览

1.3.2 定向预览特定类型测试广告

使用接入测试工具预览广告流程

图例

1.3.3 测试广告预览相关说明（重要）

测试广告位在穿山甲平台上，必须是测试状态才能进行广告预览
手动输入的测试广告aid、cid，必须是经过申请配置通过后，才能正常预览（需BD向PM申请）
穿山甲提供了五种类型的测试广告，为了保证测试效果，请根据测试广告位类型选择对应可支持的测试素材进行预览

测试广告类型	支持的素材类型	可支持预览的广告位类型
落地页-表单提交Playable（试玩广告，只支持在激励视频广告位预览、只支持横板视频素材）下载-商店直投下载-直接下载下载-落地页下载调起类	竖版视频	draw视频、激励视频、全屏视频
	竖版大图	开屏
	横版大图	信息流、banner、插屏
	小图	信息流、banner、插屏
	组图	信息流、banner、插屏
	横版视频	信息流、draw视频、激励视频、全屏视频

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

本篇目录