菜单

错误码说明

1. Taku错误码信息说明

错误码说明
10001Invalid appid or app key, please check
1. AppId或者AppKey错误，检查代码中初始化Taku SDK时传入的AppId和AppKey
调用 ATSDK.setNetworkLogDebug(true); 在Logcat中过滤 anythink 可查看当前传入SDK的参数，请检查这些参数
10003Invalid app
1. AppId错误，检查代码中初始化Taku SDK时传入的AppId
2. Taku广告位Id与AppId不匹配，检查代码中调用load时传入的PlacementId
调用 ATSDK.setNetworkLogDebug(true); 在Logcat中过滤 anythink 可查看当前传入SDK的参数，请检查这些参数
10004Invalid placement
1. Taku广告位Id错误，检查代码中调用load时传入的PlacementId
调用 ATSDK.setNetworkLogDebug(true); 在Logcat中过滤 anythink 可查看当前传入SDK的参数，请检查这些参数
9999一般是网络请求出现错误，检查网络状态是否正常
9990Http接口请求返回的状态错误，需要联系Taku同事查看错误信息
9991接口请求返回的业务代码错误，需要联系Taku同事查看错误信息
9992GDPR的等级设置过低，检查是否手动设置了FORBIDDEN等级
2001广告加载超时，检查当前的测试的广告源是否是海外平台，手机网络是否已经翻墙
2002Taku的SDK包导入不全，缺失第三方广告厂商的Adapter包（anythink_network_*.aar），确认是否已经按照指引导入聚合的第三方需要的SDK包
2003当前广告位的展示次数已经达到上限，需要确认Taku的后台配置是否限制了该广告位的展示次数
2004当前广告位处于非展示时间段，需要确认Taku的后台配置是否限制了广告位的展示间隔
2005该广告位处于加载阶段，同一个广告位发起请求后，在接收到加载成功或失败的回调之前，该广告位不能发起下一次的加载，请等待加载成功、失败的回调
2006检查导入第三方广告平台的SDK包是否齐全，如果齐全则检查导入的版本是否与GitHub上指定的版本是否相符合，否则需要将第三方SDK包补充完整
2007通常发生于，在加载失败的回调中立刻发起广告加载。禁止在加载失败的回调中立刻发起广告加载，距离上一次该广告位加载失败需满足一定时间间隔才可发起广告加载，请延迟调用广告加载的时间
2008同一个广告位加载失败后禁止在加载失败的回调里立马调用load方法进行重试，请延迟10s以上再进行重试
2009在一定时间间隔内广告位的加载次数达到上限
3001策略获取错误
1. 检查网络是否正常
2. 检查使用的appid，appkey，placementid是否匹配
3. 检查代码中appid，appkey，placementid是否正确并且匹配（不能包含空格）
调用 ATSDK.setNetworkLogDebug(true); 在Logcat中过滤 anythink 可查看当前传入SDK的参数，请检查这些参数
3002传入的appid,appkey，placementid其中有一个为空字符
调用 ATSDK.setNetworkLogDebug(true); 在Logcat中过滤 anythink 可查看当前传入SDK的参数，请检查这些参数
3003广告位与调用的API不匹配，例如：Banner的广告位调用了激励视频的API去加载广告
4001通常发生于，第三方广告平台返回错误导致没有广告填充:1.可通过AdError.getFullErrorInfo()获取完全的错误信息，通过platformCode及platformMsg查看广告平台的错误码及错误信息，请查看 第三方广告平台错误码&常见问题 进行排查，广告属于哪个广告平台可通过SDK的日志获取2.建议调用 ATSDK.setNetworkLogDebug(true); 打开SDK的日志获取更加详细的信息3.可通过此 测试指引 进行广告的测试
4002Context的上下文已经被销毁，需要重新创建相应的广告类型对象再重新发起广告加载
4003该广告位的状态已经关闭，检查Taku后台该广告位的状态开关是否开启
4004该广告位没有在Taku后台配置广告源的信息，需要到Taku后台-聚合管理 为广告位添加第三方广告平台的广告源
4005广告位下的所有广告源被过滤，可能的原因如下：
1. 检查是否在Taku后台设置了广告源的展示上限、展示间隔
2. 如果只配置了头部竞价广告源，竞价失败时，头部竞价广告源将被过滤
4006视频播放失败，参照 4001错误码 进行排查
4007广告源竞价失败，参照 4001错误码 进行排查
4008因为开发者代码中的自定义过滤逻辑，导致广告源被过滤。如果过滤不符合预期，请排查自定义过滤逻辑
4009调试模式下，该广告位没有配置广告源信息


