광고 로드 오류
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
광고를 로드하지 못하면 LoadAdError 객체를 제공하는 실패 콜백이 호출됩니다.
다음 코드 스니펫은 보상형 광고 로드에 실패할 때 오류 정보를 검색합니다.
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;
}
이 정보를 토대로 광고 로드에 실패한 원인을 보다 정확하게 파악할 수
있습니다. 특히, iOS의 경우 com.google.admob 도메인, Android의 경우 com.google.android.gms.ads 도메인에서 오류가 발생하면 이 고객센터 도움말에서 GetMessage() 코드를 검색하여 자세한 설명 및 문제 해결을 위해 취할 수 있는 조치에 대해 알아볼 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[null,null,["최종 업데이트: 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."]]