跳转到内容

错误处理

如果广告加载或展示失败,您的广告展示委托或回传接口会收到调用。 该调用带有一个错误代码。 本页介绍了这些错误代码。

错误对象

您在回传中收到的错误是一个实现 MAError 的一等 (first-class) 错误对象。 该对象具有以下 API:

code
错误代码,见下表。
message
描述该错误的可读信息。
mediatedNetworkErrorCode
被聚合平台针对该错误的错误码。 仅适用于广告展示失败回传中返回的错误。
mediatedNetworkErrorMessage
返回被聚合平台针对该错误的错误信息。 默认为空字符串。 仅适用于广告展示失败回传中返回的错误。
getWaterfall()
查看已加载或加载失败广告的当前瀑布流信息。 平台响应会提供瀑布流中每则广告的广告加载状态、延迟、凭证和被聚合平台信息。 如果瀑布流中的某则广告加载失败,平台响应会提供错误信息。您可以在高级设置: Waterfall Information API 中找到有关此方法的更多信息。

MAX 错误代码

代码常量描述Load / Display
-1MAErrorCodeUnspecified系统处于异常状态。该错误代码代表的错误无法归入其他已定义的错误类型。请查看错误对象中的消息字段,了解更多详情。L/D
204MAErrorCodeNoFill当前没有适合设备的广告 (未填充)。对于该应用/设备,MAX 未从任何被聚合平台返回符合条件的广告。L
-5001MAErrorCodeAdLoadFailed无平台可填充广告,因此加载失败。MAX 已返回来自被聚合平台的符合条件的广告,但所有广告均加载失败。请查看错误对象中的 adLoadFailureInfo 字段,了解更多详情。L
-1000MAErrorCodeNetworkError由于一般网络错误,广告请求失败。请查看错误对象中的消息字段,了解更多详情。L
-1001MAErrorCodeNetworkTimeout由于网速较慢,广告请求超时。L
-1009MAErrorCodeNoNetwork设备未连接至互联网,广告请求失败。L
-23MAErrorCodeFullscreenAdAlreadyShowing您试图展示一则全屏广告 (插屏广告或激励广告),但另一则全屏广告仍在展示中。D
-24MAAdapterError.adNotReady您试图在广告加载完成之前显示全屏广告。D
-5205MAAdapterError.adNotReady适配器在尝试展示时没有已准备好的广告。L
-5209MAAdapterError.internalError未指明的内部错误。L
-5603MAErrorCodeInvalidAdUnitIdentifierSDK 无法加载广告,因为开发者提供了无效的广告单元标识符。广告单元标识符无效的可能原因有:
  • 广告单元标识符格式错误或不存在
  • 广告单元已禁用
  • 广告单元未与当前应用的包名相关联
  • 广告单元是在最近 30 - 60 分钟内创建的
L

不同平台的错误代码

要进一步了解不同广告平台返回的错误代码,请查看这些平台发布的错误相关文档: