To discuss and provide feedback on our products, join the official AdMob Discord channel in the Google Advertising and Measurement Community server.

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:

publicvoidOnAdFailedToLoad(LoadAdErrorerror)
{
// Gets the domain from which the error came.
stringdomain=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.
intcode=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.
stringmessage=error.GetMessage();
// Gets the cause of the error, if available.
AdErrorunderlyingError=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.
ResponseInforesponseInfo=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.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月15日 UTC.