أخطاء في تحميل الإعلانات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
Unity
Flutter
في الحالات التي يتعذّر فيها تحميل الإعلان، يتم استدعاء طريقة تفويض أو معالج إكمال يوفّر كائن NSError
.
بالنسبة إلى GADBannerView
، يتم استدعاء ما يلي:
يعرض المثال التالي المعلومات المتاحة عند تعذُّر تحميل إعلان:
Swift
func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
// Gets the domain from which the error came.
let errorDomain = error.domain
// Gets the error code. See
// https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode
// for a list of possible codes.
let errorCode = error.code
// Gets an error message.
// For example "Account not approved yet". See
// https://support.google.com/admob/answer/9905175 for explanations of
// common errors.
let errorMessage = error.localizedDescription
// Gets additional response information about the request. See
// https://developers.google.com/admob/ios/response-info for more information.
let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? ResponseInfo
// Gets the underlyingError, if available.
let underlyingError = (error as NSError).userInfo[NSUnderlyingErrorKey] as? Error
if let responseInfo = responseInfo {
print("Received error with domain: \(errorDomain), code: \(errorCode),"
+ "message: \(errorMessage), responseInfo: \(responseInfo),"
+ "underlyingError: \(underlyingError?.localizedDescription ?? "nil")")
}
}
Objective-C
- (void)bannerView:(GADBannerView *)bannerView
didFailToReceiveAdWithError:(NSError *)error {
// Gets the domain from which the error came.
NSString *errorDomain = error.domain;
// Gets the error code. See
// https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode
// for a list of possible codes.
int errorCode = error.code;
// Gets an error message.
// For example "Account not approved yet". See
// https://support.google.com/admob/answer/9905175 for explanations of
// common errors.
NSString *errorMessage = error.localizedDescription;
// Gets additional response information about the request. See
// https://developers.google.com/admob/ios/response-info for more
// information.
GADResponseInfo *responseInfo = error.userInfo[GADErrorUserInfoKeyResponseInfo];
// Gets the underlyingError, if available.
NSError *underlyingError = error.userInfo[NSUnderlyingErrorKey];
NSLog(@"Received error with domain: %@, code: %ld, message: %@, "
@"responseInfo: %@, underlyingError: %@",
errorDomain, errorCode, errorMessage, responseInfo,
underlyingError.localizedDescription);
}
بالنسبة إلى الأخطاء ضمن النطاق
GADErrorDomain
، يمكن البحث عن
localizedDescription
في
مقالة حلّ المشاكل الشائعة في ما يتعلّق بالخطوات الإرشادية للحصول على شرح أكثر تفصيلاً والإجراءات المحتملة التي يمكن اتّخاذها لحلّ المشكلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eWhen an ad fails to load, a delegate method or completion handler is called, providing an \u003ccode\u003eNSError\u003c/code\u003e object with details about the failure.\u003c/p\u003e\n"],["\u003cp\u003eFor \u003ccode\u003eGADBannerView\u003c/code\u003e, the \u003ccode\u003ebannerView(_:didFailToReceiveAdWithError:)\u003c/code\u003e method is called when an ad fails to load.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eNSError\u003c/code\u003e object contains information like error domain, code, message, response info, and underlying error, which can be used for debugging.\u003c/p\u003e\n"],["\u003cp\u003eFor errors in the \u003ccode\u003eGADErrorDomain\u003c/code\u003e, the \u003ccode\u003elocalizedDescription\u003c/code\u003e can be cross-referenced with the AdMob help center article (linked in the content) for troubleshooting.\u003c/p\u003e\n"]]],["When an ad fails to load, a delegate method or completion handler provides an `NSError` object. This object reveals the error's domain, code, and a descriptive message. It also includes optional response information and an underlying error. The `GADBannerView`'s `bannerView:didFailToReceiveAdWithError:` method is triggered upon failure. Developers can access and log details from the error object to understand and potentially resolve the ad loading issue, consulting additional resources for further information on error codes.\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\nIn cases where an ad fails to load, a\ndelegate method or completion handler\nis called which provides a `NSError` object.\n\nFor `GADBannerView`, the following is called: \n\n### Swift\n\n func bannerView(_ bannerView: BannerView, /admob/ios/api/reference/Protocols/GADBannerViewDelegate#-adview:didfailtoreceiveadwitherror: error: Error)\n\n### Objective-C\n\n - (void)bannerView:(nonnull GADBannerView *)bannerView\n /admob/ios/api/reference/Protocols/GADBannerViewDelegate#-adview:didfailtoreceiveadwitherror:error;\n\nThe following example shows the information available when an ad fails to load: \n\n### Swift\n\n func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {\n // Gets the domain from which the error came.\n let errorDomain = error.domain\n // Gets the error code. See\n // https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode\n // for a list of possible codes.\n let errorCode = error.code\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 let errorMessage = error.localizedDescription\n // Gets additional response information about the request. See\n // https://developers.google.com/admob/ios/response-info for more information.\n let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? ResponseInfo\n // Gets the underlyingError, if available.\n let underlyingError = (error as NSError).userInfo[NSUnderlyingErrorKey] as? Error\n if let responseInfo = responseInfo {\n print(\"Received error with domain: \\(errorDomain), code: \\(errorCode),\"\n + \"message: \\(errorMessage), responseInfo: \\(responseInfo),\"\n + \"underlyingError: \\(underlyingError?.localizedDescription ?? \"nil\")\")\n }\n }\n\n### Objective-C\n\n - (void)bannerView:(GADBannerView *)bannerView\n didFailToReceiveAdWithError:(NSError *)error {\n // Gets the domain from which the error came.\n NSString *errorDomain = error.domain;\n // Gets the error code. See\n // https://developers.google.com/admob/ios/api/reference/Enums/GADErrorCode\n // for a list of possible codes.\n int errorCode = error.code;\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 NSString *errorMessage = error.localizedDescription;\n // Gets additional response information about the request. See\n // https://developers.google.com/admob/ios/response-info for more\n // information.\n GADResponseInfo *responseInfo = error.userInfo[GADErrorUserInfoKeyResponseInfo];\n // Gets the underlyingError, if available.\n NSError *underlyingError = error.userInfo[NSUnderlyingErrorKey];\n NSLog(@\"Received error with domain: %@, code: %ld, message: %@, \"\n @\"responseInfo: %@, underlyingError: %@\",\n errorDomain, errorCode, errorMessage, responseInfo,\n underlyingError.localizedDescription);\n }\n\nFor errors under the domain `GADErrorDomain`, the `localizedDescription` can be looked up in the [Resolve common onboarding issues article](//support.google.com/admob/answer/9905175) for a more detailed explanation and possible actions that can be taken to resolve the issue."]]