菜单

如何测试广告

1. SDK集成验证

注意不要在提交上架审核的包中带上此API,否则可能影响上架

ATSDK.integrationChecking(applicationContext);//根据输出的日志,检查各个广告平台的SDK集成是否正常

在Logcat中过滤 anythink 的Tag,查看日志。留意各广告平台下的 Status 字段是否为 Success 。如果是 Success 则该广告平台集成正确,否则集成不正确,需要具体查看各个参数,来做相应的修改,补充缺少集成的部分。

日志输出示例如下:

********************************** Network Integration Status *************************************
----------------------------------------
NetworkName: Admob //聚合的广告平台的名字
SDK: VERIFIED //验证聚合SDK是否正确,正确则显示VERIFIED,否则显示NOT VERIFIED
Dependence Plugin: VERIFIED //验证广告平台依赖的插件是否存在,正确则显示VERIFIED,否则显示缺少的配置
Activities : VERIFIED //验证广告平台的Activity声明是否存在,正确则显示VERIFIED,否则显示缺少的配置
Providers : VERIFIED  //验证广告平台的Provider声明是否存在,正确则显示VERIFIED,否则显示缺少的配置
Status: Success //验证广告平台是否全部集成正确,正确则显示Success,否则显示Fail
----------------------------------------
NetworkName: Facebook
SDK: VERIFIED
Dependence Plugin: VERIFIED
Activities : VERIFIED
Services : VERIFIED
Providers : VERIFIED
Status: Success
********************************** Network Integration Status *************************************

 

2. SDK日志开关

注意:应用上线前需要关闭日志功能

ATSDK.setNetworkLogDebug(true);

打开日志功能之后,可以获取到测试设备ID:

  • 打开AndroidStudio的Logcat,以 "anythink" 为 tag 进行过滤,查看SDK的日志
  • TaKu SDK初始化时会打印如下日志,可以从日志中获取设备ID
  • 注意:SDK版本>=6.2.10,非中国大陆的版本SDK内部不会再获取系统的AndroidId,必须使用有GAID的手机才能设置调试模式。确保日志里面有真实打印出GAID,再去用"ATSDK.setDebuggerConfig"方法将Gaid设置进入调试模式才会生效。如果没有打印Gaid的值,证明当前手机没有Google服务,需要使用带Google服务的手机机型测试。
anythink: ********************************** UA_5.9.96 *************************************
anythink: GAID(ADID): b796a53f-61bf-4e91-bc67-d505cdb97cf8 , AndroidID: f669f2b7137d82b9
anythink: ********************************** UA_5.9.96 *************************************

Log示例:

anythink_network:
╔═══════════════════════════════════════════════════════════════════════════════════════
║ {
║     "placementId": "b5bbdc725768fa",  //发起了加载的广告位id
║     "adType": "inter",  //发起加载的广告位类型
║     "mixedFormatAdType": -1,
║     "action": "request_result",  //发起广告加载后的动作:request(广告请求),request_result(广告返回的结果),impression(广告展示),click(广告点击),close(广告关闭)
║     "refresh": 0,
║     "result": "fail",  //结果参数,success(成功),fail(失败)
║     "segmentId": 0,  //(v5.7.7新增) 当前广告源所在的流量分组,0表示默认分组
║     "adSourceId": "1423289",  //广告源id
║     "position": 0,  //当前广告源在广告位下的排序位置
║     "networkType": 6,  //TaKu用来区分第三方广告平台的唯一ID,对应关系可查看(https://help.takuad.com/docs/2KR6QU)
║     "networkName": "Mintegral",  //广告平台名称
║     "networkVersion": "MAL_16.1.41",  //广告平台SDK版本
║     "networkUnit": "{\"is_video\":\"0\",\"video_muted\":\"0\",\"suport_video\":\"1\",\"appkey\":\"ef13ef712aeb0f6eb3d698c4c08add96\",\"unitid\":\"1726152\",\"appid\":\"100947\"}",  //TopOn后台此广告源的配置(对应第三方广告平台的app和placement信息)
║     "isHB": 0,//是否是头部竞价广告源
║     "msg": "code:[ 4001 ]desc:[ Return Ad is empty. ]platformCode:[  ]platformMSG:[ EXCEPTION_UNIT_ADTYPE_ERROR ]",  //如果出现加载失败,这里会输出完整的错误信息
║     "hourly_frequency": 0,  //当前小时展示的次数
║     "daily_frequency": 0,  //当前天展示的次数
║     "network_list": "6,6,6",  //当前第三方广告平台请求列表的id,以“,”间隔
║     "request_network_num": 1,  //表示同时发起多少个第三方广告平台广告源的加载(对应TaKu后台高级设置中的并行请求数)
║     "handle_class": "com.anythink.network.mintegral.MintegralATInterstitialAdapter"  //调用广告平台API的类名
║ }
╚═══════════════════════════════════════════════════════════════════════════════════════
注意:
  • 如果所有的action类型日志的result字段结果均为success,则该广告平台集成正常。
  • 如果某条日志的result字段结果为fail,说明该广告行为出现错误。您需要查看日志中msg字段的内容,格式如下:
