错误码

说明

排查方向

20001

没有合适的广告返回而导致的请求没有填充,偶现属于正常情况

["reason": 106]该代码位设置了底价，此次出价未过底价。建议：请适当地调整底价设置

["reason": 112]该代码位请求量过大且产生的收入过低，因此填充率被限制。建议：需根据代码位的广告数据分析流量较大但收益低的具体原因，建议关注展示率、转化率、用户留存等数据，提高代码位收益和请求量级比。

["reason": 209]请求频率过高。建议：避免同一设备在一段时间内高频拉取广告。

["reason": 210]因屏蔽过多或者屏蔽策略调整导致，一般在调整屏蔽策略后出现。建议：屏蔽策略调整后短时间内出现为正常情况，若出现此问题的概率较大且持续时间较长请联系对应的支持人员或通过工单进行反馈。

["reason": 218]海外用户的广告请求，根据合规要求不可返回广告。 建议：请过滤非中国内地的请求。如在开发测试阶段，可检查是否有连接代理等情况

["reason": 228]没有合适的广告返回。 建议：需检查流量使用并提高用户质量。如在开发测试阶段，需添加测试设备/尝试更换测试设备解决，另不建议使用模拟器测试

["reason": 234]聚合属性代码位使用在非聚合。

建议：选择"用于GroMore"的代码位只能在GroMore SDK中使用。

40004

代码位不能为空

检查设置的代码位位ID是否为空

40005

代码位请求尺寸不能为空

请检查设置广告请求的尺寸是否正确

40006

代码位ID不合法

代码位ID长度不对,或者传了空字符串。注：如新创建的代码位或编辑代码位的操作需要15分钟左右的生效时间

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注意：部分商店会对第一次上线的APP进行二签，之后更新不会重签。

40022

广告请求方法与代码位渲染方式不一致

请检查创建的代码位渲染方式与广告请求类型是否匹配。

40024

SDK版本过低不返回广告

请升级到平台最新版本SDK，保证正常广告收益。

40025

渲染异常

1.开发测试阶段请检查测试机的时区、时间是否准确2.390x以上版本默认只支持armeabi-v7a,arm64-v8a架构，非支持的架构，会触发报40025 3.参考集成文档，检查一下混淆规则

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

开屏广告图片加载失败

需要重新请求广告。面向API级别28或更高级别的应用，是否使用明文网络流量默认为“ false”，尝试在application标签中添加 android:usesCleartextTraffic="true"解决。

-8

频繁请求

客户端控制广告请求的频率

-10

缓存解析失败

需要重新请求广告

-11

缓存过期

需要重新请求广告

-12

缓存中没有开屏广告

需要重新请求广告

101

渲染结果数据解析失败

建议升级到穿山甲2955及以上版本SDK

102

未匹配到主模板

主模板没有下载到本地导致,偶发在首次请求广告时,偶现属于正常情况,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK

103

未匹配到子模板

偶发在接入初期,没有匹配到模板导致。待SDK将模板下载成功后不会出现,出现之后请多尝试多次请求。建议升级到穿山甲2955及以上版本SDK

107

模板渲染超时未回调

网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。建议升级到穿山甲2955及以上版本SDK

108

模板广告加载超时无返回

建议升级到穿山甲2955及以上版本SDK

109

模板加载失败

建议升级到穿山甲2955及以上版本SDK

113

原生动态化1.0 JS 解析出错

重新发起广告请求

117

原生动态化1.0 JS 解析超时

重新发起广告请求

118

原生动态化1.0 渲染错误

重新发起广告请求

123

原生动态化2.0 SDK解析出错

重新发起广告请求

127

原生动态化2.0 SDK解析超时

重新发起广告请求

128

原生动态化2.0 SDK渲染出错

重新发起广告请求

601

链接建立失败

检查网络并重新发起广告请求

602

链接建立超时

检查网络并重新发起广告请求

603

广告返回异常

重新发起广告请求

604

广告解析失败

重新发起广告请求

605

广告解析失败

重新发起广告请求

606

广告解析异常

重新发起广告请求

607

广告读写失败

重新发起广告请求

608

广告读写失败

重新发起广告请求

609

广告下载失败

重新发起广告请求

610

广告下载异常

重新发起广告请求

611

广告请求被取消

重新发起广告请求

612

图片加载异常

重新发起广告请求