SDK 相关问题排查
debug工具
如果根据正常的注册流程仍然无法在嵌入优量汇 SDK 的 app 中看到广告，可以尝试使用 logcat 排查问题。优量汇 SDK 默认设置下会对广告流程中的关键步骤打印日志，日志格式如下：
LogTag ：gdt_ad_mob
过滤并保存日志，示例如下：
$adb logcat -c
$adb logcat -s gdt_ad_mob > [directory]/myLog.log
SDK 错误码
| 错误码 | 报错原因 | 排查建议 |
|---|---|---|
| 2001 | SDK版本较低，或系统应用不支持插件 | 可以将SDK升级至最新版本。如在进行通路测试或者仍未解决，请至反馈中心提交工单联系技术支持处理 |
| 2002 | 内部错误 | 反馈给优量汇运营，提供错误码和错误信息 |
| 2003 | SDK未初始化 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 3001 | 网络异常 | 检查网络状态并重试 |
| 3002 | 网络超时 | 检查网络状态并重试 |
| 3003 | 网络不可用，无法连接到服务器 | 检查网络状态并重试 |
| 4001 | 初始化错误, 包括广告位为空、App ID为空、Context/Activity为空 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4002 | 请检查 Manifest 文件中的 Activity/Service/Permission 的声明是否正确以及声明的权限是否都已授予 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4003 | 广告位错误 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4004 | 开屏广告容器不可见 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4005 | 开屏广告容器尺寸错误 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4006 | 广告接口调用顺序错误，调用点击接口前未调用曝光接口 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4007 | 当前广告形态不支持模拟器，或开屏不支持Pad | 建议使用真机、手机进行测试，如在进行通路测试或者仍未解决，请至反馈中心提交工单联系技术支持处理 |
| 4008 | 设备方向不适合展示广告 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4009 | 开屏广告的自定义跳过按钮尺寸低于3x3dp | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 4011 | 由于网络环境不佳或连有连接代理，导致开屏广告拉取超过设置时间 | 请保障网络畅通，并根据错误信息提示修改嵌入代码；在开屏广告下，可以通过fetchDelay设置超时时间为5s或者其他时间解决 |
| 4012 | 内容广告接口调用顺序错误，调用点击接口前未调用曝光接口 | 注意内容接口调用 |
| 4013 | 在旧版的 SDK 上使用了模板视频的广告位，需要升级 SDK | 请升级到最新版SDK |
| 4014 | 广告未成功返回或广告无效时，启动了广告展示 | 请在广告返回后再进行展示广告的操作。具体方法为，请在show之前，使用isValid判断广告是否有效，当结果为true时再去调用show方法 |
| 4015 | 同一条广告不允许多次展示 | 重新拉取广告后再进行展示 |
| 4016 | 应用横竖方向参数与广告位支持方向不匹配 | 开发自查应用横竖屏状态与广告位支持方向是否匹配 |
| 4017 | 广告实例尚未准备好 | 请确保在注册实例成功后再调用实例的相关方法 |
| 5001 | 后台数据异常，可能由于sdk版本过低导致 | 请升级优量汇SDK版本至最新，如仍有错误，请联系运营人员或至反馈中心提交工单联系技术支持处理 |
| 5002 | 视频素材下载错误，如网络环境不佳导致视频类广告无法下载 | 建议检查网络环境后重试，如仍有错误，请联系优量汇运营人员或至反馈中心提单咨询 |
| 5003 | 视频素材播放错误 | 建议稍后重试，如果重试仍然有错误，请反馈给优量汇运营 |
| 5004 | 没有匹配到合适的广告资源，属于调试中或者线上广告的正常现象 | 此情况下禁止多次重试请求广告，否则可能影响系统对您流量的评价从而影响变现效果。如果您在调试环境中遇到此问题，可以通过帮助中的广告助手解决此类问题 |
| 5005 | 广告请求量或者消耗等超过日限额，请明天再请求广告 | 请明天再发起请求(由于数据延迟问题，建议第二天的00:30之后再发起请求) |
| 5006 | 包名校验错误，当前 App 的包名和优量汇官网注册媒体时填写的包名不一致，因此无广告返回 | 请检查接入优量汇 SDK 的 App 包名是否和注册时填写的一致，否则将影响您的收益 |
| 5007 | 资源加载错误 | 建议稍后重试，如果重试仍然有错误，请反馈给优量汇运营 |
| 5008 | 调试期间使用连接代理或者网络不佳，导致图片加载错误 | 建议关闭代理或者确保网络状况良好再去请求广告，如仍有错误，请至反馈中心提单咨询 |
| 5009 | 广告请求量或者消耗等超过小时限额，请一小时后再请求广告 | 请一小时后再请求广告 |
| 5010 | 广告位与调用接口不匹配，导致广告样式校验失败 | 如请检查是否存在广告形态与调用接口不一致的情况。比如是否用插屏全屏广告位的实例化对象调用了插屏半屏接口loadAD() |
| 5011 | 平台模板渲染失败 | 这种情况一般是平台模板在服务端渲染失败，导致返回的数据和模板数不一致导致的，请将该问题反馈给优量汇运营排查 |
| 5012 | 广告数据过期 | 建议在调用show之前使用isValid方法判断下广告是否有效，广告有效再去拉取广告（如果开发者有使用预加载广告一定要先判断再展示） |
| 5013 | 广告请求过于频繁 | 请求过于频繁，服务器繁忙时会返回该错误码，请检测与控制请求频率 |
| 5014 | 广告被定向过滤（多发生在下载类广告，如应用安装或未安装），属于一种正常现象 | 开发者可酌情忽略，也可以通过调整一次广告请求返回的广告数量进行缓解 |
| 5018 | 广告位已被下线，或用户手机版本较低 | 请至开发者平台流量合作板块，检查广告位是否被关闭、冻结或者已被删除。 |
| 5019 | 广告AppId被封 | 请至平台流量合作板块，检查AppId的状态，确保AppId为有效状态后再发起广告请求 |
| 5021 | 该类型广告已下线 | 该广告类型已废弃，不再返回广告，请使用其他类型广告 |
| 5022 | 模板激励视频渲染失败 | 建议稍后重试，如果重试仍然有错误，请反馈给优量汇运营 |
| 5024 | 广告位接口组合错误 | 请检查代码中是否存在开屏非全屏广告使用全屏接口的情况 |
| 5041 | 断点续安装提示 | loadGDTApk() 接口的调用过于频繁 |
| 5042 | 断点续安装提示 | 断点续安装提示 loadGDTApk() 和 startInstall(GDTApk apk) 接口的调用间隔时间过长 |
| 5043 | 断点续安装提示 | 调用 startInstall(GDTApk apk) 时，Apk 文件不存在 |
| 5044 | 断点续安装提示 | 调用 loadGDTApk() 时，当前不存在有效的 Apk 文件 |
| 5045 | 断点续安装提示 | 断点续安装提示接口的功能未开启，需要申请 |
| 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参数 |
注意事项
- 确保所使用的
android-support-v4.jar包中的android.support.v4.app.NotificationCompat.Builder类包含setProgress方法，如果不包含此方法请升级 android 开发套件 为了使 SDK 在多进程 APP 内正常运行需要在代码调用广告相关 API 之前调用：
/*仅限于和 DownloadService 的不在同一进程的 Activity*/ MultiProcessFlag.setMultiProcess(true);一次请求多少条广告合适：我们限制一次请求1-10条广告，具体一次请求几条广告，与您的优化策略有关
如果你的目标是优化填充率，那么一次应该请求更多的广告
- 广告返回后，我们会在客户端对返回的广告进行处理，其中包括广告过滤，如果请求广告过少，则有可能过滤掉全部返回的广告，导致无填充
- 一次请求更多广告并缓存使用，可减少广告请求超时带来的填充率下降
如果你的目标是优化CPM，那么一次应该请求更少的广告
- 单次请求内的多条广告的预估CPM是递减的。请求的广告越多，广告的平均预估CPM越低
- 我们的广告匹配算法致力于为当前用户在当前环境下找到最匹配的广告。缓存广告可能使得在广告曝光时，用户环境、广告状态等已经与请求时不同，使得缓存的广告已经不是当前最佳匹配广告，也就是说，并不是当前最高CPM的广告