# SDK错误码

排查错误请根据错误码错误信息进行排查;单一错误码可能无法准确排查错误

# 常见错误码

错误码 说明
10001 Invalid appid or app key, please check 1. AppId或者AppKey错误,检查代码中初始化 SDK时传入的AppId和AppKey
10003 Invalid app
1. AppId错误,检查代码中初始化 SDK时传入的AppId
2.广告位Id与AppId不匹配,检查代码中调用load时传入的positionId
10004 Invalid placement
1. 广告位Id错误,检查代码中调用load时传入的positionId
9999 一般是网络请求出现错误,检查网络状态是否正常
9990 Http接口请求返回的状态错误,需要联系同事查看错误信息
9991 接口请求返回的业务代码错误,需要联系同事查看错误信息
2001 广告加载超时,检查当前的测试的广告源是否是海外平台,手机网络是否已经翻墙
2003 当前设备广告位的展示次数已经达到上限
2005 该广告位处于加载阶段,同一个广告位发起请求后,在接收到加载成功或失败的回调之前,该广告位不能发起下一次的加载,请等待加载成功、失败的回调
2007 通常发生于,在加载失败的回调中立刻发起广告加载。禁止在加载失败的回调中立刻发起广告加载,距离上一次该广告位加载失败需满足一定时间间隔才可发起广告加载,请延迟调用广告加载的时间
2008 同一个广告位加载失败后禁止立马调用load方法进行重试,请延迟10s以上再进行重试;请勿在加载失败的回调里调用load加载广告引起死锁
2009 在一定时间间隔内广告位的加载次数达到上限
3001 策略获取错误
1. 检查网络是否正常
2. 检查使用的appid,appkey,positionId是否匹配
3. 检查代码中appid,appkey,positionId是否正确并且匹配(不能包含空格)
3002 传入的appid,appkey,positionId其中有一个为空字符
3003 广告位与调用的API不匹配,例如:Banner的广告位调用了激励视频的API去加载广告
4001 通常发生于,平台返回错误导致没有广告填充,请根据回调中的错误信息参照其他错误
4002 Context的上下文已经被销毁,需要重新创建相应的广告类型对象再重新发起广告加载
4003 该广告位的状态已经关闭
4006 视频播放失败,参照 4001错误码 进行排查

# 其他错误

