帮助中心/文档详情/

SDK错误码

1. 错误码问题需要开发者先自查,如以下解释无法解决开发者疑问,则可以咨询对接同事或者通过工单进行反馈。
2. 注意:40013、40016、40018、40019、40021、20001错误码问题,若需要穿山甲同事辅助排查,则需要提供抓包数据,抓包地址::https://(ip地址或域名)/api/ad/union/sdk/get_ads/ ,提供抓包的请求和返回信息进行问题的定位

错误码 说明 排查方向
20001 没有合适的广告返回而导致的请求没有填充,偶现属于正常情况 可以尝试更换设备进行验证。若不能解决,请先检查一下广告尺寸是否填写正确,是否有使用模拟器测试广告,单个设备是否一天请求了大量广告但没有展示或者展示率极低等。以上均不满足可以联系穿山甲对接同学或者提交工单(包含代码位和出现概率以及请求时间),相关同学查明后会做出回复。必现场景可以通过抓包确认更具体原因:抓包地址:https://(ip地址或域名)/api/ad/union/sdk/get_ads/ 返回结果:{"request_id": "xxxx", "status_code": 20001, "reason": 112} 若reason=112,则需要开发者提升展示率和cpm。若reason=106,则说明没有填充是因为设置了target导致的填充不足。其他原因请通过工单反馈或者微信群进行反馈。2500以上版本只过滤get_ads即可,DNS预解析会导致请求ip
40004 广告位不能为空 检查设置的代码位位ID是否为空
40005 广告位尺寸不能为空 检查设置的请求尺寸
40006 广告位ID不合法 代码位ID长度不对,或者传了空字符串。新创建代码位需要等2~3分钟才可生效
40007 广告数量错误 检查设置的广告请求条数
40008 图片尺寸错误 检查传入的请求广告尺寸
40009 媒体ID不合法 检查设置的应用ID
40013 非开屏广告请求方法使用了开屏代码位ID 检查请求广告使用的代码位ID是否正确,开屏代码位ID为8开头的九位数字
40016 代码位ID与应用ID不匹配或者应用ID缺失 开发者重点检查下发或者设置的应用ID或者代码位ID,保证应用ID与代码位ID匹配,且传入的正确。保证在广告请求之前SDK初始化完成,且应用ID设置正确
40018 平台上录入的包名与项目里的包名不一致 发出广告请求的包名和在平台上创建应用时填写的包名不匹配,需要检查发出广告的应用的包名
40019 广告请求方法与代码位类型不匹配 例如平台上创建开屏代码位,但是代码中调用的接口是Banner或者其他非开屏的广告类型。可参考穿山甲的集成文档或Demo进行方法确认
40020 开放注册新上线广告位超出日请求量限制 平稳放量,会逐渐放开限制
40021 apk签名SHA1值与媒体平台录入的SHA1不一致 发出广告请求应用的SHA1值和在平台上创建应用时填写的SHA1值不匹配。SHA1获取方法:https://partner.oceanengine.com/doc?id=5dd385aa61886b0012ed8a98
40022 广告请求方法与代码位渲染方式不一致 Banner和插屏广告,穿山甲平台目前仅支持模板渲染和自渲染两种方式,非原生Banner、插屏广告请求方法已经废弃。开发者创建了自渲染或者模板渲染的代码位,而使用了非原生Banner、插屏的广告请求方法,会出现此错误。需要开发者调整广告请求方法
40024 SDK版本过低不返回广告 请升级到平台最新版本SDK
40025 渲染异常 分为两种情况: 1、Android:SDK版本使用不正确,媒体使用了非该应用所属账号下的SDK版本导致,请到该代码位所属账号下工具-文档下载展示的SDK版本去进行接入。 2、iOS:媒体使用2100之前的版本可能渲染异常,请更新到最新版本接入即可解决该问题。
40026 海外ip请求中国服务器导致 请确认发出广告请求设备ip的所属国家,非全球化开发者只能在国内请求广告
40029 模板渲染类型广告的请求方法或请求参数不正确 三种情况: 1. SDK版本低:使用的SDK版本过低,还不支持个性化模板渲染功能。解决办法:升级到平台最新版本SDK。 2. 服务端代码位配置未生效:新建代码位需要等2~3分钟再去请求广告。 3. 接口使用错误;创建的代码位类型是模板渲染,但是请求方法是非模板渲染的方法或者模板广告的请求方法中缺少setExpressViewAcceptedSize参数。解决办法:使用模板渲染的方法和正确的参数去请求模板渲染类型的广告。参考文档:https://partner.oceanengine.com/doc?id=5ecc8a5bec6540000eabbad2
40034 sdk_bidding_type 校验失败 代码位非服务端竞价,请检查代码位竞价类型
40042 新插屏广告使用SDK版本过低 升级SDK版本到3550及以上版本
50001 服务器错误 出现频率过大请反馈给穿山甲对接人员
60007 激励视频验证服务器异常或处理失败 激励视频使用服务端验证方式可能会出现此问题。一般由服务异常或者超时问题导致,建议多尝试几次
-1 数据解析失败 客户端代码问题的合集,可先排查以下情况: 1:在子线程调用了show。 2:注册点击事件时viewgroup传空。 3:媒体在onFeedLoaded回调里的业务逻辑发生了异常,导致SDK走到了onError回调中。 排查以上问题依然没有结论可以联系技术支持同学或者提交工单(包含代码位和出现概率以及请求时间)
-2 网络错误 检查网络连接或者查看是否设置了代理
-3 解析数据没有ad 需要重新请求广告
-4 返回数据缺少必要字段 需要重新请求广告
-5 BannerAd加载图片失败 需要重新请求广告
-6 插屏广告图片加载失败 需要重新请求广告
-7 开屏广告图片加载失败 需要重新请求广告
-8 频繁请求 客户端控制广告请求的频率
-10 缓存解析失败 需要重新请求广告
-11 缓存过期 需要重新请求广告
-12 缓存中没有开屏广告 需要重新请求广告
101 渲染结果数据解析失败 建议升级到穿山甲2955及以上版本SDK
102 未匹配到主模板 主模板没有下载到本地导致,偶发在首次请求广告时,偶现属于正常情况,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK
103 未匹配到子模板 偶发在接入初期,没有匹配到模板导致。待SDK将模板下载成功后不会出现,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK
107 模板渲染超时未回调 网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。建议升级到穿山甲2955及以上版本SDK
108 模板广告加载超时无返回 建议升级到穿山甲2955及以上版本SDK
109 模板加载失败 建议升级到穿山甲2955及以上版本SDK
601 链接建立失败 检查网络并重新发起广告请求
602 链接建立超时 检查网络并重新发起广告请求
603 广告返回异常 重新发起广告请求
604 广告解析失败 重新发起广告请求
605 广告解析失败 重新发起广告请求
606 广告解析异常 重新发起广告请求
607 广告读写失败 重新发起广告请求
608 广告读写失败 重新发起广告请求
609 广告下载失败 重新发起广告请求
610 广告下载异常 重新发起广告请求
611 广告请求被取消 重新发起广告请求
612 图片加载异常 重新发起广告请求
文档内容是否对您有帮助?
联系我们