错误码

原因

排查建议

20001_106

该代码位设置了底价，此次出价未过底价。

建议调整该代码位的底价设置(代码位->编辑->调整期望CPM)，测试阶段可以先去掉底价。

20001_112

该代码位请求量过大且产生的收入过低，因此填充率被限制。

错误码20001_112和流量质量关系较大，出于机器成本和对广告主负责的角度，平台会在流量请求策略的基础上合理的分配资源，保证广告主和开发者的权益。

命中该错误是十分正常的情况，建议您保持良好的广告请求习惯，避免无效的重复请求并提高用户转化效果，聚合场景可通过减少瀑布流层级或增加三方ADN代码位保证整体填充率，减少因请求量过大且收入过低触发填充限制的可能。
测试阶段推荐您使用测试阶预览工具保证填充。

20001_209

请求频率过高。

避免同一设备在一段时间内高频拉取广告。

20001_210

因屏蔽过多或者屏蔽策略调整导致，一般在调整屏蔽策略后出现。

屏蔽策略调整后短时间内出现为正常情况，若出现概率较大且持续时间较长，可先检查代码位的屏蔽配置，减少不必要的屏蔽规则，或降低屏蔽策略的调整频次

20001_218

海外用户的广告请求，根据合规要求不可返回广告。

请过滤非大陆广告请求，开发者如果有非大陆流量对接问题，可自行参考pangle平台接入指引

20001_228

没有合适的广告返回。

20001_228错误码线上有少量占比是十分正常的情况，如果您当前是测试阶段，可使用测试应用和测试代码位进行测试，或使用测试工具保证填充

20001_141

低send roi广告drop

错误码20001_141和流量质量关系较大，出于机器成本和对广告主负责的角度，平台会在流量请求策略的基础上合理的分配资源，保证广告主和开发者的权益。

有少量占比是十分正常的情况，建议您保持良好的广告请求习惯，避免无效的重复请求并提高用户转化效果，随着起量以及模型正确预估可缓解。
测试阶段推荐您使用测试预览工具保证填充

20001_234

创建的聚合属性代码位在非聚合场景中使用。

