Bidding Android iOS JS Media API 常见问题

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参数

 文档反馈

腾讯公司 版权所有