Ad load errors

  • When an ad fails to load, a failure callback is called which provides a LoadAdError object containing information about the error.

  • The LoadAdError object provides details such as the error domain, error code, and a log-friendly message.

  • This error information can be used to determine the cause of the ad load failure.

  • For specific errors on iOS and Android within the com.google.admob or com.google.android.gms.ads domains, the error message can be looked up in a help center article for further explanation and resolution steps.

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/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/AdRequest
  // and https://developers.google.com/ad-manager/mobile-ads-sdk/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.