菜单

错误码说明

Tips:

为快速定位问题原因，建议通过AdError#getFullErrorInfo()获取全部错误信息

"code[ " + code + " ],desc[ " + desc + " ],
platformCode[ " + platformCode + " ],
platformMSG[ " + platformMSG + " ]"

code: TaKu SDK的错误码
desc: TaKu SDK的错误信息
platformCode: 第三方广告平台的错误码（广告没有填充时需要检查的错误码）
platformMsg: 第三方广告平台的错误信息（广告没有填充时需要检查的错误信息）

1. TaKu错误码信息说明

错误码	说明
10001	App ID或App Key错误，请检查初始化TaKu SDK时传入的App ID和App Key
10003	1. App ID错误，请检查初始化Taku SDK时传入的App ID 2. Taku广告位ID与App ID不匹配，请检查代码中调用load方法时传入的Placement ID
10004	TaKu广告位ID错误，请检查调用load方法时传入的Placement ID
9999	1.一般是网络请求出现错误，检查网络状态是否正常 2.platformMSG:[ chain validation failed ],检查系统时间是否有调整
9990	HTTP接口请求返回的状态错误，需要联系TaKu同事查看错误信息
9991	接口请求返回的业务代码错误，需要联系TaKu同事查看错误信息
9992	GDPR的等级设置过低，检查是否手动设置了FORBIDDEN等级
2001	广告加载超时，检查当前的测试的广告源是否是海外平台，手机网络是否已经翻墙
2002	TaKu的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	通常发生于第三方广告平台返回错误导致没有广告填充，可通过`AdError.getFullErrorInfo()`获取完全的错误信息，通过`platformCode`及`platformMsg`查看广告平台的错误码及错误信息，请查看第三方广告平台错误码进行排查
4002	Context的上下文已经被销毁，需要重新创建相应的广告类型对象再重新发起广告加载
4003	该广告位的状态已经关闭，检查TaKu后台该广告位的状态开关是否开启
4004	该广告位没有在TaKu后台配置广告源的信息，需要到TaKu后台-聚合管理为广告位添加第三方广告平台的广告源
4005	广告位下的所有广告源被过滤，可能的原因如下： 1. 检查是否在TaKu后台设置了广告源的展示上限、展示间隔 2. 如果只配置了头部竞价广告源，询价失败时，头部竞价广告源将被过滤
4006	视频播放失败，参照 4001错误码进行排查
4007	广告源竞价失败，参照 4001错误码进行排查
4008	因为开发者代码中的自定义过滤逻辑，导致广告源被过滤。如果过滤不符合预期，请排查自定义过滤逻辑
4009	调试模式下，该广告位没有配置广告源信息

2. 第三方广告平台错误码

● 腾讯广告

常见错误	解决方案
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的错误信息请查看：Tencent Ads错误码

● 穿山甲(Pangle)

常见错误	解决方案
4201 - No initializer	1、检查是否已经按照集成文档限制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后台穿山甲广告源的配置需与穿山甲后台的配置保持一致
40025	1、检查测试设备的系统时间是否为当前正确的时间 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错误码

● 百度

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

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

● 快手

常见错误	解决方案
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设置固定的宽高值

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

● Sigmob

常见错误	解决方案
200000 - 无广告填充	使用Taku的调试模式（DebuggerConfig）进行测试
Sigmob开屏一直获取不到广告	6.0以上设备需要动态申请READ_PHONE_STATE权限
500701 - app未开通任何广告渠道	检查Sigmob后台应用状态
500420 - 请求的app已经关闭广告服务	检查Sigmob后台应用状态
500473 - 请求的app不存在	检查Taku后台Sigmob广告源配置
500424/500422/500482	1、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错误码

● 游可赢

常见错误	解决方案
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-请求频繁，重新请求	未匹配上广告，建议重新发起广告请求

更多错误信息请查看：京媒错误码

● Meta

常见错误	解决方案
1001 - No Fill	使用Taku的调试模式进行测试
1000 - Network Error	检查网络环境

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

● Meta Load Fail

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

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

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

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

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

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

正确配置示例如下：

(5) 若广告位请求后无填充，打开Taku日志，过滤“anythink|HeadBidding”关键字查看日志

如果日志格式如下："HeadBidding Fail List"中network_firm_id值为 1 则代表Meta竞价失败

(6) 调用下方代码打开Bidding测试模式，如果打开Bidding测试模式后竞价成功，并且广告填充成功则Meta广告接入成功。

ATSDK.setDebuggerConfig(activity, "AndroidID(海外版本用GAID)", null);

● Admob

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

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

● AppLovin

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

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

● Mintegral

常见错误	解决方案
EXCEPTION_RETURN_EMPTY	中国版： 1、确保Mintegral后台-应用设置中开启了是否接受apk广告投放非中国版： 1、检查是否翻墙或者VPN到美国地区上述检查后仍有问题，使用Taku的调试模式进行测试
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	检查网络是否正常后进行重试

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

● Chartboost

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

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

● Tapjoy

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

● IronSource

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

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

● UnityAds

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

● Vungle

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

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

● Bigo

常见错误	解决方案
3507-EXCEPTON_UNIT_BIDDNG_TYPE_ERROR	bidding type错误，例如使用waterfull广告代码加载Bidding广告位，或使用竞价代码加载waterfull广告位，请保持一致 ,检查Taku后台配置和广告平台配置，详细可咨询广告平台

● Nend

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

● Yandex

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

● Kwai

常见错误	解决方案
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设置固定的宽高值

更多的快手的错误信息请查看：Kwai错误码

● Huawei

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

测试海外华为：必须翻墙

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

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

上一个

如何测试广告

下一个

抓包示例

最近修改: 2025-05-30Powered by

大纲