2. 第三方广告平台错误码&FAQ（常见问题）

Meta

(推荐vpn填充率高国家：美国)

常见错误解决方案
1001 - No Fill使用Taku的调试模式（DebuggerConfig） 进行测试
1000 - Network Error检查是否翻墙

更多的Meta的错误信息请查看：Meta错误码


针对Meta Load Fail可通过以下步骤进行调试

1.确保设备上已安装Facebook并且已登录

2.添加头部竞价类型的Meta广告源

注意：必须使用头部竞价广告源，不支持普通广告源

3.确认引入的Meta版本与TakuSDK版本对应

4.确认添加的Meta广告源的应用编号（App ID）与版位编号（Placement ID）的前缀是否一致

正确配置示例如下：

文章图片


广告位请求后无填充则调用ATSDK.setNetworkLogDebug(true);打开Taku日志，过滤“anythink|HeadBidding”关键字查看日志

如果日志格式如下：

文章图片

"HeadBidding Fail List"中带有Meta则代表Meta竞价失败

5.调用下方代码打开Bidding测试模式：

//5.9.96及以上版本
//f669f2b7137d82b9 为测试设备的 AndroidID
ATSDK.setDebuggerConfig(this, "f669f2b7137d82b9", null);

//低于5.9.96版本
//f669f2b7137d82b9 为测试设备的 AndroidID
ATSDK.setBiddingTestDevice("f669f2b7137d82b9");

如果打开Bidding测试模式后竞价成功，并且广告填充成功则Meta广告接入成功

Admob

(推荐vpn填充率高国家：美国)

常见错误解决方案
3使用Taku的调试模式（DebuggerConfig） 进行测试
2检查是否翻墙
1检查Taku后台Admob广告源配置
01、使用Taku的调试模式（DebuggerConfig） 进行测试
2、检查是否翻墙

更多的Admob的错误信息请查看：Admob错误码

AppLovin

(推荐vpn填充率高国家：美国)

常见错误解决方案
204使用Taku的调试模式（DebuggerConfig） 进行测试

更多的AppLovin的错误信息请查看：AppLovin错误码

Mintegral

(国外版本推荐vpn填充率高国家：美国)

常见错误解决方案
EXCEPTION_RETURN_EMPTY中国版：
1、确保Mintegral后台-应用设置中开启了是否接受apk广告投放
非中国版：
1、检查是否翻墙或者VPN到美国地区

上述检查后仍有问题，使用Taku的调试模式（DebuggerConfig） 进行测试
errorCode: 3507 errorMessage: data load failed, errorMsg is Network error,I/O exception检查是否连了代理，并且开启了SSL Proxying，去掉后重试
Network error,I/O exception检查是否连了代理，并且开启了SSL Proxying，去掉后重试
EXCEPTION_UNIT_NOT_FOUND检查Taku后台Mintegral广告源配置（广告单元id）
EXCEPTION_UNIT_NOT_FOUND_IN_APP检查Taku后台Mintegral广告源配置（广告单元id）
EXCEPTION_SIGN_ERROR检查Taku后台Mintegral广告源配置（AppKey）
EXCEPTION_UNIT_ADTYPE_ERROR检查Taku后台Mintegral广告源配置（广告形式不匹配）
resource load timeout检查网络是否正常后进行重试


Q:视频播放白屏，或者debug包播放正常，release包却播放异常

A:检查打包时是否开启了资源优化：shrinkResource=true