"code[ " + code + " ],desc[ " + desc + " ],platformCode[ " + platformCode + " ],platformMSG[ " + platformMSG + " ]"

code:TaKuSDK的内部错误码
desc:TaKuSDK的内部错误描述
platformCode:第三方广告平台的错误码(广告没有填充的时候需要检查的错误码)
platformMsg:第三方广告平台的错误信息(广告没有填充的时候需要检查的错误信息)

您可以根据code、desc查询相关 TaKu错误码,如果code=4001,需根据platformCode、platformMSG查询 第三方广告平台错误码&常见问题 进行排查。

 

3. 通过测试工具测试广告

3.1 测试工具简介

  • 基础信息:检测应用、设备、sdk的相关信息
  • Taku SDK设置信息:检测隐私设置、权限是否成功配置
  • 集成检测:检测集成三方平台SDK和adapter集成情况和测试建议,以及测试三方广告平台的广告加载

注意:

  • 支持在接入Taku SDK后进行检测使用
  • 测试工具仅作为检测SDK集成,并不能代替APP自身的广告逻辑测试
  • 在测试结束后,APP上线前需将调用测试工具的相关代码删除
  • SDK版本要求:v6.2.70及以上
  • 温馨提示:自定义广告平台仅支持线上广告位测试功能,其他功能不支持。

版本说明

Taku SDK版本 测试工具版本 说明
v6.2.70及以上(推荐) v1.1.1 适配高版本SDK,优化已知问题
v6.2.70-v6.3.80 v1.0.8 1.支持Kwai平台调试
2.支持Adx平台的原生广告,横幅广告,插屏广告的子样式调试
v6.2.70及以上 v1.0.7 提高稳定性
v6.2.70-v6.3.68 v1.0.5 SDK v6.3.68及以上版本支持线上ID测试功能
v6.2.70-v6.3.65 v1.0.3 适配Vungle 7.0.0版本
v6.2.70-v6.3.65 v1.0.1 兼容org.jetbrains.kotlin:kotlin-stdlib:1.4.0及以上版本
v6.2.70-v6.3.65 v1.0.0 适配聚合版本

💡Tips:使用测试工具进行测试时需重点关注以下内容

  1. 关注广告平台的SDK的集成显示是否正确

  2. 广告平台的各个样式的请求,展示,点击是否正常

 

3.2 测试工具接入

(1) 参考TaKu SDK接入指南,集成SDK

(2) 引入测试工具,build.gradle中添加引用

repositories {
    maven {
        url "https://jfrog.anythinktech.com/artifactory/debugger"
    }
}
dependencies {
    // Debugger UI Tools
    implementation 'com.anythink.sdk:debugger-ui:1.1.1'
}

(3) 调起测试工具

注意:必须在初始化Taku SDK之后,调用下面的方法才能使用测试工具。

ATDebuggerUITest.showDebuggerUI(context);

 

3.3 测试工具使用

3.3.1 基本信息

文章图片

