跳转到内容

错误处理

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

错误对象

您在回传中收到的错误是一个实现 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.NoActivitySDK 无法加载广告,因为找不到最顶层的 ActivityL
-5602.DontKeepActivitiesEnabledSDK 未能展示广告,因为用户启用了 “Don’t Keep Activities” 开发者设置D
-5603.InvalidAdUnitIDSDK 无法加载广告,因为开发者提供了无效的广告单元标识符。广告单元标识符无效的可能原因有:
  • 广告单元标识符格式错误或不存在
  • 广告单元已禁用
  • 广告单元未与当前应用的包名相关联
  • 广告单元是在最近 30 - 60 分钟内创建的
L

不同平台的错误代码

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