Ad load errors

  • When an ad fails to load, a LoadAdError object provides detailed information about the failure through its properties.

  • Developers can access error domain, code, message, and response info from the LoadAdError object to understand the reason for ad load failure.

  • For errors originating from Google AdMob (specific domains on iOS and Android), the error message can be cross-referenced with a help center article for troubleshooting and resolution guidance.
Select platform: Android iOS Unity Flutter

When an ad fails to load, a failure callback is called which provides a LoadAdError object.

The following code snippet retrieves error information when a rewarded ad fails to load:

onAdFailedToLoad: (ad, loadAdError) {
  // Gets the domain from which the error came.
  String domain = loadAdError.domain;

  // Gets the error code. See
  // https://developers.google.com/admob/android/reference/com/google/android/gms/ads/AdRequest
  // and https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode
  // for a list of possible codes.
  int code = loadAdError.code;

  // A log friendly string summarizing the error.
  String message = loadAdError.message;

  // Get response information, which may include results of mediation requests.
  ResponseInfo? responseInfo = loadAdError.responseInfo;
}

This information can be used to more accurately determine what caused the ad load to fail. In particular, for errors under the domain com.google.admob on iOS and com.google.android.gms.ads on Android, the GetMessage() can be looked up in this help center article for a more detailed explanation and possible actions that can be taken to resolve the issue.