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