错误码

原因

排查建议

20001_106

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

请适当地调整底价设置，若为测试阶段可创建无底价代码位进行测试。

20001_112

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

需根据代码位的广告数据分析流量较大但收益低的具体原因，建议关注展示率、转化率、用户留存等数据，提高代码位收益和请求量级比，如果频繁出现该错误码，建议更换测试设备进行测试。

20001_209

请求频率过高。

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

20001_210

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

屏蔽策略调整后短时间内出现为正常情况，若出现此问题的概率较大且持续时间较长请联系对应的技术支持人员或通过工单进行反馈。

20001_218

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

请过滤非大陆广告请求,开发者如果有非大陆流量对接问题，

烦请发送邮件至 pangle_support@bytedance.com ，以便获取到正确

的海外专属SDK版本进行对接。

20001_228

没有合适的广告返回。

开发者可以在穿山甲媒体平台上对设备进行自助加白解决，路径““接入与测试”->“测试工具”->“新建测试信息”填写相关信息，详细操作可参考：https://www.csjplatform.com/supportcenter/26570，加白生效时间30分钟左右。

20001_141

低send roi广告drop

用户价值低不返回广告，提升用户转化。

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)

slot.ID = self.viewModel.slotID;

40005

代码位请求尺寸不能为空

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

40006

代码位ID不合法

1.须确保在SDK初始化完成后发起广告请求并确认是否开启聚合功能->iOS：configuration.useMediation = YES；Android：.useMediation(true)

2.可以配置本地导入配置功能来缓解此场景，平台操作指引：在应用详情页，下拉导出数据列表，点击“导出配置信息”，参考示例填写融合SDK版本、包名、穿山甲版本号填写融合SDK版本号即可、其他ADN版本号后，即可完成配置信息导出。

接入代码块：

iOS：

BUAdSDKConfiguration *configuration = [BUAdSDKConfiguration configuration];

// 提前导入配置

configuration.mediation.advanceSDKConfigPath = [[NSBundle mainBundle]pathForResource:@"GroMore-config-ios-5000546" ofType:@"json"];

Android：

需将平台下载的文件内容转换为jsonObject

TTAdConfig.Builder().appId("5001121")

.appName("APP测试媒体")

.setMediationConfig(

MediationConfig.Builder()

.setCustomLocalConfig(jsonObject)

.build()

)

.build() TTAdSdk.init(getContext(), adConfig,new TTAdSdk.InitCallback() {});

3.新创建的广告位ID有生效期，一般半小时左右生效；

4.若为新建代码位，需1-2小时生效，生效后再发起广告请求;

5.检查代码位状态：「运行中」、「测试」、「停止」；

如果以上仍没有解决可联系技术支持人员或通过工单进行反馈

40007

广告数量错误

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

40008

图片尺寸错误

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

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，保证正常广告收益。

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

图片加载异常

重新发起广告请求。