English
Log In
You can then view all documents
Installation/常见问题接入指南说明/穿山甲错误码说明详解/错误码列表
错误码列表
Last updated 2024-01-15 18:29:21

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]。没有合适的广告返回。


排查建议:开发者可以在穿山甲媒体平台上对设备进行自助加白解决,路径“广告变现”->“辅助工具”->“新建测试信息”填写相关信息,详细操作可参考: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渲染出错

排查方向:重新发起广告请求。

141

低send roi广告drop

排查方向:用户价值低不返回广告,提升用户转化。

98765

SDK初始化失败

排查方向:①.删除pod下来的信息,重新pod install ②.检查初始化参数是否传的正常 ③.可以通过集成纯SDK的工程进行测试验证,以上都确认没问题,提供日志,反馈给排查同学进行排查。

601

链接建立失败

排查方向:检查网络并重新发起广告请求。


602

链接建立超时

排查方向:检查网络并重新发起广告请求。


603

广告返回异常

排查方向:重新发起广告请求。


604

广告解析失败

排查方向:重新发起广告请求。


605

广告解析失败

排查方向:重新发起广告请求。


606

广告解析异常

排查方向:重新发起广告请求。


607

广告读写失败

排查方向:重新发起广告请求。


608

广告读写失败

排查方向:重新发起广告请求。


609

广告下载失败

排查方向:重新发起广告请求。


610

广告下载异常

排查方向:重新发起广告请求。


611

广告请求被取消

排查方向:重新发起广告请求。


612

图片加载异常

排查方向:重新发起广告请求。



Contents
Contact us