دليل رموز الأخطاء الشائعة لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في AdMob

يمكن أن تكون رموز الأخطاء مفيدة جدًا عند تحديد المشاكل وحلّها في ما يتعلّق بطلبات الإعلانات الشاغرة.

ستتعرّف في هذه المقالة على معلومات عن:

• رموز أخطاء حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• خيارات استرداد رموز أخطاء حزمة تطوير البرامج (SDK)
• أنواع رموز الأخطاء الشائعة لحزمة تطوير البرامج (SDK)
• مراجع إضافية

رموز أخطاء حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"

تساعدك رموز أخطاء حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في فهم سبب تعذُّر تعبئة طلب إعلان. عندما تُرسِل حزمة تطوير البرامج (SDK) طلب إعلان إلى خوادم Google، يستجيب الخادم بإعلان أو بردّ "بدون تعبئة". في بعض الأحيان، سيتضمّن الردّ "بدون تعبئة" رسالة خطأ للإشارة إلى المشكلة.

في الحالات التي لا يتم فيها تقديم رمز خطأ، يمكنك الاطّلاع على مراجعنا لتحديد المشاكل وحلّها في ما يتعلّق بعدم عرض الإعلانات. يمكنك أيضًا تحديد المشاكل وحلّها باستخدام "أداة فحص الإعلانات".

خيارات استرداد رموز أخطاء حزمة تطوير البرامج (SDK)

بالنسبة إلى نظام التشغيل Android:

• استرداد أخطاء تحميل الإعلانات باستخدام دالة الاستدعاء المتعلّقة بتعذُّر تحميل الإعلانات
• إعداد ميزة تتبُّع الشبكة والبحث عن السجلات التي تحتوي على "Ads.*: Ad failed to load"

بالنسبة إلى نظام التشغيل iOS:

• استرداد أخطاء تحميل الإعلانات باستخدام دالة الاستدعاء المتعلّقة بتعذُّر تحميل الإعلانات
• عرض سجلات إعلاناتك من وحدة تصحيح Xcode

أنواع رموز الأخطاء الشائعة لحزمة تطوير البرامج (SDK)

ملاحظة: يُرجى الرجوع إلى مستندات المطوّرين (Android وiOS) للحصول على قائمة كاملة ووصف لرموز الأخطاء التي قد تظهر لك عند استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

يسرد هذا الجدول رموز الأخطاء الأكثر شيوعًا ومعنى كل رمز وخطوات حلّ هذه المشاكل.

رمز الخطأ ‏(Android)	رمز الخطأ ‏(iOS)	ما معنى ذلك؟	ما الذي يمكنك فعله؟
ERROR_CODE_ INTERNAL_ERROR	GADErrorServer Error	يظهر لك رمز الخطأ هذا عند حدوث خطأ في خادم الإعلانات، مثلاً تم تلقّي ردّ غير صالح من خادم الإعلانات.	تأكَّد من أنّ تطبيقك منشور وجاهز لتحقيق الربح منه. إذا كنت تختبر وحدات إعلانية جديدة، انتظِر ساعتَين تقريبًا لتصبح نشطة. تأكَّد من أنّ الوحدة الإعلانية التي يتم اختبارها مستهدَفة من خلال مجموعة توسّط أو حملة. يُرجى التواصل مع فريق الدعم إذا جرّبت كل الخطوات أعلاه.
ERROR_CODE_ INVALID_REQUEST	GADErrorInvalid Request	يظهر لك رمز الخطأ هذا عند تقديم طلب إعلان غير صالح، مثلاً عندما يكون رقم تعريف الوحدة الإعلانية غير صحيح. يشير رمز الخطأ هذا عادةً إلى أنّ تنفيذ طلب الإعلان لا يستوفي متطلّبات حزمة تطوير البرامج (SDK).	يمكنك الرجوع إلى الرمز النموذجي ونماذج التطبيقات المقدَّمة في مستندات المطوّرين لمساعدتك في تنفيذ الدوالّ بشكل صحيح. مستندات المطوّرين:  ‏Android أو iOS أو Unity أو Flutter نماذج التطبيقات: ‏Android أو iOS أو Unity أو Flutter
ERROR_CODE_ NETWORK_ERROR	GADErrorNetwork Error	يظهر لك هذا الخطأ عندما تتعذّر تعبئة طلب إعلان بسبب مشكلة في الاتصال بالشبكة. يمكن أن يرجع هذا أيضًا إلى تبديل الشبكات بواسطة هاتف أحد المستخدِمين أو اضطرابات الشبكة التي تشوّه الاتصال بين التطبيق وخادم الإعلانات.	تأكَّد من أنّ اتصالك بالإنترنت مستقر. ملاحظة: قد يحدّد بعض مقدّمي خدمات الاتصالات أيضًا عددًا معيّنًا من الزيارات بسبب السياسة، ما يمكن أن يؤدّي أيضًا إلى حدوث هذا الخطأ.
ERROR_CODE_ NO_FILL	GADErrorNoFill	إذا ظهر لك رمز الخطأ هذا، يعني ذلك أنّه تمّ إرسال طلب الإعلان بنجاح، ولكن لم يتم عرض أي إعلان بسبب عدم توفّر طلب. ما الذي يحدث؟ يمكن للمعلنين استهداف مناطق وأنظمة أساسية معينة وملفات شخصية لمستخدِمين معيّنين استنادًا إلى مدى صلة المؤسسة بموضوع البحث، ما يمكن أن يؤدّي في بعض الأحيان إلى تقليل مدى توفّر الإعلانات لمنطقة معيّنة أو ملف شخصي لمستخدِم معيّن. يشير رمز الخطأ هذا إلى أنّ عملية التنفيذ صحيحة، ولكنّه لم تتمّ تعبئة طلب الإعلان بسبب عدم توفّر إعلان مناسب في تلك اللحظة المحدّدة عندما تمّ إرسال طلب الإعلان من التطبيق.	استخدِم أداة حلّ مشاكل عدم ظهور الإعلانات واطّلِع على مراجع تحديد المشاكل وحلّها في ما يتعلّق بعدم ظهور الإعلانات لتحديد السبب الأساسي المحتمَل لهذه المشكلة. اختبِر تطبيقك باستخدام أداة فحص الإعلانات لتحليل طلب الإعلان ومصادر الإعلانات وإشارات الخصوصية وعروض الأسعار وغير ذلك. لاستخدام "أداة فحص الإعلانات"، عليك أولاً تسجيل جهاز اختباري. إذا كان يبدو أنّ عملية التنفيذ صحيحة بعد الاطّلاع على المراجع أعلاه، قد يكون عدم ظهور الإعلانات سلوكًا متوقّعًا لأنّه قد لا يكون هناك طلب إعلان متوفّر في وقت طلبك.

مراجع إضافية

• أداة حلّ المشاكل التي تتسبب بعدم عرض إعلانات AdMob
• منتدى AdMob
• كيفية استخدام "أداة فحص الإعلانات" في تطبيقك
• مراجع تحديد مشاكل عدم ظهور الإعلانات وحلّها
• حلّ المشاكل التي يتم رصدها باستخدام "أداة فحص الإعلانات"