Erros de carregamento de anúncios
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Selecione a plataforma:
Android
iOS
Unity
Flutter
Quando um anúncio não é carregado, um callback de falha é chamado e fornece um
objeto LoadAdError
.
Para qualquer formato de anúncio, se o anúncio não for carregado, o seguinte callback será chamado:
public void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
O snippet de código a seguir recupera informações de erro quando um anúncio não é carregado:
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());
}
Essas informações podem ser usadas para determinar com mais precisão o que causou a falha
no carregamento do anúncio. Em especial, no caso de erros no domínio com.google.admob
no
iOS e em com.google.android.gms.ads
no Android, procure o GetMessage()
neste artigo da
Central de Ajuda se quiser uma explicação mais
detalhada e possíveis soluções para o problema.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 2025-08-27 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,["# Ad load errors\n\nSelect 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."]]