حلّ المشاكل التي يتم رصدها باستخدام "أداة فحص الإعلانات"

تساعدك "أداة فحص الإعلانات" في تحديد المشاكل المتعلّقة بتطبيقك. وبعد تحديد المشكلة، يمكنك الاستفادة من المعلومات الواردة في هذه المقالة لمعرفة كيفية حلّها.

نستعرض في هذه المقالة ما يلي:

• مشاكل محوّل حزمة تطوير البرامج (SDK)
• مشاكل مصادر الإعلانات المستندة إلى عروض الأسعار
• مشاكل الخصوصية

فهم مشاكل محوِّلات حزمة تطوير البرامج (SDK)

قد تحدث مشكلتان عند التحقُّق من محوّل حزمة تطوير البرامج لمصدر الإعلان التابع لجهة خارجية. راجِع ما يلي للتعرّف على المشكلة والإجراءات التي يمكنك اتّخاذها لحلّها.

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

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

التعرّف على مشاكل مصادر الإعلانات المستندة إلى عروض الأسعار

للاطّلاع على تفاصيل عروض الأسعار في "أداة فحص الإعلانات"، يجب استخدام أحد الإصدارَين التاليَين:

• أجهزة Android:‏ 20.2.0‫+
• أجهزة iOS:‏ ‪8.5.0+

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

مشكلة	معناها	الإجراءات التي يمكنك اتّخاذها
عدم العثور على إشارة حزمة تطوير البرامج (SDK)	قد تحتاج بعض مصادر الإعلانات إلى تثبيت وضبط حزمة تطوير برامج ومحوِّل بشكلٍ صحيح حتّى تتمكّن من استخدام عروض الأسعار.	تأكَّد من استيفاء متطلّبات حزمة تطوير البرامج بشكلٍ صحيح في Android وiOS.
عدم تقديم موافقة المستخدِم	قد لا يكون مصدر الإعلان مؤهَّلاً لطلب عرض السعر إذا لم يقدِّم المستخدِم الموافقة اللازمة. وقد يكون هذا سلوكًا متوقعًا.	يمكنك الاطّلاع على مزيد من المعلومات عن تنفيذ أدوات طلب الموافقة، مثل "اللائحة العامّة لحماية البيانات"، وذلك في سياسات AdMob وقيوده.
عدم عرض أيّ إعلان	ربّما تكون مصادر الإعلانات قد قرّرت عدم تقديم عرض سعر لطلب الإعلان أو قد لا تكون مؤهّلة لتقديم عروض أسعار له. هناك عدّة أسباب محتملة لهذه المشكلة. وإليك بعض الأمثلة: لا يجوز أن يقدِّم مصدر الإعلان عروض أسعار إلّا في ظلّ ظروف محدّدة، مثل مناطق جغرافية معيّنة. لا يجوز أن يحتوي مصدر الإعلان على إعلان لطلب عرض السعر. حدث خطأ غير متوقّع في النظام أو انتهت المهلة المخصّصة لمصدر الإعلان.	ارجع إلى مصدر إعلانك للحصول على مزيد من التفاصيل. إذا لم يكن مصدر عروض أسعارك التابع لجهة خارجية يقدِّم عروض الأسعار، قد تكون هناك مشكلة في الإشارة التي يجمعها. يمكنك نسخ البيانات التي يُنشئها المشتري ومشاركتها مع مصدر عروض أسعارك.

الاطّلاع على مشاكل مَعلمات عروض الأسعار التابعة لجهة خارجية لكل طلب إعلان

عند استخدام مراجعة تفاصيل مَعلمة عروض الأسعار التابعة لجهة خارجية، قد تواجه أحد الأخطاء التالية. استخدِم الجدول التالي لمعرفة ما تعنيه الأخطاء والخطوات التالية التي يُنصح بتنفيذها.

