Ad load errors

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

  • The LoadAdError object provides access to the error domain, code, message, underlying cause, and response information.

  • Developers can use the error code and message, especially for errors from com.google.admob or com.google.android.gms.ads, to diagnose and resolve ad loading issues with help from the provided resources.

  • The LoadAdError object's ToString() method and GetResponseInfo().ToString() method offer comprehensive overviews of the error and response details for debugging.
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 an ad fails to load:

public void OnAdFailedToLoad(LoadAdError error)
{
    // Gets the domain from which the error came.
    string domain = error.GetDomain();

    // 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 = 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 message = error.GetMessage();

   // Gets the cause of the error, if available.
   AdError underlyingError = error.GetCause();

   // All of this information is available via the error's toString() method.
   Debug.Log("Load error string: " + error.ToString());

   // Get response information, which may include results of mediation requests.
   ResponseInfo responseInfo = error.GetResponseInfo();
   Debug.Log("Response info: " + responseInfo.ToString());
}

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.