1. 开发者请先根据常见错误码定位问题，如以下内容无法涵盖开发者疑问，可以通过工单系统咨询。
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]。因屏蔽过多或者屏蔽策略调整导致，一般在调整屏蔽策略后出现。
| ||
详细说明：["reason": 218]。海外用户的广告请求，根据合规要求不可返回广告。 排查建议：请过滤非中国区广告请求请求。如在开发测试阶段，可检查是否有连接代理等情况。 | ||
详细说明：["reason": 228]。没有合适的广告返回。
| ||
详细说明：["reason": 234]。聚合属性代码位使用在非聚合。 排查建议：选择"用于GroMore"的代码位只能在GroMore SDK中使用。 | ||
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 |
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参数。解决办法:使用模板渲染的方法和正确的参数去请求模板渲染类型的广告。参考文档 |
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 | 图片加载异常 | 排查方向：重新发起广告请求。 |
Contact us
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock
