Ad load errors
Stay organized with collections
Save and categorize content based on your preferences.
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.
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-08-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eWhen an ad fails to load, a \u003ccode\u003eLoadAdError\u003c/code\u003e object is provided in a failure callback, containing information about the error.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLoadAdError\u003c/code\u003e object provides access to the error domain, code, message, underlying cause, and response information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the error code and message, especially for errors from \u003ccode\u003ecom.google.admob\u003c/code\u003e or \u003ccode\u003ecom.google.android.gms.ads\u003c/code\u003e, to diagnose and resolve ad loading issues with help from the provided resources.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLoadAdError\u003c/code\u003e object's \u003ccode\u003eToString()\u003c/code\u003e method and \u003ccode\u003eGetResponseInfo().ToString()\u003c/code\u003e method offer comprehensive overviews of the error and response details for debugging.\u003c/p\u003e\n"]]],["When an ad fails to load, the `LoadAdError` object provides details via a callback. Key actions include retrieving the error's domain using `GetDomain()`, the error code with `GetCode()`, and a descriptive message via `GetMessage()`. The underlying cause is accessible with `GetCause()`. All data is also in the `ToString()` method. `GetResponseInfo()` offers insights, possibly regarding mediation. `GetMessage()` can be researched in a specific article to resolve the cause of the ad loading failure.\n"],null,["# Ad load errors\n\nSelect platform: [Android](/admob/android/ad-load-errors \"View this page for the Android platform docs.\") [iOS](/admob/ios/ad-load-errors \"View this page for the iOS platform docs.\") [Unity](/admob/unity/ad-load-errors \"View this page for the Unity platform docs.\") [Flutter](/admob/flutter/ad-load-errors \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nWhen an ad fails to load, a failure callback is called which provides a\n`LoadAdError` object.\n\nThe following code snippet retrieves error information when an ad fails to load: \n\n public void OnAdFailedToLoad(LoadAdError error)\n {\n // Gets the domain from which the error came.\n string domain = error.GetDomain();\n\n // Gets the error code. See\n // https://developers.google.com/admob/android/reference/com/google/android/gms/ads/AdRequest\n // and https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode\n // for a list of possible codes.\n int code = error.GetCode();\n\n // Gets an error message.\n // For example \"Account not approved yet\". See\n // https://support.google.com/admob/answer/9905175 for explanations of\n // common errors.\n string message = error.GetMessage();\n\n // Gets the cause of the error, if available.\n AdError underlyingError = error.GetCause();\n\n // All of this information is available via the error's toString() method.\n Debug.Log(\"Load error string: \" + error.ToString());\n\n // Get response information, which may include results of mediation requests.\n ResponseInfo responseInfo = error.GetResponseInfo();\n Debug.Log(\"Response info: \" + responseInfo.ToString());\n }\n\nThis information can be used to more accurately determine what caused the ad\nload to fail. In particular, for errors under the domain `com.google.admob` on\niOS and `com.google.android.gms.ads` on Android, the `GetMessage()` can be\nlooked up in [this help center\narticle](//support.google.com/admob/answer/9905175) for a more detailed\nexplanation and possible actions that can be taken to resolve the issue."]]