💡Tips:GAID为空将无法正常使用测试工具进行测试,若为空请检查:

  1. 测试手机是否有安装Google服务
  2. 项目中是否调用了如下的方法,这两种方法都会限制获取GAID
    ATSDK.deniedUploadDeviceInfo(DeviceDataInfo.GAID);
    
    ATSDK.setGDPRUploadDataLevel(ATSDK.NONPERSONALIZED);

 

3.3.2 Taku SDK设置

Taku SDK设置包括两部分:隐私设置和权限设置。

(1) 隐私设置

已限制上报的设备隐私数据GDPR

(2) 权限设置:应用已申请的权限列表。

文章图片 
 

2.3.3 集成检测

(1) 查看广告平台列表的集成状态:集成异常、 完成集成、未集成

(2) 勾选开关打开调试模式。

(3) 选择广告平台进入调试模式,点击右上角分享当前页面的广告平台信息。

(4) 选择广告平台的广告样式进行测试操作。

 

3.3.4 线上ID测试

线上ID测试支持使用Taku后台配置的广告位来测试广告,支持筛选广告位下的广告源进行测试。

注意:在运行线上ID测试后,再切换回开发者应用内去测试需要重启应用,避免应用内测试广告位和测试工具广告位一致导致缓存问题。

(1) 前提条件

  • SDK版本:v6.3.68及以上
  • 测试工具版本:v1.0.5及以上
  • 设置SDK Debug Key:获取步骤是 登录后台 -> 帐号管理 -> Key -> SDK Debug Key
  • 调试模式处于关闭状态

(2) 开始使用

示例代码如下:

//1.初始化SDK
ATSDK.init(context, "your app id", "your app key");
//2.设置Debug Key进入测试工具
ATDebuggerUITest.showDebuggerUI(context, "your debug key");

(3) 线上ID列表

  • 支持查看应用信息:应用名字,App ID,应用包名,SDK版本
  • 支持查看该应用下配置的广告位列表
  • 支持查看广告位信息:名字,ID
  • 支持点击广告位跳转到广告位测试页面进行测试(视频流广告暂时不支持测试)

(4) 广告位测试

  • 支持切换流量分组
  • 支持竞价和瀑布流的广告源
  • 支持筛选广告源:未勾选的广告源在发起load时会被过滤

 

4. 通过调试模式测试广告

(1) 使用调试模式,您可以锁定单个广告平台,使用Taku预先配置的测试广告源,对广告平台集成情况进行测试和验证。

(2) 测试开始后,首先需要打开SDK的日志功能,并获取测试设备ID;然后调用针对各个广告平台的API,配置测试设备、测试广告平台和测试广告类型,开启调试模式;最后根据日志输出的结果,执行相应的调整。

(3) 每个广告平台有单独的方法,不同的广告样式有不同的参数配置,请您根据所需要测试的广告平台、广告样式来选择调用的方法。各广告平台支持广告样式请参考:聚合平台概况

(4) 我们推荐在Taku SDK初始化之前调用API进行设置。

(5) 配置完成后,测试设备上的所有广告位均只会请求配置中指定广告平台的测试广告源。

注意:

  • 对于竞价广告源,该配置仅支持Meta(Facebook)和Taku ADX。其他的竞价广告源无法通过本方法进行测试。
  • 测试海外广告平台时,需要代理到海外网络,其中InMobi建议代理到东南亚地区,印度最佳,Pangle代理到非美国区域,Meta平台需要在测试手机安装了Facebook的应用,填充率比较低,可能需要多次尝试。其他海外平台加载广告可以尝试代理到平台所在国家地区,提高广告的填充率。

 

4.1 调试模式支持的广告平台

4.1.1国内平台

