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 a rewarded ad fails
to load:
onAdFailedToLoad: (ad, loadAdError) {
// Gets the domain from which the error came.
String domain = loadAdError.domain;
// 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 = loadAdError.code;
// A log friendly string summarizing the error.
String message = loadAdError.message;
// Get response information, which may include results of mediation requests.
ResponseInfo? responseInfo = loadAdError.responseInfo;
}
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 provides detailed information about the failure through its properties.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access error domain, code, message, and response info from the \u003ccode\u003eLoadAdError\u003c/code\u003e object to understand the reason for ad load failure.\u003c/p\u003e\n"],["\u003cp\u003eFor errors originating from Google AdMob (specific domains on iOS and Android), the error message can be cross-referenced with a help center article for troubleshooting and resolution guidance.\u003c/p\u003e\n"]]],["When an ad fails to load, a `LoadAdError` object is provided via a callback. This object contains error details, including the error's domain, a specific error code, a summarized message, and response information that could be related to mediation. For errors originating from `com.google.admob` (iOS) or `com.google.android.gms.ads` (Android), the message can be checked in a help center article for in-depth information and potential solutions. This information helps to pinpoint the cause of 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 a rewarded ad fails\nto load: \n\n onAdFailedToLoad: (ad, loadAdError) {\n // Gets the domain from which the error came.\n String domain = loadAdError.domain;\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 = loadAdError.code;\n\n // A log friendly string summarizing the error.\n String message = loadAdError.message;\n\n // Get response information, which may include results of mediation requests.\n ResponseInfo? responseInfo = loadAdError.responseInfo;\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."]]