Skip to main content

Android 自测工具接入文档

注意事项#

  1. 游可赢开发者接入自测工具,旨在开发者接入游可赢SDK后,帮助开发者对接入的关键事项进行检查,并在测试状态下进行调试。
  2. 测试工具中显示的各项信息,仅用于对开发者进行重要接入项检测提醒。自测工具中展示的广告均为测试广告,不会对现网环境产生任何影响。
  3. 在自测工具使用完毕后,开发者切记要将与测试工具相关的代码删除,以免对即将发布的应用产生不必要的影响。
  4. 该工具仅用于sdk接入调试阶段使用,切勿集成上线,以免与sdk重复采集用户信息导致的用户信息采集合规风险。

一、工具简介#

在接入游可赢SDK时,开发者通过自测工具对接入过程中的必要操作进行检查,可以提升接入测试的效率。 自测工具包括以下功能:

  • 基础信息:显示设备,接入应用及系统的相关信息。
  • 接入检测:检测相关参数、必要权限和隐私项是否配置成功。
  • 广告测试:对不同类型的广告信息及样式进行预览。

二、测试工具接入流程#

  • 开发者先参考游可赢SDK接入文档,将SDK对应功能集成到应用中。
  • 在app/build.gradle中dependencies中引入klevinAdTest:
implementation "com.tencent.klevin:KlevinAdTest:1.3"
  • 在合适的位置按照以下方式添加点击事件,进入测试工具主页:
findViewById(R.id.menu_btn_ad_test).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Intent start = new Intent(MainActivity.this,
KlevinAdTestActivity.class);
startActivity(start);
}
});

三、测试工具使用流程#

1.基础信息检测(首页)#

自测工具首页展示了基础信息的检测结果,包括接入方包名设备制造商系统版本相关信息。开发者可对照基础信息的检测结果,检查接入信息是否正确。

页面示例详细参数
avatar测试应用:接入广告SDK应用的包名
品牌:设备制造商
机型:手机型号
系统版本:手机android系统版本
屏幕宽度:宽度分辨率
屏幕高度:高度分辨率
OAID:设备标识符
环境信息:系统支持的安卓sdk最低与最高版本号

2.接入检测#

接入检测对接入方是否调用SDK初始化功能权限隐私权限是否正确配置进行检查。开发者可对照检测结果进行检查,对检测失败项及时进行排查修复。

页面示例详细参数
avatarSDK初始化:检测广告SDK是否初始化成功
FileProvider: 检查是否进行了FileProvider配置
App代码混淆:是否开启了代码混淆
App硬件加速:是否开启了硬件加速

权限配置:以下权限是否正确配置

INTERNET
REQUEST_INSTALL_PACKAGES
ACCESS_NETWORK_STATE
VIBRATE

隐私配置:以下隐私权限是否正确配置

isCanUseLocation
isCanUsePhoneState
isCanUseWifiState

3.广告测试#

广告测试页面可供开发者预览指定类型的广告,通过输入指定的广告位ID,即可在应用中快速加载对应的广告并预览效果。

目前只能根据指定样式与广告位ID预览广告,暂不支持获取全量广告ID。

页面示例详细参数
avatar开屏广告ID:37057
激励广告ID: 37058
插屏广告ID:37056
自渲染广告ID:37059