أخطاء في تحميل الإعلانات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
Unity
Flutter
عندما يتعذّر تحميل إعلان، يتم استدعاء دالّة ردّ الاتصال الخاصة بالخطأ التي توفّر كائن 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());
}
يمكن استخدام هذه المعلومات لتحديد سبب تعذُّر تحميل الإعلان بشكل أكثر دقة. على وجه الخصوص، بالنسبة إلى الأخطاء التي تندرج ضمن النطاق com.google.admob
على أجهزة iOS وcom.google.android.gms.ads
على أجهزة Android، يمكن البحث عن GetMessage()
في مقالة مركز المساعدة هذه للحصول على شرح أكثر تفصيلاً والإجراءات المحتملة التي يمكن اتّخاذها لحلّ المشكلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]