错误处理
如果广告加载或展示失败,您的广告展示委托或回传接口会收到调用。 该调用带有一个错误代码。 本页介绍了这些错误代码。
错误对象
您在回传中收到的错误是一等 (first-class) 错误对象。 该对象具有三个属性:
error["code"]
- 错误代码,见下表
error["message"]
- 描述该错误的可读信息
error["adLoadFailureInfo"]
- 包含错误代码以及每个广告平台未能加载广告的原因
MAX 错误代码
代码 | 描述 | Load / Display |
---|---|---|
204 | 当前没有适合设备的广告 (未填充)。对于该应用/设备,MAX 未从任何聚合平台返回符合条件的广告。 | L |
-1 | 系统处于异常状态。 该错误代码代表的错误无法归入其他已定义的错误类型。请查看错误对象中的消息字段,了解更多详情。 | L/D |
-23 | 您试图展示一则全屏广告 (插屏广告或激励广告),但另一则全屏广告仍在展示中。 | D |
-24 | 您试图在广告加载完成之前显示全屏广告。 | D |
-1000 | 由于一般网络错误,广告请求失败。请查看错误对象中的消息字段,了解更多详情。 | L |
-1001 | 由于网速较慢,广告请求超时。 | L |
-1009 | 设备未连接至互联网,广告请求失败。 | L |
-5001 | 无平台可填充广告,因此加载失败。MAX 已返回来自聚合平台的符合条件的广告,但所有广告均加载失败。请查看错误对象中的 adLoadFailureInfo 字段,了解更多详情。 | L |
-5201 | SDK 内部状态无效。该错误可由多种原因引起。 | L |
-5205 | 适配器在尝试展示时没有已准备好的广告。 | L |
-5209 | 未指明的内部错误。 | L |
-5601 | SDK 无法加载广告,因为找不到最顶层的 Activity 。 | L |
-5602 | SDK 未能展示广告,因为用户启用了 “Don’t Keep Activities” 开发者设置。 | D |
-5603 | SDK 无法加载广告,因为开发者提供了无效的广告单元标识符。广告单元标识符无效的可能原因有:
| L |
不同平台的错误代码
要进一步了解不同广告平台返回的错误代码,请查看这些平台发布的错误相关文档:
- BidMachine (Android) & BidMachine (iOS)
- Chartboost
- DT Exchange
- Google 竞价和 Google AdMob (Android) & Google 竞价和 Google AdMob (iOS)
- InMobi
- ironSource (Android) & ironSource (iOS)
- Liftoff Monetize
- Line (Android) & Line (iOS) (更多参考)
- Maio (Android) & Maio (iOS)
- Meta Audience Network
- Mintegral
- MoPub
- Ogury — 插屏广告 (Android) & Ogury — 插屏广告 (iOS)
- Ogury — opt-in 视频广告 (Android) & Ogury — opt-in 视频广告 (iOS)
- Ogury — 横幅广告 (Android) & Ogury — 横幅广告 (iOS)
- Pangle (Android) & Pangle (iOS)
- 腾讯 (Android) 腾讯 (iOS)
- Unity Ads (Android) & Unity Ads (iOS)
- Yandex
- YSO Network (Android) & YSO Network (iOS)