错误处理
如果广告加载或展示失败,您的广告展示委托或回传接口会收到调用。 该调用带有一个错误代码。 本页介绍了这些错误代码。
错误对象
您在回传中收到的错误是一个实现 ErrorInfo
的一等 (first-class) 错误对象。
该对象具有以下 API:
Code
- 错误代码,见下表。
Message
- 描述该错误的可读信息。
MediatedNetworkErrorCode
- 被聚合平台针对该错误的错误码。 仅适用于广告展示失败回传中返回的错误。
MediatedNetworkErrorMessage
- 返回被聚合平台针对该错误的错误信息。 默认为空字符串。 仅适用于广告展示失败回传中返回的错误。
WaterfallInfo
- 查看已加载或加载失败广告的当前瀑布流信息。 平台响应会提供瀑布流中每则广告的广告加载状态、延迟、配置信息和被聚合平台信息。 如果瀑布流中的某则广告加载失败,平台响应会提供错误信息。您可以在高级设置:Waterfall Information API 中找到有关此方法的更多信息。
MAX 错误代码
代码 | MaxSdkBase.ErrorCode 常量 | 描述 | Load / Display |
---|---|---|---|
-1 | .Unspecified | 系统处于异常状态。该错误代码代表的错误无法归入其他已定义的错误类型。请查看错误对象中的消息字段,了解更多详情。 | L/D |
204 | .NoFill | 当前没有适合设备的广告 (未填充)。对于该应用/设备,MAX 未从任何被聚合平台返回符合条件的广告。 | L |
-5001 | .AdLoadFailed | 无平台可填充广告,因此加载失败。MAX 已返回来自被聚合平台的符合条件的广告,但所有广告均加载失败。请查看错误对象中的 adLoadFailureInfo 字段,了解更多详情。 | L |
-1000 | .NetworkError | 由于一般网络错误,广告请求失败。请查看错误对象中的消息字段,了解更多详情。 | L |
-1001 | .NetworkTimeout | 由于网速较慢,广告请求超时。 | L |
-1009 | .NoNetwork | 设备未连接至互联网,广告请求失败。 | L |
-23 | .FullscreenAdAlreadyShowing | 您试图展示一则全屏广告 (插屏广告或激励广告),但另一则全屏广告仍在展示中。 | D |
-24 | .FullscreenAdNotReady | 您试图在广告加载完成之前显示全屏广告。 | D |
-5601 | .NoActivity | SDK 无法加载广告,因为找不到最顶层的 Activity 。 | L |
-5602 | .DontKeepActivitiesEnabled | SDK 未能展示广告,因为用户启用了 “Don’t Keep Activities” 开发者设置 | D |
-5603 | .InvalidAdUnitID | 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)