● Mintegral

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Mintegral_NETWORK) .setInterstitial(Mintegral_INTERSTITIAL_VIDEO).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Mintegral_NETWORK).setNativeType(nativeType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型
    Mintegral_NATIVE_SELF_RENDER: 原生自定义渲染
    Mintegral_NATIVE_TEMPLATE:原生自动渲染

● 优量汇(腾讯广告)

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(GDT_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(GDT_NETWORK).setNativeType(nativeType).setInterstitial(interType).build());
参数说明:
GDT_NATIVE_TEMPLATE:平台模板渲染
GDT_NATIVE_SELF_RENDER:开发者自渲染
GDT_NATIVE_DRAW_TEMPLATE:视频贴片广告(模板渲染)
GDT_NATIVE_DRAW_SELF_RENDER:视频贴片广告(自渲染)
interType:设置插屏广告类型,支持以下类型
GDT_INTERSTITIAL:弹窗视频
GDT_INTERSTITIAL_FULL_SCREEN:全屏视频

● 穿山甲

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(TT_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(TT_NETWORK).setNativeType(nativeType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型
TT_NATIVE_TEMPLATE:信息流广告+模板渲染
TT_NATIVE_SELF_RENDER:信息流广告+自渲染
TT_NATIVE_DRAW_TEMPLATE:Draw信息流广告+模板渲染
TT_NATIVE_DRAW_SELF_RENDER:Draw信息流广告+自渲染

● 百度

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(BAIDU_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(BAIDU_NETWORK).setNativeType(nativeType).setInterstitial(interType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型
BAIDU_NATIVE_SELF_RENDER: 自渲染
BAIDU_NATIVE_TEMPLATE:模板渲染
interType:设置插屏广告类型,支持以下类型
BAIDU_INTERSTITIAL_FULL_SCREEN:全屏视频
BAIDU_INTERSTITIAL_TEMPLATE:模板插屏

● 快手

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(KS_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(KS_NETWORK).setNativeType(nativeType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型
KS_NATIVE_SELF_RENDER:信息流广告+自渲染
KS_NATIVE_TEMPLATE:信息流广告+模板渲染
KS_NATIVE_DRAW:Draw信息流广告

● 华为

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Huawei_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Huawei_NETWORK).setNativeType(nativeType).setInterstitial(interType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型
Huawei_NATIVE_VIDEO:视频
Huawei_NATIVE_IMAGE:小图片
Huawei_NATIVE_BIG_IMAGE:大图片
interType:设置插屏广告类型,支持以下类型
Huawei_INTERSTITIAL_IMAGE:插屏图片
Huawei_INTERSTITIAL_VIDEO:插屏视频

● Sigmob

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Sigmob_NETWORK).build());

● 米盟

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Mimo_NETWORK).build());

● 游可赢

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Klevin_NETWORK).build());

● ADX

//通用设置
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Adx_NETWORK).build());
//高级用法
ATSDK.setDebuggerConfig(context, AndroidID, new ATDebuggerConfig.Builder(Adx_NETWORK) .setNativeType(nativeType).setInterstitial(interType).setBannerType(bannerType).build());
参数说明:
nativeType:设置原生广告类型,支持以下类型 
ADX_NATIVE_EXPRESS_LEFT_PIC_RIGHT_TEXT:左图右文 
ADX_NATIVE_EXPRESS_LEFT_TEXT_RIGHT_PIC:左文右图 
ADX_NATIVE_EXPRESS_TOP_PIC_BOTTOM_TEXT:上图下文 
ADX_NATIVE_EXPRESS_TOP_TEXT_BOTTOM_PIC:上文下图
ADX_NATIVE_SELF_RENDER:自渲染
interType:设置插屏广告类型,支持以下类型 Adx_INTERSTITIAL_FULL_SCREEN:全屏插屏 Adx_INTERSTITIAL_HALF_SCREEN:半屏插屏
bannerType:设置横幅广告类型,支持以下类型 ADX_BANNER_SIZE_320_50:320x50尺寸 ADX_BANNER_SIZE_320_90:320x90尺寸 ADX_BANNER_SIZE_300_250:300x250尺寸 ADX_BANNER_SIZE_728_90:728x90尺寸

 

4.2 调试模式不支持的平台

对于调试模式不支持的平台,可使用Taku Demo的测试ID 进行测试

  • 根据输出的日志,验证广告源,从Logcat的日志输出中,可以看到对各种广告动作的跟踪。
  • 调用API配置测试规则后,即可开始进行各种广告动作。
  • 根据placementId定位到需要验证的广告位。

上一个
集成测试
下一个
错误码说明
最近修改: 2025-08-01Powered by