Skip to content

广告错误码 ​

适用于 Banner、插屏和激励视频广告。错误回调参数见 BannerAd.onError、InterstitialAd.onError 和 RewardedVideoAd.onError。

errCode说明处理建议
-21001参数、调用顺序或广告对象状态错误,如 adUnitId 为空、请求频繁、广告未就绪或已销毁检查参数与调用顺序,等待 onLoad 后展示;加载失败时不要继续调用 show(),销毁后重新创建广告对象;触发频控时避免立即循环重试
-22001广告模块初始化、配置或接入异常,或没有可用广告候选;不能仅凭此码认定后台未配置广告先由 CP 在 OpenPaaS 后台为对应游戏开启广告能力,并核对广告单元 ID 与类型;结合 errMsg 核对宿主广告模块和广告源 Adapter 的接入、初始化及配置;Banner 还需核对最大容器尺寸与广告规格,所有候选均不适配时也可能返回此码
-22005广告配置请求失败,例如网络请求异常,或应用、游戏配置异常导致服务端拒绝配置请求;具体原因以 errMsg 为准先检查网络是否可用;若 errMsg 包含服务端失败信息,核对当前环境下的应用 ID、游戏 ID、应用与游戏的关联关系及平台配置,并根据服务端返回的原因修正配置,避免反复重试
-23001广告加载或展示失败,可能涉及超时、广告源失败或竞价结果不可用;不能仅凭此码认定没有广告填充结合 errMsg 中的具体原因处理,避免无效重试;重新加载并收到 onLoad 后再展示
-29001未分类的内部异常保留完整的 errCode、errMsg、平台、App/SDK 版本、广告类型、广告单元 ID 和复现步骤,联系技术支持

创建阶段排查: 如果 errMsg 提示未找到匹配广告位(如 No ad placement matches this adUnitId),先核对对应游戏在后台的广告开启状态、广告单元 ID 和类型。ad/init 返回成功时,广告单元列表仍可能为空;应先完成后台开启及配置核对,反复调用 load() 或 show() 无法解决配置缺失。

排查时同时保留错误码和完整错误信息:

  • errCode 是游戏侧统一错误分类;errMsg 中的 raw_code 是对应层的原始错误码,可能来自服务端、广告 SDK 或广告源,不能作为统一错误码使用。
  • stage、format、sources、raw_message 等诊断信息出现时,可辅助判断失败阶段、广告类型和广告源原因。不同平台、版本和失败路径的内容可能不同,不保证每次都有;不建议解析这些文本控制业务流程。
  • 同一错误码可能对应多个原因,应保留完整 errMsg,不要只截取错误码。