在res/raw路径下加一个keep.xml，内容为：


将以下资源加入白名单：
R.string.mintegral_*
R.drawable.mintegral_*
R.layout.mintegral_*
R.id.mintegral_*

更多的Mintegral的错误信息请查看：Mintegral错误码

腾讯广告

常见错误解决方案
6000 - 102006没有匹配到合适的广告。禁止重试，否则可能触发系统策略导致流量收益下降
测试集成可以使用Taku的调试模式（DebuggerConfig） 进行测试
5002 - 视频素材下载错误检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
广告中的图片显示不出来检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
原生广告视频黑屏或者显示透明在AndroidManifest.xml中开启硬件加速
5004 - 未匹配到合适的广告此情况下禁止多次重试请求广告，否则可能影响系统对您流量的评价从而影响变现效果
测试集成可以使用Taku的调试模式（DebuggerConfig） 进行测试
5004 - 没有广告1. 检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
2. 检查Taku后台腾讯广告源配置（是否模板渲染2.0）
5006 - 包名校验错误，当前 App 的包名和广点通官网注册媒体时填写的包名不一致，因此无广告返回代码中配置的包名必须与广点通后台的一致
5010 - 广告样式校验失败，请检查广告位与接口使用是否一致检查Taku后台腾讯广告源配置（是否模板渲染、是否全屏视频等）
2001 - 初始化错误开发者自查参数问题
1. 不要拆腾讯广告的SDK包
2. 检查Taku后台Tencent Ads广告源配置
3. 参数没有问题的情况下，请确认是否使用的是真机，不要使用模拟器进行测试
4004-开屏广告容器不可见1.排查有没有隐藏容器或被遮挡
2. 如果在acitvity的oncreate直接执行show就需要延迟，建议showAd方法，麻烦用主线程的Handler，postDelay延迟 10ms后再调用showAd方法试试看
3.加上container.removeAllViews();展示前调用
102006-没有找到符合价格要求或体验要求的广告建议适当调整底价/目标价的价格设置，或至平台广告中心检查核对屏蔽规则

更多的Tecent Ads的错误信息请查看：

1、Tencent Ads错误码
2、Tencent Ads错误码 6000

Chartboost

(推荐vpn填充率高国家：美国)

常见错误解决方案
NO_AD_FOUND使用Taku的调试模式（DebuggerConfig） 进行测试

更多的Chartboost的错误信息请查看：Chartboost错误码

Tapjoy

(推荐vpn填充率高国家：美国)

常见错误解决方案
获取不到广告使用Taku的调试模式（DebuggerConfig） 进行测试


ironSource

(推荐vpn填充率高国家：以色列)

常见错误解决方案
508 - initISDemandOnly() had failedTaku后台广告源配置时必须配置Instance Id，检查Ironsource后台账号是否有Instance权限，没有权限时请联系Ironsource相关人员
510联系Ironsource相关人员

更多的Ironsource的错误信息请查看：Ironsource错误码

UnityAds

(推荐vpn填充率高国家：美国)

更多的UnityAds的错误信息请查看：UnityAds错误码

Vungle

(推荐vpn填充率高国家：美国)

常见错误解决方案
NO_SERVE使用Taku的调试模式（DebuggerConfig） 进行测试
PLACEMENT_NOT_FOUND检查Taku后台Vungle广告源配置
CONFIGURATION_ERROR1. 检查网络是否正常
2. 检查Taku后台Vungle广告源配置
UNKNOWN_ERROR联系Vungle相关人员
预加载了Vungle的激励视频和插屏广告并且成功后，播放了其中一个Vungle的广告，另一个广告的isAdReady()返回falseVungle的激励视频和插屏广告存在共用同一份广告源资源的情况

更多的Vungle的错误信息请查看：Vungle错误码

AdColony

(推荐vpn填充率高国家：芬兰)

Common mistakesSolution
onRequestNotFilled!使用Taku的调试模式（DebuggerConfig） 进行测试


Bigo

(推荐vpn填充率高国家：新加坡)

