错误处理
如果广告加载或展示失败,您的广告展示委托或回传接口会收到调用。 该调用带有一个错误代码。 本页介绍了这些错误代码。
错误对象
您在回传中收到的错误是一个实现 MAError
的一等 (first-class) 错误对象。
该对象具有以下 API:
code
- 错误代码,见下表。
message
- 描述该错误的可读信息。
mediatedNetworkErrorCode
- 被聚合平台针对该错误的错误码。 仅适用于广告展示失败回传中返回的错误。
mediatedNetworkErrorMessage
- 返回被聚合平台针对该错误的错误信息。 默认为空字符串。 仅适用于广告展示失败回传中返回的错误。
getWaterfall()
- 查看已加载或加载失败广告的当前瀑布流信息。 平台响应会提供瀑布流中每则广告的广告加载状态、延迟、凭证和被聚合平台信息。 如果瀑布流中的某则广告加载失败,平台响应会提供错误信息。您可以在高级设置: Waterfall Information API 中找到有关此方法的更多信息。
MAX 错误代码
代码 | 常量 | 描述 | Load / Display |
---|---|---|---|
-1 | MAErrorCodeUnspecified | 系统处于异常状态。该错误代码代表的错误无法归入其他已定义的错误类型。请查看错误对象中的消息字段,了解更多详情。 | L/D |
204 | MAErrorCodeNoFill | 当前没有适合设备的广告 (未填充)。对于该应用/设备,MAX 未从任何被聚合平台返回符合条件的广告。 | L |
-5001 | MAErrorCodeAdLoadFailed | 无平台可填充广告,因此加载失败。MAX 已返回来自被聚合平台的符合条件的广告,但所有广告均加载失败。请查看错误对象中的 adLoadFailureInfo 字段,了解更多详情。 | L |
-1000 | MAErrorCodeNetworkError | 由于一般网络错误,广告请求失败。请查看错误对象中的消息字段,了解更多详情。 | L |
-1001 | MAErrorCodeNetworkTimeout | 由于网速较慢,广告请求超时。 | L |
-1009 | MAErrorCodeNoNetwork | 设备未连接至互联网,广告请求失败。 | L |
-23 | MAErrorCodeFullscreenAdAlreadyShowing | 您试图展示一则全屏广告 (插屏广告或激励广告),但另一则全屏广告仍在展示中。 | D |
-24 | MAAdapterError.adNotReady | 您试图在广告加载完成之前显示全屏广告。 | D |
-5205 | MAAdapterError.adNotReady | 适配器在尝试展示时没有已准备好的广告。 | L |
-5209 | MAAdapterError.internalError | 未指明的内部错误。 | L |
-5603 | MAErrorCodeInvalidAdUnitIdentifier | SDK 无法加载广告,因为开发者提供了无效的广告单元标识符。广告单元标识符无效的可能原因有:
| L |
不同平台的错误代码
要进一步了解不同广告平台返回的错误代码,请查看这些平台发布的错误相关文档: