iOS 错误码

错误码及错误信息获取

错误信息获取方式

1、使用ADJgSDK请求广告前,可以导入 <ADJgKit/ADJgKitLogging.h>并设置广告请求日志输出等级[ADJgSDK setLogLevel:ADJgKitLogLevelDebug],在控制台搜索括号内字符串(ADJgSDK [warn]:)会出现对应平台请求失败的错误信息、失败对应的时间以及其他信息,可以根据各平台的Error Domain查询对应的错误原因;

2、使用ADJgSDK请求广告,如果请求失败,在所有广告类型的广告请求失败回调中会有ADJgAdapterErrorDefine对象返回,ADJgAdapterErrorDefine对象的errorDetailDict属性是一个字典,里面中详细记录了每一个平台失败的原因。

错误码列表

如果ErrorDomain为ADJgAdapterErrorDomain,可在以下错误代码中找到对应问题,或者提供错误代码和ErrorDomain给到本平台技术或媒介:

错误代码错误说明
主SDK
100201开屏广告获取超时
100202横屏不加载开屏广告
100301banner广告获取超时
100101appId为空
100102包名和appId不对应
100103请求配置为空
100104未获取到加载广告的平台
100105未导入需要加载的广告类型对应的类
100106未导入天目
Tianmu 平台
360501激励视频广告未准备完成,请检查展示时机
360701全屏视频广告未准备完成,请检查展示时机
百度平台
270201开屏广告请求为空
270202开屏广告请求超时
270203开屏广告网络异常或其他异常
270204开屏广告尺寸异常
270205开屏展示失败
270206广告竞价失败,请检查广告位是否有竞价权限
270301横幅广告请求为空
270302横幅广告网络异常或其他异常
270303横幅广告尺寸异常
270701全屏视频广告请求为空
270702全屏视频广告网络异常或其他异常
270703全屏视频广告尺寸异常
270601插屏广告请求为空
270602插屏广告网络异常或其他异常
270603插屏广告尺寸异常
270604插屏广告竞价失败
270401信息流广告请求为空
270402信息流广告网络异常或其他异常
270403信息流广告尺寸异常
270404信息流广告竞价失败
270501激励视频广告请求为空
270502激励视频广告网络异常或其他异常
270503激励视频广告尺寸异常
270504激励视频广告服务端验证失败
270505激励视频广告竞价失败
270506激励视频广告缓存失败
穿山甲(头条)
22071全屏视频广告未知原因展示失败
22061插屏广告未知原因展示失败
22051激励视频广告未知原因展示失败
22052服务端验证失败,请服务端正确响应穿山甲服务端
22011信息流开屏请求失败,数据为空
优量汇
210201开屏广告未知原因展示失败
210501激励视频广告未知原因展示失败
210301竞价失败无权限或其他原因
快手
280701全屏视频广告未知原因展示失败
280702激励视频广告未知原因展示失败
280901开屏广告加载失败
281001插屏广告展示失败
280201开屏广告竞价失败
280501激励视频广告竞价失败
280601插屏广告竞价失败
280401信息流广告竞价失败
280401信息流广告竞价失败
汇量
240201开屏广告加载超时
240205开屏广告展示失败
240501激励视频广告服务端验证失败

###天目错误码列表

如果ErrorDomain是com.tianmuad.error时,可对照此错误码表

错误代码错误说明
100201广告获取超时
100101appId为空
100102包名和appId不对应
100103请求配置为空
100203传入posid不正确
100204落地页地址为空
100205无广告数据
100206未知错误
100207渲染错误 1、图片素材2、网络问题
100208达到频控限制
100209无可请求广告源
100210视频错误
100211资源准备未完成
100212广告数据无效(如为竞价广告请排查是否于有效时间内展示并上报竞价成功及上报价格合法)

###优量汇错误码列表

如果ErrorDomain是GDTAdErrorDomain时,可对照此错误码表

错误代码错误说明
3001网络错误
3003手机无网络
4001初始化错误, 包括广告位为空、AppKey为空、ViewController 为空
4003广告位错误
4006广告未曝光
4007设备不支持
4008设备方向不支持
4009开屏跳过按钮定义非法
4010开屏bottomView设置非法
4011请求广告超时
4013系统不支持,原生视频模板广告只支持 iOS 9 及以上系统
4014广告数据返回前尝试展示广告, 例如激励视频拉到广告后才可以调用展示接口
4015广告已经曝光过,不允许二次展示,请重新拉取
4016应用横竖方向与广告位支持方向不匹配
4017外部传入的VC无效
4018缓存文件在流程中被意外删除
4019开屏广告 rootViewController presentVC 被占用
5001后台数据错误
5002视频素材下载错误
5003视频素材播放错误
5004没匹配的广告,禁止重试,否则影响流量变现效果
5005广告请求量或者消耗等超过日限额,请第二天再请求广告
5006包名校验非法
5009广告请求量或者消耗等超过小时限额,请一小时后再请求广告
5010广告样式校验失败,请检查广告位与接口使用是否一致
5012广告过期,请重新拉取
5013广告拉取过于频繁,请稍后再试
5014视频广告视频和图片素材都下载错误
5015当前版本不出广告
5016JSON数据解析失败
5017adCount参数非法
5018广告位下线
5019视频时长超过设定时长
5020视频URL为空
6000未知错误,根据详细错误码在https://developers.adnet.qq.com/backend/error_code.html查询

