穿山甲SDK·常见错误码
- 开发者请先根据常见错误码定位问题，如以下内容无法涵盖开发者疑问，可以通过工单系统咨询。
2.若咨询穿山甲TS辅助排查，请参考穿山甲广告抓包提供问题对应的抓包文件。（抓包地址：:https://(ip地址或域名)/api/ad/union/sdk/get_ads/ ；抓包内容：广告请求及响应信息）
2.线上流量的填充率分析、优化建议可通过平台【数据】-【填充率诊断报告】路径查看。
3.GM常见错误码可参照帮助中心->GroMore SDK与API接入 ->错误码模块或登录穿山甲媒体平台->接入中心->GroMore->SDK->查看接入文档->基础集成说明->SDK错误码问题定位模块进行查询。
20001
没有合适的广告返回而导致的请求没有填充,偶现属于正常情况
详细说明：[“reason”: 106]。该代码位设置了底价，此次出价未过底价。
排查建议：请适当地调整底价设置。
详细说明：[“reason”: 112]。该代码位请求量过大且产生的收入过低，因此填充率被限制。
排查建议：需根据代码位的广告数据分析流量较大但收益低的具体原因，建议关注展示率、转化率、用户留存等数据，提高代码位收益和请求量级比。
详细说明：[“reason”: 209]。请求频率过高。
排查建议：避免同一设备在一段时间内高频拉取广告。
详细说明：[“reason”: 210]。因屏蔽过多或者屏蔽策略调整导致，一般在调整屏蔽策略后出现。
40001
http request pb错误
排查建议：对照穿山甲集成文档或demo检查一下广告请求是否缺少必要参数。
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
注意：部分商店会对第一次上线的APP进行二签，之后更新不会重签。
40022
广告请求方法与代码位渲染方式不一致
排查建议：请检查创建的代码位渲染方式与广告请求类型是否匹配。Banner和插屏广告,穿山甲平台目前仅支持模板渲染和自渲染两种方式,非原生Banner、插屏广告请求方法已经废弃。开发者创建了自渲染或者模板渲染的代码位,而使用了非原生Banner、插屏的广告请求方法,会出现此错误。需要开发者调整广告请求方法。
40024
SDK版本过低不返回广告
排查建议：请升级到平台最新版本SDK，保证正常广告收益。
40025
渲染异常
排查建议：
1、Android:SDK版本使用不正确,媒体使用了非该应用所属账号下的SDK版本导致,请到该代码位所属账号下工具-文档下载展示的SDK版本去进行接入。
2、iOS:媒体使用2100之前的版本可能渲染异常,请更新到最新版本接入即可解决该问题。
40026
海外ip请求中国服务器导致
排查建议：请确认发出广告请求设备ip的所属国家,非全球化开发者只能在国内请求广告。
40029
模板渲染类型广告的请求方法或请求参数不正确
三种情况:
- SDK版本低:使用的SDK版本过低,还不支持个性化模板渲染功能。解决办法:升级到平台最新版本SDK。
- 服务端代码位配置未生效：新建代码位需要等2~3分钟再去请求广告。
- 接口使用错误；创建的代码位类型是模板渲染,但是请求方法是非模板渲染的方法或者模板广告的请求方法中缺少setExpressViewAcceptedSize参数。解决办法:使用模板渲染的方法和正确的参数去请求模板渲染类型的广告。参考文档
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
未匹配到主模板
排查方向：主模板没有下载到本地导致,偶发在首次请求广告时,偶现属于正常情况,出现之后请多尝试多次请求。建议升级到穿山甲SDK最新版本。
103
未匹配到子模板
排查方向：偶发在接入初期,没有匹配到模板导致。待SDK将模板下载成功后不会出现,出现之后请多尝试多次请求。建议升级到穿山甲SDK最新版本。
107
模板渲染超时未回调
排查方向：网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。建议升级到穿山甲SDK最新版本。
108
模板广告加载超时无返回
排查方向：建议升级到穿山甲SDK最新版本。
109
模板加载失败
排查方向：建议升级到穿山甲SDK最新版本。
113
原生动态化1.0 JS 解析出错
排查方向：重新发起广告请求。
117
原生动态化1.0 JS 解析超时
排查方向：重新发起广告请求。
118
原生动态化1.0 渲染错误
排查方向：重新发起广告请求。
123
原生动态化2.0 SDK解析出错
排查方向：重新发起广告请求。
127
原生动态化2.0 SDK解析超时
排查方向：重新发起广告请求。
128
原生动态化2.0 SDK渲染出错
排查方向：重新发起广告请求。
141
低send roi广告drop
排查方向：用户价值低不返回广告，提升用户转化。
601
链接建立失败
排查方向：检查网络并重新发起广告请求。
602
链接建立超时
排查方向：检查网络并重新发起广告请求。
603
广告返回异常
排查方向：重新发起广告请求。
604
广告解析失败
排查方向：重新发起广告请求。
605
广告解析失败
排查方向：重新发起广告请求。
606
广告解析异常
排查方向：重新发起广告请求。
607
广告读写失败
排查方向：重新发起广告请求。
608
广告读写失败
排查方向：重新发起广告请求。
609
广告下载失败
排查方向：重新发起广告请求。
610
广告下载异常
排查方向：重新发起广告请求。
611
广告请求被取消
排查方向：重新发起广告请求。
612
图片加载异常
排查方向：重新发起广告请求。