1. 开发者请先根据常见错误码定位问题，如以下内容无法涵盖开发者疑问，可以通过工单系统咨询。
2.若咨询穿山甲TS辅助排查，请参考穿山甲广告抓包提供问题对应的抓包文件。（抓包地址：:https://(ip地址或域名)/api/ad/union/sdk/get_ads/ ；抓包内容：广告请求及响应信息）
2.线上流量的填充率分析、优化建议可通过平台【数据】-【填充率诊断报告】路径查看。
错误码 | 说明 | 排查方向 |
20001 | 没有合适的广告返回而导致的请求没有填充,偶现属于正常情况 | 详细说明：["reason": 106]。该代码位设置了底价，此次出价未过底价。 排查建议：请适当地调整底价设置。 |
详细说明：["reason": 112]。该代码位请求量过大且产生的收入过低，因此填充率被限制。 排查建议：需根据代码位的广告数据分析流量较大但收益低的具体原因，建议关注展示率、转化率、用户留存等数据，提高代码位收益和请求量级比。 | ||
详细说明：["reason": 209]。请求频率过高。 排查建议：避免同一设备在一段时间内高频拉取广告。 | ||
详细说明：["reason": 210]。因屏蔽过多或者屏蔽策略调整导致，一般在调整屏蔽策略后出现。 排查建议：屏蔽策略调整后短时间内出现为正常情况，若出现此问题的概率较大且持续时间较长请联系对应的技术支持人员或通过工单进行反馈。 | ||
详细说明：["reason": 218]。海外用户的广告请求，根据合规要求不可返回广告。 排查建议：请过滤非中国区广告请求请求。如在开发测试阶段，可检查是否有连接代理等情况。 | ||
详细说明：["reason": 228]。没有合适的广告返回。 排查建议：开发者可以在穿山甲媒体平台上对设备进行自助加白解决，路径“广告变现”->“辅助工具”->“新建测试信息”填写相关信息，详细操作可参考：https://www.csjplatform.com/supportcenter/26570，加白生效时间30分钟左右。 | ||
详细说明：["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注意：部分商店会对第一次上线的APP进行二签，之后更新不会重签。 |
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渲染出错 | 排查方向：重新发起广告请求。 |
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
