Ad Load Errors

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

For an AdView, the following is called:

Java

public void onAdFailedToLoad(LoadAdError adError);

Kotlin

fun onAdFailedToLoad(error: LoadAdError)

Here is a code snippet that illustrates the information available when an ad fails to load:

Java

@Override
public void onAdFailedToLoad(LoadAdError error) {
  // Gets the domain from which the error came.
  String errorDomain = error.getDomain();
  // Gets the error code. See
  // https://developers.google.com/android/reference/com/google/android/gms/ads/AdRequest#constant-summary
  // for a list of possible codes.
  int errorCode = error.getCode();
  // Gets an error message.

  // For example "Account not approved yet". See
  // https://support.google.com/admob/answer/9905175 for explanations of
  // common errors.

  String errorMessage = error.getMessage();
  // Gets the cause of the error, if available.
  AdError cause = error.getCause();
  // All of this information is available via the error's toString() method.
  Log.d("Ads", error.toString());
}

Kotlin

override fun onAdFailedToLoad(error: LoadAdError) {
    // Gets the domain from which the error came.
    val errorDomain = error.domain
    // Gets the error code. See
    // https://developers.google.com/android/reference/com/google/android/gms/ads/AdRequest#constant-summary
    // for a list of possible codes.
    val errorCode = error.code
    // Gets an error message.

    // For example "Account not approved yet". See
    // https://support.google.com/admob/answer/9905175 for explanations of
    // common errors.

    val errorMessage = error.message
    // Gets the cause of the error, if available.
    val cause = error.cause
    // All of this information is available via the error's toString() method.
    Log.d("Ads", error.toString())
}

This information can be used to more accurately determine what caused the ad load to fail. In particular, for errors under the domain MobileAds.ERROR_DOMAIN, the message 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.