Common mistakesSolution
3507-EXCEPTON_UNIT_BIDDNG_TYPE_ERRORbidding type错误，例如使用waterfull广告代码加载Bidding广告位，或使用竞价代码加载waterfull广告位，请保持一致 ,检查topon后台配置和广告平台配置，详细可咨询广告平台


穿山甲(Pangle)

(国外版本推荐vpn填充率高国家：韩国，日本，新加坡)

常见错误解决方案
4201 - No initializer1、检查是否已经按照集成文档限制abi架构
2、检查是否已经按照集成文档添加com.android.support:appcompat-v7依赖或者androidx.appcompat:appcompat依赖
-7 - 开屏广告图片加载失败检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
加载后没有结果回调检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
广告中的图片显示不出来检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
视频播放时黑屏检查Manifest中是否配置WAKE_LOCK权限
20001没有合适的广告返回而导致的请求没有填充,偶现属于正常情况
请尝试更换设备进行验证，不要使用模拟器进行测试，或稍后再试。如都不能解决，请查看穿山甲-SDK错误码进行排查或者向穿山甲平台提单进行询问
测试集成可以使用Taku后台广告位-高级设置中的测试模式
40029检查穿山甲代码位的渲染类型，Taku后台穿山甲广告源的配置需与穿山甲后台的配置保持一致
400251、检查测试设备的系统时间是否为当前正确的时间
2、检查是否已经按照集成文档限制abi架构
3、如果有开启混淆，请检查下载的SDK压缩包中提供的混淆规则
4、到穿山甲后台下载SDK，替换掉Taku提供的穿山甲SDK（open_ad_sdk_*.aar）
40021 - apk签名sha1值与媒体平台录入不一致应用的签名必须与穿山甲后台配置的签名一致，如果是刚配置，请5分钟后清楚缓存再试
40019 - 媒体配置adtype和请求不一致检查Taku后台穿山甲广告源配置，如果是刚配置，请5分钟后清楚缓存再试
40018 - 媒体包名与录入不一致代码中配置的包名必须与穿山甲后台的一致，如果是刚配置，请5分钟后清楚缓存再试
40016 - slot_id 与 app_id对应关系不合法检查Taku后台穿山甲广告源配置，是否含有空格或特殊符合
40006 - 广告位ID不合法检查Taku后台穿山甲广告源配置，是否含有空格或特殊符合
0 - null弱网时会报此错误，请检查网络状态或者切换网络进行重试
Banner显示的大小有问题调用load之前，需要指定ATBannerView的LayoutParams宽高值
头条的激励视频广告在播放时报了空指针如果打包时会打出多个dex，请确保头条相关的类要打入classes.dex中

更多的Pangle的错误信息请查看：（需登录）Pangle错误码

聚量传媒(Uniplay)

常见错误解决方案
3000/3001联系Uniplay相关运营人员
4006/4007/4008/4009缺少Uniplay的Manifest相关配置
4011缺少相关权限，参考Uniplay的Manifest中配置的权限，进行申请
AD NOT FOUND联系Uniplay相关运营人员
加载Banner广告时一直没有回调ATBannerView需要先add到window上再发起load请求

更多的Uniplay的错误信息请查看：（需登录下载）Uniplay错误码

百度

常见错误解决方案
获取不到广告1、激励视频设置后两小时生效
2、使用Taku后台广告位-高级设置中的测试模式进行测试
加载Banner广告时一直没有回调ATBannerView需要先add到window上再发起load请求

更多的Baidu的错误信息请查看：Baidu错误码

Nend

(推荐vpn填充率高国家：芬兰)

常见错误解决方案
获取不到广告使用Taku的调试模式（DebuggerConfig） 进行测试

Yandex  

(推荐vpn填充率高国家：俄罗斯)

错误信息请查看：Yandex错误码

快手

