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.
For any ad format, if the ad fails to load, the following callback is called:
public
void
OnAdFailedToLoad
(
object
sender
,
AdFailedToLoadEventArgs
args
)
The following code snippet retrieves error information when an ad fails to load:
public
void
OnAdFailedToLoad
(
object
sender
,
AdFailedToLoadEventArgs
args
)
{
LoadAdError
loadAdError
=
args
.
LoadAdError
;
// Gets the domain from which the error came.
string
domain
=
loadAdError
.
GetDomain
();
// 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
.
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
=
loadAdError
.
GetMessage
();
// Gets the cause of the error, if available.
AdError
underlyingError
=
loadAdError
.
GetCause
();
// All of this information is available via the error's toString() method.
Debug
.
Log
(
"Load error string: "
+
loadAdError
.
ToString
());
// Get response information, which may include results of mediation requests.
ResponseInfo
responseInfo
=
loadAdError
.
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-09-04 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-09-04 UTC."],[[["\u003cp\u003eWhen an ad fails to load, a \u003ccode\u003eLoadAdError\u003c/code\u003e object is provided in the failure callback, \u003ccode\u003eOnAdFailedToLoad\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLoadAdError\u003c/code\u003e object contains detailed information about the failure, including domain, error code, message, and underlying cause.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use the error code and message to identify the reason for ad load failure and potentially resolve the issue.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGetMessage()\u003c/code\u003e method provides a human-readable error message, while the error code can be cross-referenced with platform documentation.\u003c/p\u003e\n"],["\u003cp\u003eYou can find further explanation of error messages in the Google AdMob help center.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/ad-load-errors \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/ad-load-errors \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/ad-load-errors \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/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\nFor any ad format, if the ad fails to load, the following callback is called: \n\n public void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)\n\nThe following code snippet retrieves error information when an ad fails to load: \n\n public void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)\n {\n LoadAdError loadAdError = args.LoadAdError;\n\n // Gets the domain from which the error came.\n string domain = loadAdError.GetDomain();\n\n // Gets the error code. See\n // https://developers.google.com/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/AdRequest\n // and https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Enums/GADErrorCode\n // for a list of possible codes.\n int code = loadAdError.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 = loadAdError.GetMessage();\n\n // Gets the cause of the error, if available.\n AdError underlyingError = loadAdError.GetCause();\n\n // All of this information is available via the error's toString() method.\n Debug.Log(\"Load error string: \" + loadAdError.ToString());\n\n // Get response information, which may include results of mediation requests.\n ResponseInfo responseInfo = loadAdError.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."]]