رسالة الخطأ	معناها	الإجراءات التي يمكنك اتّخاذها
NO_ERROR	ما مِن خطأ.	لا يلزم اتّخاذ أي إجراء.
ADAPTER_CREATION_FAILURE	لم يتمّ العثور على محوِّل حزمة تطوير البرامج التابع لجهة خارجية أو لم يتمّ إعداده.	تأكّد من استيراد المحوِّل وحزمة تطوير البرامج التابعة لجهة خارجية بشكلٍ صحيح لنظام التشغيل Android وiOS.
SIGNAL_COLLECTION_FAILURE	حدث خطأ في محوِّل حزمة تطوير البرامج (SDK) التابع لجهة خارجية أثناء جمع الإشارات. يمكن أن يعني هذا الخطأ أنّه لم يتمّ العثور على إشارة حزمة تطوير البرامج أو انتهت مهلتها.	راجِع وصف الخطأ المقدَّم في "أداة فحص الإعلانات" للحصول على مساعدة في تحديد سبب المشكلة. تأكَّد من صحّة ربط الوحدات الإعلانية في حسابك. تأكّد من نجاح إعداد حزمة تطوير البرامج لمصدر الإعلان التابع لجهة خارجية. إذا لم ينجح ذلك، ارجع إلى مستندات مصدر إعلانك التابع لجهة خارجية.
SIGNAL_COLLECTION_TIMEOUT	انتهت مهلة جمع الإشارات لمحوِّل حزمة تطوير البرامج (SDK) التابع لجهة خارجية.	تأكّد من نجاح إعداد حزمة تطوير البرامج لمصدر الإعلان التابع لجهة خارجية. إذا لم ينجح ذلك، ارجع إلى مستندات مصدر إعلانك التابع لجهة خارجية.
UNKNOWN_ERROR	يشير هذا إلى حدوث خطأ غير متوقّع.	تعني الأخطاء غير المعروفة أنّه لا يمكننا تحديد السبب الدقيق. في ما يلي بعض المشاكل الشائعة التي يمكنك التحقُّق منها: تأكّد من نجاح إعداد حزمة تطوير البرامج لمصدر الإعلان التابع لجهة خارجية. تأكَّد من صحّة ربط الوحدات الإعلانية في حسابك. إذا لم ينجح ذلك، ارجع إلى مستندات مصدر إعلانك التابع لجهة خارجية.
ADAPTER_PROTOCOL_ CONFORMANCE_FAILURE	يعني ذلك أنّ محوِّل حزمة تطوير البرامج التابع لجهة خارجية غير متوافق أو أنّ هناك مشكلة في إعدادات المحوِّل.	تأكّد من استيراد المحوِّل وحزمة تطوير البرامج التابعة لجهة خارجية بشكلٍ صحيح لنظام التشغيل iOS. يظهر هذا الخطأ في نظام التشغيل iOS فقط.

ألا ترى مصدر إعلانك مُدرجًا في مَعلمات عروض الأسعار التابعة لجهة خارجية؟ قد يعني ذلك أنّ مصدر إعلاناتك لم يتمّ إعداده بشكلٍ سليم في حسابك. تأكّد من حالة الشراكة لمصدر عروض أسعارك. وقد يعني ذلك أيضًا حدوث خطأ غير معروف.

التعرّف على مشاكل الخصوصية

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

رسالة الخطأ	معناها	الإجراءات التي يمكنك اتّخاذها
لم يتمّ العثور على تفاصيل الخصوصية يجب التحديث إلى أحدث حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" للاطّلاع على تفاصيل الخصوصية في تطبيقك/طلبك.	يمكن أن يحدث هذا الخطأ عندما يكون إصدار حزمة تطوير البرامج للتطبيق أو الطلب قديمًا جدًّا ولا تستطيع "أداة فحص الإعلانات" عرض إشارات الخصوصية.	حدِّث الإصدار الأدنى من "SDK لإعلانات Google على الأجهزة الجوّالة" التي تتيح ما يلي: ‫Android 21.2.0 أو iOS 9.8.0

تحديد وحلّ المشاكل المتعلّقة بالقيم المفقودة غير المتوقّعة

عند تحديد المشاكل وحلّها، إذا لاحظت أيّ حالات تظهر فيها القيمة كشرطة (–) فقط، يعني ذلك أنّ الإشارة مفقودة. قد تحتاج إلى التأكُّد من الدمج مع منصّة إدارة موافقة (CMP) معتمَدة من Google وأنّ جهاز الاختبار يُبلّغ عن الموقع الجغرافي اللازم.

استخدام منصّة إدارة موافقة معتمَدة من Google

عند عرض الإعلانات للمستخدمين في المنطقة الاقتصادية الأوروبية أو المملكة المتّحدة أو سويسرا، يجب التأكُّد من استخدام منصّة لإدارة الموافقة (CMP) معتمَدة من Google ومتوافقة مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB.

Learn how to integrate with a Google-certified CMP.

التأكُّد من أنّ الموقع الجغرافي تسري عليه "اللائحة العامّة لحماية البيانات"

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

• يمكن للناشرين الذين يستخدمون حزمة تطوير البرامج لمنصّة User Messaging Platform‏ (UMP) اتّباع تعليمات Android or iOS لفرض الموقع الجغرافي المطلوب على الأجهزة الاختبارية.
• على الناشرين الذين يستخدمون منصّة إدارة موافقة أخرى معتمَدة من Google العمل مع مزوِّد المنصّة لمعرفة كيفية فرض الموقع الجغرافي المطلوب على أجهزتهم.