常见错误解决方案
40003 - 广告数据为空必现时，联系快手相关人员
40004 - 视频资源缓存失败检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
原生广告视频黑屏或者显示透明在AndroidManifest.xml中开启硬件加速
0 - 网络错误1.检查网络是否正常
2.检查是否已经按照集成文档正确适配Android 9及以上系统（network_security_config.xml）
310002 - appId无效检查Taku后台快手广告源配置，如果是刚配置，请5分钟后清楚缓存再试
310004 - packageName与注册的packageName不一致代码中配置的包名与快手后台的不一致
330002 - posId无效检查Taku后台快手广告源配置，如果是刚配置，请5分钟后清楚缓存再试
330004 - posId与注册的appId信息不一致检查Taku后台快手广告源配置，是否有自己用了不同的appid去初始化快手
原生广告展示异常为ATNativeAdView设置固定的宽高值


Q:视频播放白屏，或者debug包播放正常，release包却播放异常

A:检查打包时是否开启了资源优化：shrinkResource=true



在res/raw路径下加一个keep.xml，内容为：


将以下资源加入白名单：
R.string.ksad_*
R.drawable.ksad_*
R.layout.ksad_*
R.id.ksad_*
R.style.ksad_*
R.color.ksad_*
R.attr.ksad_*
R.dimen.ksad_*

更多的快手的错误信息请查看：（需登录下载）快手错误码

Sigmob

常见错误解决方案
200000 - 无广告填充使用Taku的调试模式（DebuggerConfig） 进行测试
Sigmob开屏一直获取不到广告6.0以上设备需要动态申请READ_PHONE_STATE权限
500701 - app未开通任何广告渠道检查Sigmob后台应用状态
500420 - 请求的app已经关闭广告服务检查Sigmob后台应用状态
500473 - 请求的app不存在检查Taku后台Sigmob广告源配置
500424/500422/5004821、6.0以上设备需要动态申请READ_PHONE_STATE权限
2、android10请参考Sigmob FAQ中关于android10国内如何填充广告的内容
android10获取不到广告参考Sigmob FAQ中关于android10国内如何填充广告的内容
广告加载成功后没有播放以及之后的回调Sigmob的回调需要依赖LocalBroadcastManager这个库
检查是否引入了com.android.support:appcompat-v7的依赖
（Androidx对应的是androidx.localbroadcastmanager:localbroadcastmanager）


更多的Sigmob的错误信息请查看：Sigmob错误码

华为（HMS）

注意：测试华为广告时，必须使用华为手机或者带有HMS Core华为服务的手机。

测试海外华为：必须翻墙

常见错误解决方案
3 - NO_AD使用Taku的调试模式（DebuggerConfig） 进行测试
2 - NETWORK_ERROR检查网络是否翻墙
1 - INVALID_REQUEST检查Taku后台华为广告源配置

更多的华为（HMS）错误信息请查看：华为(HMS) 错误码

游可赢

常见错误解决方案
1110 - 应用ID(AppID)异常请自查AppID和PosID是否匹配
1111 - 资源位(PosID)异常，请自查AppID和PosID是否匹配请自查AppID和PosID是否匹配
1112 - 广告模版未匹配建议检查SDK版本是否支持请求的广告样式

更多的游可赢错误信息请查看：游可赢 错误码

TapTap

常见错误解决方案
3002-网络异常错误检查手机网络环境是否正常
3003-插屏广告应用横竖方向参数与广告位支持方向不匹配修改TapTap后台广告位横竖配置
9999-未获取到广告素材:未知错误常规无填充错误，使用Taku的调试模式（DebuggerConfig） 进行测试

更多错误信息请查看：TapTap 错误码(需要登陆)

京媒

常见错误解决方案
2001-网络异常检查手机网络环境是否正常
2002-未匹配上广告建议更换注册过京东App的设备，再重新发起广告请求
3000-请求中tagid与app的id字段与平台配置不一致检查代码位参数是否设置正确
4041-偶发现象，重新请求偶发现象，重新请求，如果高频出现请联系京东研发
4042，4043-请求频繁，重新请求未匹配上广告，建议重新发起广告请求

更多错误信息请查看：京媒 错误码(需要登陆)

上一个
集成测试
下一个
如何测试广告
最近修改: 2026-01-06Powered by