选择"用于GroMore"的代码位只能在GroMore SDK中使用，聚合场景广告请求操作如下：
1.SDK初始化时需将聚合开关，iOS：configuration.useMediation = YES；Android：.useMediation(true)；
2.将GroMore 属性的代码位ID 添加到GroMore的瀑布流中，用广告位ID发起聚合广告请求( 聚合广告ID以1开头，详细可参考：https://www.csjplatform.com/supportcenter/28094）。

40001

http request pb错误

对照穿山甲集成文档或demo检查一下广告请求是否缺少必要参数或透传参数类型是否匹配。

40004

代码位不能为空

检查设置的代码位位ID是否为空。Android：setCodeId(codeID)，iOS：slot.ID=self.viewModel.slotID;

40005

代码位请求尺寸不能为空

请检查设置广告请求的尺寸是否正确。如排查后仍无法解决，请联系对应的技术支持人员或通过工单进行反馈。

40006

代码位ID不合法

1. 聚合场景(usemediation=true)且请求用的广告位ID，请检查是否集成集成聚合基础库，Android：mediation-sdk、iOS：CSJMediation；
2. 新建的穿山甲代码位还未生效，建议等半个小时后重试
3. 确认代码位 ID 长度是否正确、是否包含多余空格，以及代码位或应用是否处于关停状态
如果以上仍没有解决可联系技术支持人员或通过工单进行反馈

40007

广告数量错误

检查设置的广告请求条数，仅信息流广告支持设置多条 （数量为1-3条）。

40008

图片尺寸错误

检查广告请求传入的广告尺寸是否正确，传入尺寸超过10000会导致该问题。

40009

媒体ID不合法

检查设置的应用ID，是否存在有特殊字符、空格、空值等情况。

40013

非开屏广告请求方法使用了开屏代码位ID

检查请求广告使用的代码位ID是否正确，开屏代码位ID为8开头的九位数字。

40016

代码位ID与应用ID不匹配或者应用ID缺失

1. 新建代码位需等待 30 分钟左右再发起请求
2. 保证在广告请求之前 SDK 已初始化完成，且应用 ID 设置正确
3. 重点检查下发或者设置的应用 ID、代码位 ID，确保二者匹配且传入正确

40018

平台上录入的包名与项目里的包名不一致

实际发出广告请求的包名和在平台上创建应用时填写的包名不匹配，需要检查发出广告的应用的包名。

40019

广告请求方法与代码位类型不匹配

例如平台上创建开屏代码位，但是代码中调用的接口是Banner或者其他非开屏的广告类型。可参考穿山甲的集成文档或Demo进行方法确认。

40020

开放注册新上线广告位超出日请求量限制

平稳放量,会逐渐放开限制。

40021

apk签名SHA1值与媒体平台录入的SHA1不一致

1. 部分应用商店会对第一次上线的 APP 进行二次签名（后续更新不会重签），若开发者未将商店二次签名后的 SHA1 值同步至媒体平台，也会导致该错误。
2. 开发阶段APP 的 debug 版本与 release 版本使用的签名文件需保持一致，否则可能因签名不一致触发错误。

40022

广告请求方法与代码位渲染方式不一致

请检查创建的代码位渲染方式与广告请求类型是否匹配。Banner和插屏广告，穿山甲平台目前仅支持模板渲染和自渲染两种方式，非原生Banner、插屏广告请求方法已经废弃。开发者创建了自渲染或者模板渲染的代码位，而使用了非原生Banner、插屏的广告请求方法，会出现此错误。需要开发者调整广告请求方法。

40024

SDK版本过低不返回广告

请升级到平台最新版本SDK，保证正常广告收益。

40026

海外ip请求中国服务器导致

请确认发出广告请求设备ip的所属国家，非全球化开发者只能在国内请求广告。

40029

模板渲染类型广告的请求方法或请求参数不正确

1. SDK版本低：使用的SDK版本过低，还不支持个性化模板渲染功能。

解决办法：升级到平台最新版本SDK。
2. 服务端代码位配置未生效：新建代码位需要等2~3分钟再去请求广告。
3. 接口使用错误；创建的代码位类型是模板渲染,但是请求方法是非模板渲染的方法或者模板广告的请求方法中缺少setExpressViewAcceptedSize参数。

解决办法：使用模板渲染的方法和正确的参数去请求模板渲染类型的广告。

40034

sdk_bidding_type 校验失败

1.需要确保在SDK初始化成功再发起请求。
2.聚合场景通过广告位ID发起请求（数字 1 开头）。
3.使用标准代码位请求了服务端竞价接口，建议检查后台创建的代码位类型是否符合预期，当检查了上述情况仍然没有解决问题时，建议通过抓包将对应的请求和返回提供给技术支持同学协助问题定位。

40042

新插屏广告使用SDK版本过低

请升级SDK至平台最新版本。

50001

服务器错误

出现频率过大请联系对应的技术支持人员或通过工单进行反馈。

60007

激励视频验证服务器异常或处理失败

激励视频使用服务端验证方式可能会出现此问题。一般由服务异常或者超时问题导致,建议多尝试几次。

98764

初始化失败

1.网络问题
2.检查手机时间是否正确
3.SDK更新时出现，可以删除包，重新集成。
以上都确认没问题，提供日志，反馈给排查同学进行排查

98765

初始化失败

1.删除pod下来的信息，重新pod install。
2.检查初始化参数是否传的正常。
3. 开发者可以通过集成纯SDK的工程测试下。
4.是否有对SDK so库做修改，比如：懒加载。
以上都确认没问题，提供日志，反馈给排查同学进行排查。

0/1/2/3/23

开屏广告物料加载失败或渲染失败

iOS-广告物料、素材加载失败：

BUSplashAdLoadError_UnKnow= 0，未知错误

BUSplashAdLoadError_DataError = 1，数据加载失败BUSplashAdLoadError_TimeOut = 2，超时
iOS-广告渲染失败：

CSJSplashAdError_Unknow = 0，未知错误

CSJSplashAdError_LoadFailed = 1， 物料加载失败 CSJSplashAdError_ResourceFailed = 2，素材加载失败 CSJSplashAdError_RenderFailed = 3，渲染失败 CSJSplashAdError_TimeOut = 23，超时

Android-加载失败回调：

csjAdError.getCode() == 1 ，物料加载失败

csjAdError.getCode() == 2 ，素材加载失败

csjAdError.getCode() == 3 ，渲染失败、渲染超时
Android-加载超时回调：

csjAdError.getCode() == 23

-8

频繁请求

客户端控制广告单用户维度广告请求的频率低于50次请求/10s时，可缓解此问题。

4205/4201

初始化失败

1. SDK 默认只支持armeabi-v7a,arm64-v8a两种架构，非支持的架构会触发4205错误，如需要其他架构的SDK包(armeabi 架构)，可联系技术支持获取；
2.请确认项目是否支持了com.android.support:appcompat-v7:28.0.0；
3.若项目是是 androidX版本,，则需要在android studio 的 gradle.properties 文件将 android.useAndroidX 和 android.enableJetifier 设置为 true

-2

网络错误

检查网络连接或者查看是否设置了代理。

-3

解析数据没有ad

需要重新请求广告。

-4

返回数据缺少必要字段

需要重新请求广告。

-5

BannerAd加载图片失败

需要重新请求广告。

-6

插屏广告图片加载失败

需要重新请求广告。

-7

开屏广告图片加载失败

需要重新请求广告，面向API级别28或更高级别的应用，是否使用明文网络流量默认为“ false”，尝试在application标签中添加 android:usesCleartextTraffic="true"解决。

-10

缓存解析失败

需要重新请求广告。

-11

缓存过期

需要重新请求广告。

-12

缓存中没有开屏广告

需要重新请求广告。

101

渲染结果数据解析失败

建议升级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

图片加载异常

重新发起广告请求。