# 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中 |