错误码 说明
2001 初始化错误,开发者自查参数问题
2002 内部错误
3001 网络异常
3003 网络类型错误,当前设备的网络类型不符合开屏广告的加载条件
4001 初始化错误, 包括广告位为空、App ID为空、Context/Activity为空
4002 请检查 Manifest 文件中的 Activity/Service/Permission 的声明是否正确以及声明的权限是否都已授予
4003 广告位错误
4004 开屏广告容器不可见
4005 开屏广告容器的高度低于400dp 根据 Logcat
4006 原生广告接口调用顺序错误,
4007 当前设备或版本不支持
4008 设备方向不适合展示广告
4009 开屏广告的自定义跳过按钮尺寸低于3x3dp
4011 开屏广告拉取超时,请自查开屏广告的拉取超时时间是否在3-5秒内
4012 内容广告接口调用顺序错误,调用点击接口前未调用曝光接口
4013 在旧版的
4014 广告数据返回前尝试展示广告
4015 同一条广告不允许多次展示
4016 应用横竖方向参数与广告位支持方向不匹配 开发自查应用横竖屏状态与广告位支持方向是否匹配
5001 服务端数据错误 建议稍后重试,如果重试仍然有错误,请反馈给商务
5002 视频素材下载错误 建议稍后重试,如果重试仍然有错误,请反馈给商务
5003 视频素材播放错误 建议稍后重试,如果重试仍然有错误,请反馈给商务
5004 未匹配到合适的广告 此情况下禁止多次重试请求广告,否则可能影响系统对您流量的评价从而影响变现效果
5005 广告请求量或者消耗等超过日限额,请明天再请求广告
5006 包名校验错误,当前 App 的包名和注册媒体时填写的包名不一致,因此无广告返回
5007 资源加载错误
5008 图片加载错误
5009 广告请求量或者消耗等超过小时限额,请一小时后再请求广告
5010 广告样式校验失败,请检查广告位与接口使用是否一致
5011 原生模版渲染失败
5012 广告数据过期
5013 广告请求过于频繁
5018 广告位PosId被封
5019 广告AppId被封
5021 该类型广告已下线
5041 断点续安装提示
5042 断点续安装提示
5043 断点续安装提示
5044 断点续安装提示
5045 断点续安装提示
其他 未知错误
100001 请求解析失败,常见原因是没有对参数进行url编码。
100007 广告位id参数解析失败,该参数必填并且参数类型是非负整数
100012 广告位宽度参数解析失败,该参数类型是非负整数
100014 广告位高度参数解析失败,该参数类型是非负整数
100016 广告位参数page_number字段数据类型错误,该参数类型为非负整数
100017 广告位参数last_ad_ids字段数据类型错误,该参数类型为字符串
100019 广告位参数is_information_pos字段数据类型错误,该参数类型为布尔类型
100023 广告位参数level字段数据类型错误,该参数类型为非负整数
100028 广告位参数query字段数据类型错误,该参数类型为字符串
100031 广告位参数max_duration字段数据类型错误,应为非负整数
100032 广告位参数traffic_type字段数据类型错误,应为非负整数
100034 广告位参数support_c2s字段数据类型错误,应为非负整数
100125 广告位宽度和高度参数无效,请参考广告位宽度和高度参数说明
100133 请求中包含无效的广告位
100135 广告位状态冻结
100159 激励视频请求orientation参数不合法
100303 ad_count参数必填且应为非负整数
100351 need_rendered_ad参数无效
102006 没有匹配到合适的广告。禁止重试,否则可能触发系统策略导致流量收益下降
104014 原始idfa无效
104015 imei无效
104017 android id无效
104018 android_advertising_id无效
106001 广告位不存在
107000 广告位信息为空
107002 api请求中操作系统类型不合法
107005 api请求中app_id不匹配
107006 api请求中安卓的package name或是ios的bundle id不合法
107007 缺少有效的设备标识字段
107008 广告位所属媒体在联盟平台关联的域名为空
107009 广告位所在页面的域名与广告位所属媒体在联盟平台关联的域名不一致
107011 请求中的操作系统类型与广告位在联盟平台的设置不匹配
107012 解析api请求中device字段失败
107014 解析api请求中network字段失败
107015 解析api请求中geo字段失败
107016 解析api请求中设备品牌和型号model字段失败
107017 解析api请求中设备横竖屏orientation字段失败
107018 解析api请求中网络连接类型connect_type字段失败
107019 解析api请求中运营商信息carrier字段失败
107020 解析api请求中纬度信息lat字段失败
107021 解析api请求中经度信息lng字段失败
107022 解析api请求中经纬度精度location_accuracy字段失败
107023 解析api请求中是否支持大规格插屏广告support_full_screen_interstitial字段失败
107024 解析api请求中操作系统os_version字段失败
107025 解析api请求中屏幕宽度screen_width字段失败
107026 解析api请求中屏幕高度screen_height字段失败
107027 解析api请求中pos字段失败
107028 解析api请求中media字段失败
107029 api请求中缺少合法的广告位宽度或高度
107030 请求中app包名与广告位在联盟平台的设置不匹配
107031 解析api请求中设备制造商manufacturer字段失败
107032 解析api请求中设备类型device_type字段失败
107033 api请求中缺少合法的设备id
107034 错误的sdk接口调用,常见原因比如使用原生广告位id但调用开屏广告位接口
107035 不支持模板视频广告的sdk版本,请升级sdk版本或广告位配置为不展示视频广告
107036 禁止广告展示页面嵌在iframe中
107040 错误的sdk接口调用,常见原因比如使用自渲染2.0广告位id但调用自渲染1.0接口
107041 sdk版本已经废弃,需更新
107042 api请求中adx_id不合法
107044 API请求中oaid无效
107045 API请求中aid_ticket无效
107046 API请求中taid_ticket无效
107047 sdk的banner插屏1.0已废弃,请通过2.0接入
107048 sdk的原生自渲染1.0已废弃,请通过2.0接入
107049 Js旧准入规则已废弃,请升级准入规则
107050 sdk接口与广告位不匹配。广告位是模板2.0广告位,请调用sdk模板2.0接口请求广告
109506 该广告位样式处于测试期且今日的请求量已经达到了上限,请明日00:30后再发送请求
109507 该广告位样式处于测试期且每小时请求量已经达到了上限,请一小时后再发送请求
109511 该广告位数据异常已被暂时封禁,请明日00:30后再发送请求
112001 请求合法,但当前暂无资讯内容返回,禁止重试,请稍后重试
112003 channel无效
112004 广告位类型错误,非资质通荐广告位请求了资质通荐广告接口,请修改广告位ID后进行重试。
错误码 说明
20001 没有合适的广告返回而导致的请求没有填充,偶现属于正常情况
40001 http request pb错误;对照文档或demo检查一下广告请求是否缺少必要参数
40005 广告位尺寸不能为空。检查设置的请求尺寸
40007 广告数量错误
40006 广告位ID不合法
40008 图片尺寸错误,检查传入的请求广告尺寸
40018 媒体包名与提交不一致
40019 没有合适的广告返回而导致的请求没有填充,偶现属于正常情况
40020 开放注册新上线广告位超出日请求量限制.平稳放量,会逐渐放开限制
40021 apk签名sha1值与媒体平台录入不一致 应用的签名必须与提交的签名一致
40024 SDK版本过低不返回广告,请升级到平台最新版本SDK
40025 渲染异常.分为两种情况: 1、Android:SDK版本使用不正确,媒体使用了非该应用所属账号下的SDK版本导致
40026 海外ip请求中国服务器导致.请确认发出广告请求设备ip的所属国家,非全球化开发者只能在国内请求广告
40029 模板渲染类型广告的请求方法或请求参数不正确.
视频播放时黑屏 检查Manifest中是否配置wake_lock权限
Banner显示的大小有问题 调用load之前,需要指定FNBannerView的LayoutParams宽高值
激励视频广告在播放时报了空指针 如果打包时会打出多个dex,请确保SDK相关的类要打入classes.dex中