广告
游戏开发者快速接入
游戏脚本通过 sud 广告 API 接入;广告依赖、OP 初始化和隐私配置由宿主 APP 完成。先阅读 游戏开发示例,把广告加载、展示触发和资源清理绑定到实际游戏流程。
| 广告类型 | 游戏场景 | 接口总页 |
|---|---|---|
| Banner | 场景内展示,临时遮挡时隐藏,退出时销毁 | sud.createBannerAd |
| 插屏 | 关卡中准备,在自然间歇展示 | sud.createInterstitialAd |
| 激励视频 | 提前准备,用户主动选择后展示 | sud.createRewardedVideoAd |
广告错误码
| 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,不要只截取错误码。
