SDK相关问题排查
说明
如果根据正常的注册流程仍然无法在嵌入腾讯广告SDK的app中看到广告，可以在各个广告形式的delegate失败回调方法中输出错误信息。
腾讯广告在打印广告关键信息时会带上[GDTMob::GDTMob]的标记，其他带有GDTMob标记的log与广告信息无关。
SDK 错误码
| 错误码 | 错误信息 | 排查建议 |
|---|---|---|
| 3001 | 网络错误 | 请检查手机网络后再次发起广告请求 |
| 3003 | 网络不可用，无法连接到服务器 | 检查网络状态并重试 |
| 4001 | 初始化错误, 包括广告位为空、AppKey为空、ViewController为空 | |
| 4003 | 广告位错误 | 请根据错误信息提示修改嵌入代码 |
| 4006 | 广告未曝光 | 请根据错误信息提示修改嵌入代码 |
| 4007 | 当前广告形态不支持模拟器，或开屏不支持iPad | 建议使用真机、手机进行测试，如在进行通路测试或者仍未解决，请至反馈中心提交工单联系技术支持处理 |
| 4008 | 设备方向不适合展示广告 | 请根据错误信息提示修改嵌入代码 |
| 4010 | 开屏的bottomView高度超过了屏幕高度的25% | 可以参考优量汇demo代码进行修改和调试 |
| 4011 | 由于网络环境不佳或连有连接代理，导致开屏广告拉取超过设置时间 | 请保障网络畅通，并根据错误信息提示修改嵌入代码；在开屏广告下，可以通过fetchDelay设置超时时间为5s或者其他时间 |
| 4013 | 系统版本或SDK版本不支持此广告位 | 建议使用iOS10以上系统同时可以将优量汇SDK版本至最新 |
| 4014 | 广告未成功返回或广告无效时，启动了广告展示 | 请在广告返回后再进行展示广告的操作。具体方法为，请在show之前，使用isValid判断广告是否有效，当结果为true时再去调用show方法 |
| 4015 | 广告已经曝光过，不允许二次展示，请重新拉取 | 请重新拉取广告后再进行展示 |
| 4016 | 应用横竖方向与广告位支持方向不匹配 | 开发自查应用横竖屏状态与广告位支持方向是否匹配 |
| 4017 | 开发者传入的VC无效（针对激励视频、插屏半屏/全屏场景） | 建议开发者仔细检验参数后，重新发起广告请求 |
| 4018 | 缓存文件在流程中被意外删除 | |
| 4019 | 开屏广告 rootViewController presentVC 被占用 | 请确保开屏广告的presentVC不被占用后重新发起广告请求 |
| 4020 | window为空 | |
| 4021 | appId 错误，未正确注册 | 请检查SDK初始化接口传递的appId是否在开发者平台上正确注册 |
| 5001 | 后台数据异常，可能由于sdk版本过低导致 | 请升级优量汇SDK版本至最新，如仍有错误，请联系运营人员或至反馈中心提交工单联系技术支持处理 |
| 5002 | 视频素材下载错误，如网络环境不佳导致视频类广告无法下载 | 建议检查网络环境后重试，如仍有错误，请联系优量汇运营人员或至反馈中心提单咨询 |
| 5003 | 视频素材播放错误 | 建议稍后重试，如果重试仍然有错误，请联系运营人员或至反馈中心提交工单联系技术支持处理 |
| 5004 | 没有匹配到合适的广告资源，属于调试中或者线上广告的正常现象 | 如果您在调试环境中遇到此问题，可以通过帮助中的广告助手解决此类问题 |
| 5005 | 广告请求量或者消耗等超过日限额，请明天再请求广告 | 请明天再发起请求(由于数据延迟问题，建议第二天的00:30之后再发起请求) |
| 5006 | 包名校验错误，当前 App 的包名和优量汇官网注册媒体时填写的包名不一致，因此无广告返回 | 请检查接入优量汇 SDK 的 App 包名是否和注册时填写的一致，如仍有问题，请至反馈中心提单咨询 |
| 5009 | 广告请求量或者消耗等超过小时限额 | 请一小时后再请求广告 |
| 5010 | 广告位与调用接口不匹配，导致广告样式校验失败 | 请检查是否存在广告形态与调用接口不一致的情况。 比如，是否用插屏全屏广告位的实例化对象调用了插屏半屏接口loadAD() |
| 5012 | 广告过期，请重新拉取 | 建议在调用show之前使用isValid方法判断下广告是否有效，广告有效再去拉取广告（如果开发者有使用预加载广告一定要先判断再展示） |
| 5013 | 广告拉取过于频繁 | 请求过于频繁，服务器繁忙时会返回该错误码，请检测与控制请求频率 |
| 5014 | 广告被定向过滤（多发生在下载类广告，如应用安装或未安装），属于一种正常现象 | 开发者可酌情忽略，也可以通过调整一次广告请求返回的广告数量进行缓解 |
| 5015 | 当前版本不出广告 | 请升级优量汇SDK版本至最新，如仍有错误，请联系技术支持或运营人员 |
| 5016 | JSON数据解析失败 | 请至反馈中心提交工单联系技术支持处理， 提交工单时请附带上出现该问题的广告数据回包方便具体定位问题 |
| 5017 | adCount参数非法 | |
| 5018 | 广告位已被下线 | 请至平台流量合作板块，检查广告位是否被关闭、冻结或者已被删除 |
| 5020 | 视频URL为空 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5021 | 广告已下线 | 请至平台流量合作板块，检查广告位是否已经下线 |
| 5022 | VAST接入错误 | |
| 5024 | 广告位接口组合错误 | 请检查代码中是否存在插屏图文的广告位调用了插屏全屏视频接口的情况 |
| 5025 | 广告位list字段为空 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5026 | 实时请求返回预加载的回包 | |
| 5027 | 激励浏览页面加载失败 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5028 | 广告show函数参数校验失败 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5030 | 激励视频展示失败，播放器错误 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5032 | 使用Template的广告模板字段为空 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5033 | 广告数量错误 | |
| 5034 | 视频展示失败，播放器错误 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 5035 | 广告位未传，或传的内容为空 | 请在相应代码模块中检查广告位是否为空 |
| 5036 | 广告展示的时候未收到开发者传递的有效的vc参数 | 建议核对传递的参数。如果仍未解决，请至反馈中心提交工单联系技术支持处理 |
| 5043 | 模板渲染失败 | 请重新发起广告请求，报错占比较高请至反馈中心提交工单联系技术支持处理 |
| 6000 | 发生某些错误或问题，需要根据详细错误码来定位具体问题 | 可以查询后台错误码来具体定位问题 |
后台错误码
- 备注
1、对于未出现在表格中的错误码，当其出现的次数超过请求量占比的1%时，请联系腾讯优量汇广告技术支持同学进行处理。
2、若在反馈中心提单咨询问题时，可以将您出现报错的请求参数或者广告回包、错误日志等信息一并提供，方便更快定位问题。
| 错误码 | 报错原因 | 排查建议 |
|---|---|---|
| 100001 | 解析请求失败，如请求参数值没有正确进行url编码 | 请参考广告请求参数说明，并对每一个参数值进行url编码 |
| 100004 | 参数解析失败或参数值为1 | 请检查adposcount是否正确 |
| 100005 | 参数解析失败或参数值为空 | 请检查posid是否正确 |
| 100012 | 广告位宽度参数解析失败 | 请确认参数类型，应为非负整数 |
| 100014 | 广告位高度参数解析失败 | 请确认参数类型，应为非负整数 |
| 100016 | 广告位参数last_ad_ids字段数据类型错误 | 请确认参数类型，应为非负整数 |
| 100017 | 广告位参数last_ad_ids字段数据类型错误 | 请确认参数类型，应为字符串 |
| 100019 | 广告位参数is_information_pos字段数据类型错误 | 请确认参数类型，应为布尔类型 |
| 100023 | 广告位参数level字段数据类型错误 | 请确认参数类型，应为非负整数 |
| 100028 | 广告位参数query字段数据类型错误 | 请确认参数类型，应为字符串 |
| 100031 | 广告位参数max_duration字段数据类型错误 | 请确认参数类型，应为非负整数 |
| 100032 | 广告位参数traffic_type字段数据类型错误 | 请确认参数类型，应为非负整数 |
| 100034 | 广告位参数support_c2s字段数据类型错误 | 请确认参数类型，应为非负整数 |
| 100133 | 广告位填写错误，或广告位状态处于关闭状态；如是新建广告位并立刻请求了广告，则会由于系统索引不到而导致请求失败 | 请检查广告位ID的使用是否正确，并确保广告位处于开启状态（中途如有开关操作则需等待半小时后使用）；如是新建广告位，请在新建30分钟后请求广告 |
| 100135 | 媒体未通过审核或广告位处于「封禁、暂停、冻结」等状态 | 建议检查媒体或广告位状态，如有疑问可联系运营人员或至反馈中心提单咨询 |
| 100136 | 未匹配到合适规格和样式的素材资源 | 建议调整或扩充广告位的样式，如需了解详情，请至反馈中心提单咨询 |
| 100504 | 检测到请求来自非授权合作的聚合SDK | 建议使用已授权合作的聚合SDK。如需了解详情，请联系优量汇运营人员或至反馈中心提单咨询 |
| 102006 | 没有找到符合价格要求或体验要求的广告 | 建议适当调整底价/目标价的价格设置，或至平台广告中心检查核对屏蔽规则 |
| 106001 | 广告位不存在 | 请检查广告位ID是否正确 |
| 107000 | 广告位信息为空 | 请检查广告位ID是否正确 |
| 107007 | 缺少有效的设备标识字段 | 请检查oaid、imei等设备信息是否填写正确 |
| 107008 | 广告位所属媒体在优量汇平台关联的域名为空 | 请检查媒体域名是否正确 |
| 107009 | JS请求域名不匹配 | 请检查JS请求域名是否正确，确保与在平台注册的域名一致。可先进行域名校验，成功后再进行广告请求 |
| 107011 | 请求中的操作系统类型与广告位在优量汇平台的设置不匹配 | 请检查广告请求中的os字段是否正确 |
| 107029 | API请求中缺少合法的广告位宽度或高度 | 请确认API请求中，广告位宽度或高度合法 |
| 107030 | app_bundle_id无效 | 请参考app_bundle_id参数填写逻辑，检查接入SDK的App包名是否和注册时填写的一致 |
| 107035 | iOS - 系统版本或SDK版本不支持此广告位；Android - 在旧版SDK上使用了模板视频的广告位 | 请升级优量汇SDK版本至最新 |
| 107036 | 禁止广告展示页面嵌在iframe中 | 禁止广告展示页面嵌在iframe中 |
| 107040 | 错误的sdk接口调用，比如申请的广告位是原生自渲染，广告使用场景是信息流，却错误的调用了信息流的相关接口NativeExpressAD，就造成了广告位是自渲染，接口是模板渲染的不匹配情况 | 开发者检查是否存在广告位是原生自渲染，调用的接口却是模板渲染的场景 |
| 107041 | 目前使用的SDK版本已经废弃 | 请升级优量汇SDK版本至最新 |
| 107042 | API请求中adx_id不合法 | 请填写正确的adx_id |
| 107044 | API请求中oaid无效 | 请填写正确的oaid |
| 107045 | API请求中aid_ticket无效 | 请填写正确的aid_ticket |
| 107046 | API请求中taid_ticket无效 | 请填写正确的taid_ticket |
| 107047 | SDK的banner插屏1.0接口已废弃 | 请升级优量汇SDK版本至最新 |
| 107048 | SDK的原生自渲染1.0接口已废弃 | 请升级优量汇SDK版本至最新 |
| 107049 | JS旧准入规则已废弃，目前不支持iOS设备以及微信环境；或没有使用平台准入的测试环境 | 请升级准入规则，使用符合准入规则的测试设备如安卓版手机QQ、QQ浏览器 |
| 107050 | SDK接口与广告位不匹配 广告位是模板2.0广告位 | 请调用SDK模板2.0接口请求广告。如有疑问，请至反馈中心提单咨询 |
| 109506 | 该广告位处于流量测试期，且达到了日请求量上限，因此未返回广告 | 请明日00:30后再发送请求 |
| 109507 | 该广告位处于流量测试期，且达到了当前小时的请求量上限，因此未返回广告 | 请下一小时再发起请求 |
| 109502 | 请求过于频繁或返回未曝光，且产生的收入低，触发平台出于成本考虑的填充限制 | 建议减少无效的重复请求，提升广告曝光率 |
| 109512 | 没有找到合适的素材类型或规格。例如，非4G和WIFI网络，则无法返回视频广告 | 建议释放或调整广告位的素材要求 |
| 112001 | 由于成本等原因，当前暂无广告返回 | 建议减少无效的重复请求，如需了解详情，请至反馈中心提单咨询 |
| 112004 | 广告位类型错误，或广告接口出现问题 | 请修改广告位ID后进行重试，如有疑问，请至反馈中心提单咨询 |
| 132000 | 非server bidding请求,与广告位标签不匹配 | 请至开发者平台，检查广告位下的价格策略是否已经开启实时竞价策略 |
| 132005 | Server bidding请求，缺少token信息 | 请补充随价格返回的token信息 |
| 132007 | Server bidding请求回包为空 | 请检查随价格返回的token是否过期（token有效期为90s） |
| 132008 | server bidding请求广告时，token参数解析失败 | 请使用线上环境请求价格时返回的token参数，而非联调工具中的token参数 |