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中使用。 | ||
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 | 图片加载异常 | 重新发起广告请求 |
Online Customer Service24/7 Online Customer Service BotManual customer service, weekdays 10~ 12 o'clock/14~ 19 o'clock