iOS 错误码
错误码及错误信息获取
错误信息获取方式
1、使用ADSuyiSDK请求广告前，可以导入 <ADSuyiKit/ADSuyiKitLogging.h>并设置广告请求日志输出等级[ADSuyiSDK setLogLevel:ADSuyiKitLogLevelDebug]，在控制台搜索括号内字符串（ADSuyiSDK [warn]:）会出现对应平台请求失败的错误信息、失败对应的时间以及其他信息，可以根据各平台的Error Domain查询对应的错误原因；
2、使用ADSuyiSDK请求广告，如果请求失败，在所有广告类型的广告请求失败回调中会有ADSuyiAdapterErrorDefine对象返回，ADSuyiAdapterErrorDefine对象的errorDetailDict属性是一个字典，里面中详细记录了每一个平台失败的原因。
错误码列表
如果ErrorDomain为ADSuyiAdapterErrorDomain，可在以下错误代码中找到对应问题，或者提供错误代码和ErrorDomain给到本平台技术或媒介：
| 错误代码 | 错误说明 |
|---|---|
| 主SDK | |
| 100201 | 开屏广告获取超时 |
| 100202 | 横屏不加载开屏广告 |
| 100301 | banner广告获取超时 |
| 100101 | appId为空 |
| 100102 | 包名和appId不对应 |
| 100103 | 请求配置为空 |
| 100104 | 未获取到加载广告的平台 |
| 100105 | 未导入需要加载的广告类型对应的类 |
| 100106 | 未导入天目 |
| Tianmu 平台 | |
| 360501 | 激励视频广告未准备完成，请检查展示时机 |
| 360701 | 全屏视频广告未准备完成，请检查展示时机 |
| 百度平台 | |
| 270201 | 开屏广告请求为空 |
| 270202 | 开屏广告请求超时 |
| 270203 | 开屏广告网络异常或其他异常 |
| 270204 | 开屏广告尺寸异常 |
| 270205 | 开屏展示失败 |
| 270206 | 广告竞价失败,请检查广告位是否有竞价权限 |
| 270301 | 横幅广告请求为空 |
| 270302 | 横幅广告网络异常或其他异常 |
| 270303 | 横幅广告尺寸异常 |
| 270304 | 横幅广告竞价失败 |
| 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 | 信息流广告竞价失败 |
| 280301 | 横幅广告竞价失败 |
| gromore | |
| 32071 | 全屏视频广告未知原因展示失败 |
| 32061 | 插屏广告未知原因展示失败 |
| 32051 | 激励视频广告未知原因展示失败 |
| 32052 | 激励视频广告服务端验证失败 |
| 京媒 | |
| 340201 | 开屏广告未知原因展示失败 |
###天目错误码列表
如果ErrorDomain是com.tianmuad.error时，可对照此错误码表
| 错误代码 | 错误说明 |
|---|---|
| 100201 | 广告获取超时 |
| 100101 | appId为空 |
| 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 | 当前版本不出广告 |
| 5016 | JSON数据解析失败 |
| 5017 | adCount参数非法 |
| 5018 | 广告位下线 |
| 5019 | 视频时长超过设定时长 |
| 5020 | 视频URL为空 |
| 6000 | 未知错误，根据详细错误码在https://developers.adnet.qq.com/backend/error_code.html查询 |
头条错误码列表
如果ErrorDomain是com.bytedance.buadsdk时，可对照此错误码表
| 错误代码 | 错误说明 |
|---|---|
| 20001 | 没有合适的广告返回而导致的请求没有填充，偶尔出现属于正常情况。如果出现情况较多或者必现的话，请先检查一下广告尺寸是否填写正确，是否有使用模拟器测试广告，单个设备是否一天请求了大量广告但没有展示或者展示数极低等。排查以上问题依然没有结论可以联系技术支持同学或者提交工单（包含代码位和出现概率以及请求时间）相关同学查明后会做出回复。 |
| 40000 | http content type错误 |
| 40001 | http request pb错误 |
| 40002 | source_type=‘app’, 请求app不能为空 |
| 40003 | source_type=‘wap’, 请求wap不能为空 |
| 40004 | 广告位不能为空 |
| 40005 | 广告位尺寸不能为空 |
| 40006 | 广告位ID不合法，例如，位数不对或者输入的广告位ID错误。 |
| 40007 | 广告数量错误 |
| 40008 | 图片尺寸错误 |
| 40009 | 媒体ID不合法 |
| 40010 | 媒体类型不合法 |
| 40011 | 广告类型不合法 |
| 40012 | 媒体接入类型不合法，已废弃 |
| 40013 | 代码位ID是开屏代码位，但是adType不是开屏 |
| 40014 | redirect参数不正确 |
| 40015 | 媒体请求里的字段上传的不正确或不完整，需要整改，请关注站内信的整改通知。 |
| 40016 | 代码位ID 与应用ID 不匹配或者应用ID 缺失。初始化时需要填写appid，且在activity中需要填写代码位ID。媒体要确保这两个ID填写正确且匹配。 |
| 40017 | 媒体接入类型不合法 API/SDK |
| 40018 | 媒体在平台上录入的包名与项目里的包名不一致。 |
| 40019 | 媒体在平台上申请的代码位广告类型和代码中使用的广告类型接口不一致。例如平台上是开屏的广告类型，但是代码中请求的接口是banner或者其他非开屏的广告类型，如果不太清楚不同代码位类型对应的接口，麻烦去查询SDK包里的对接文档。 |
| 40020 | 开发注册新上线广告位超出日请求量限制 |
| 40021 | apk签名SHA1值与媒体平台录入的SHA1不一致 |
| 40022 | 媒体在平台上申请的代码位“是否原生”属性与代码中使用的接口不匹配。1、媒体在平台上选择的是个性化模板banner广告的话，Android代码中请参考BannerExpressActivity进行调用；iOS代码中请参考BUDExpressBannerViewController进行调用。2、媒体在平台上选择的是个性化模板插屏广告的话，代码中请参考InteractionExpressActivity进行调用；iOS代码位中请参考BUDExpressInterstitialViewController进行调用。 |
| 40023 | os字段填的不对 |
| 40024 | sdk 版本过低不返回广告 |
| 40025 | 渲染异常，分为两种情况：1、Android版本，媒体使用了非该应用所属账号下的SDK版本导致，请媒体到该代码位所属账号下工具-文档下载展示的SDK版本去进行接入。2、iOS版本，媒体使用2100之前的版本可能渲染异常，请媒体更新到最新版本接入即可解决该问题。 |
| 40026 | 使用海外ip请求国内服务器导致，请确认使用的是国内ip请求广告。 |
| 40028 | iOS老设备（涉及设备 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，代码位的原生类型是模板渲染，麻烦确认使用的接口为个性化模板广告。 |
| 50001 | adCount参数非法 |
| 60001 | show event处理错误 |
| 60002 | click event处理错误 |
| 60007 | 激励视频验证服务器异常或处理失败 |
| -1 | 数据解析失败。客户端代码问题的合集，可先排查以下情况：1、媒体在子线程调用了show。2、注册点击事件时viewgroup传空。3、媒体在onFeedLoaded回调里的业务逻辑发生了异常，导致SDK走到了onError回调中。排查以上问题依然没有结论可以联系技术支持同学或者提交工单（包含代码位和出现概率以及请求时间）。 |
| -2 | 网络错误 |
| -3 | 解析数据没有ad |
| -4 | 返回数据缺少必要字段 |
| -5 | bannerAd加载图片失败 |
| -6 | 插屏广告图片加载失败 |
| -7 | 开屏广告图片加载失败 |
| -8 | 频繁请求 |
| -9 | 请求实体为空 |
| -10 | 缓存解析失败 |
| -11 | 缓存过期 |
| -12 | 缓存中没有开屏广告 |
| 101 | 渲染结果数据解析失败 |
| 102 | 未匹配到主模板：主模板没有下载到本地导致。偶发在首次请求广告时属于正常情况。 |
| 103 | 未匹配到子模板：偶发在接入初期，没有匹配到模板导致。待sdk将模板下载成功后不会出现。 |
| 104 | 物料数据异常 |
| 105 | 模板数据解析异常 |
| 106 | 渲染异常 |
| 107 | 模板渲染超时未回调，可能原因有1. 网络原因或者2. 硬件原因，因此导致渲染失败，可以更换手机或者网络环境测试 |