头条错误码列表

如果ErrorDomain是com.bytedance.buadsdk时,可对照此错误码表

错误代码错误说明
20001没有合适的广告返回而导致的请求没有填充,偶尔出现属于正常情况。如果出现情况较多或者必现的话,请先检查一下广告尺寸是否填写正确,是否有使用模拟器测试广告,单个设备是否一天请求了大量广告但没有展示或者展示数极低等。排查以上问题依然没有结论可以联系技术支持同学或者提交工单(包含代码位和出现概率以及请求时间)相关同学查明后会做出回复。
40000http content type错误
40001http request pb错误
40002source_type=‘app’, 请求app不能为空
40003source_type=‘wap’, 请求wap不能为空
40004广告位不能为空
40005广告位尺寸不能为空
40006广告位ID不合法,例如,位数不对或者输入的广告位ID错误。
40007广告数量错误
40008图片尺寸错误
40009媒体ID不合法
40010媒体类型不合法
40011广告类型不合法
40012媒体接入类型不合法,已废弃
40013代码位ID是开屏代码位,但是adType不是开屏
40014redirect参数不正确
40015媒体请求里的字段上传的不正确或不完整,需要整改,请关注站内信的整改通知。
40016代码位ID 与应用ID 不匹配或者应用ID 缺失。初始化时需要填写appid,且在activity中需要填写代码位ID。媒体要确保这两个ID填写正确且匹配。
40017媒体接入类型不合法 API/SDK
40018媒体在平台上录入的包名与项目里的包名不一致。
40019媒体在平台上申请的代码位广告类型和代码中使用的广告类型接口不一致。例如平台上是开屏的广告类型,但是代码中请求的接口是banner或者其他非开屏的广告类型,如果不太清楚不同代码位类型对应的接口,麻烦去查询SDK包里的对接文档。
40020开发注册新上线广告位超出日请求量限制
40021apk签名SHA1值与媒体平台录入的SHA1不一致
40022媒体在平台上申请的代码位“是否原生”属性与代码中使用的接口不匹配。1、媒体在平台上选择的是个性化模板banner广告的话,Android代码中请参考BannerExpressActivity进行调用;iOS代码中请参考BUDExpressBannerViewController进行调用。2、媒体在平台上选择的是个性化模板插屏广告的话,代码中请参考InteractionExpressActivity进行调用;iOS代码位中请参考BUDExpressInterstitialViewController进行调用。
40023os字段填的不对
40024sdk 版本过低不返回广告
40025渲染异常,分为两种情况:1、Android版本,媒体使用了非该应用所属账号下的SDK版本导致,请媒体到该代码位所属账号下工具-文档下载展示的SDK版本去进行接入。2、iOS版本,媒体使用2100之前的版本可能渲染异常,请媒体更新到最新版本接入即可解决该问题。
40026使用海外ip请求国内服务器导致,请确认使用的是国内ip请求广告。
40028iOS老设备(涉及设备 iPad 4G/iPad 3G/iPhone 5/iPhone 5C/iPad Mini 1G/iPad 2G/iPhone 4S)被屏蔽,会不返回广告。在2310版本后放开了限制,媒体可以更新到2310或者之后的版本。
40029两种情况:1. SDK版本低;如果您使用了原生类型为模板渲染的广告,即个性化模板广告,Android版本不能低于2017,iOS版本不能低于2011;2、如果您的SDK版本(双端)大于等于2500,代码位的原生类型是模板渲染,麻烦确认使用的接口为个性化模板广告。
50001adCount参数非法
60001show event处理错误
60002click event处理错误
60007激励视频验证服务器异常或处理失败
-1数据解析失败。客户端代码问题的合集,可先排查以下情况:1、媒体在子线程调用了show。2、注册点击事件时viewgroup传空。3、媒体在onFeedLoaded回调里的业务逻辑发生了异常,导致SDK走到了onError回调中。排查以上问题依然没有结论可以联系技术支持同学或者提交工单(包含代码位和出现概率以及请求时间)。
-2网络错误
-3解析数据没有ad
-4返回数据缺少必要字段
-5bannerAd加载图片失败
-6插屏广告图片加载失败
-7开屏广告图片加载失败
-8频繁请求
-9请求实体为空
-10缓存解析失败
-11缓存过期
-12缓存中没有开屏广告
101渲染结果数据解析失败
102未匹配到主模板:主模板没有下载到本地导致。偶发在首次请求广告时属于正常情况。
103未匹配到子模板:偶发在接入初期,没有匹配到模板导致。待sdk将模板下载成功后不会出现。
104物料数据异常
105模板数据解析异常
106渲染异常
107模板渲染超时未回调,可能原因有1. 网络原因或者2. 硬件原因,因此导致渲染失败,可以更换手机或者网络环境测试