في الحالات التي يتعذّر فيها تحميل إعلان، يتم استدعاء دالة رد اتصال توفّر عنصر LoadAdError.
بالنسبة إلى AdManagerAdView، يتم استدعاء ما يلي:
Kotlin
fun onAdFailedToLoad(error: LoadAdError)
جافا
public void onAdFailedToLoad(LoadAdError adError);
يوضّح المثال التالي المعلومات المتاحة عند تعذُّر تحميل إعلان:
Kotlin
override fun onAdFailedToLoad(error: LoadAdError) {
// Gets the domain from which the error came.
val errorDomain = error.domain
// Gets the error code. See
// https://developers.google.com/admob/android/reference/com/google/android/gms/ads/AdRequest#constant-summary
// for a list of possible codes.
val 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.
val errorMessage = error.message
// Gets additional response information about the request. See
// https://developers.google.com/admob/android/response-info
// information.
val responseInfo = error.responseInfo
// Gets the cause of the error, if available.
val cause = error.cause
// All of this information is available using the error's toString() method.
Log.d("Ads", error.toString())
}جافا
@Override
public void onAdFailedToLoad(@NonNull LoadAdError adError) {
// Gets the domain from which the error came.
String errorDomain = adError.getDomain();
// Gets the error code. See
// https://developers.google.com/admob/android/reference/com/google/android/gms/ads/AdRequest#constant-summary
// for a list of possible codes.
int errorCode = adError.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 errorMessage = adError.getMessage();
// Gets additional response information about the request. See
// https://developers.google.com/admob/android/response-info
// information.
ResponseInfo responseInfo = adError.getResponseInfo();
// Gets the cause of the error, if available.
AdError cause = adError.getCause();
// All of this information is available using the error's toString() method.
Log.d("Ads", adError.toString());
}تصحيح أخطاء رسائل تسجيل الأخطاء الشائعة
في الإصدار 23.5.0 من "Google Mobile Ads SDK (Legacy)"، تم تحسين التسجيل المطوّل ليتضمّن تتبع تسلسل استدعاء الدوال البرمجية في حال تعذّر تحميل الإعلان. لا تشير هذه الرسائل إلى حدوث عطل، بل تحدّد المصدر الفريد للخطأ. يعرض الجدول التالي سجلات الأخطاء الشائعة والأوصاف والإجراءات المقترَحة لحلّها:
| سجلّ الأخطاء | الوصف | الإجراءات المقترَحة |
|---|---|---|
com.google.android.gms.ads.nonagon.render.cp: * |
لم يعرض خادم الإعلانات أي إعلان أو أي مصادر إعلانات مستندة إلى التوسّط لطلب الإعلان. | لمعرفة تفاصيل حول تحديد مشاكل عدم التعبئة وحلّها، يُرجى الاطّلاع على مقالة تحديد مشاكل مرّات الظهور الشاغرة وحلّها. |
com.google.android.gms.ads.nonagon.render.e: * |
تعذّر تحميل جميع مصادر الإعلانات في تدفق التوسّط. ويمثّل الخطأ المحدّد آخر مصدر إعلان تعذّر تحميله. | لمعرفة تفاصيل حول تسجيل سبب تعذُّر عرض الإعلانات من كل مصدر إعلانات مستند إلى التوسّط، يُرجى الاطّلاع على معلومات الاستجابة. |
com.google.android.gms.ads.internal.util.*: Unable to obtain a JavascriptEngine. |
لم ينجح طلب عرض الإعلان لأنّ WebView غير مسموح به في العمليات المميّزة. |
|
| لم ينجح طلب عرض الإعلان بسبب بطء الاتصال بالشبكة. | يُرجى محاولة تحسين اتصالك بالإنترنت ثم إعادة المحاولة. | |
com.google.android.gms.ads.nonagon.load.a |
انتهت مهلة طلب عرض الإعلان. | |
com.google.android.gms.ads.internal.util.*: Error while
connecting to ad server: Unable to resolve host "pubads.g.doubleclick.net":
No address associated with hostname |
لم ينجح طلب عرض الإعلان بسبب الاتصال بالشبكة. | |
com.google.android.gms.ads.internal.util.*: Error building
request URL: Cannot determine request type. Is your ad unit id correct? |
لم يتطابق معرّف الوحدة الإعلانية مع تعبير عادي متوقّع. | تحقَّق من صحة معرّف الوحدة الإعلانية. |
com.google.android.gms.ads.internal.render.bt: Unable to
instantiate mediation adapter class. |
يتعذّر على "Google Mobile Ads SDK (Legacy)" العثور على محوّل التوسّط. |
|
com.google.android.gms.internal.ads.*: Received error HTTP response code: 403 |
رفضت خوادم "مدير إعلانات Google" الطلب. | يُرجى إعادة المحاولة لاحقًا. إذا كان من الممكن إعادة إنتاج الخطأ باستمرار، يمكنك تسجيل عنوان URL للطلب باستخدام أداة فحص الإعلانات والتواصل مع فريق الدعم. |