باستخدام "أداة فحص الإعلانات" في إصدارات حزمة SDK لعرض الإعلانات على الأجهزة الجوّالة الأقل من 20.2.0، يمكنك إجراء ما يلي:
- فحص وحداتك الإعلانية
- فحص المحوّلات التابعة لجهات خارجية
- التحقّق من تعبئة إعلاناتك على النحو المتوقّع
- تحديد الأخطاء والاطّلاع على التفاصيل التي تتعلّق بكيفية حلّها
- الاطّلاع على تفاصيل التوسّط لكل شبكة إعلانات في كل طلب
- اختبار مصادر إعلانات فردية تابعة لجهات خارجية تعمل في مجال التوسّط
- التحقّق من ضبط كلّ وحدة إعلانية لتوسّط العرض الإعلاني بدون انقطاع بشكل صحيح
- اختبار عمليات دمج الأحداث المخصّصة
بالنسبة إلى الإصدار 20.2.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة والإصدارات الأحدث، يمكنك أيضًا إجراء ما يلي:
- الاطّلاع على تفاصيل عروض الأسعار لكل شبكة إعلانات في كل طلب
- يمكنك عرض تفاصيل توسّط العرض الإعلاني بدون انقطاع وعروض الأسعار معًا لكل شبكة إعلانات لكل طلب
- اختبار مصادر إعلانات فردية تابعة لجهات خارجية للتوسّط في عروض الأسعار أو العرض بدون انقطاع
عليك التحقّق من ضبط كلّ وحدة إعلانية بشكل صحيح لكلٍّ من عروض الأسعار والتوسّط في العرض الإعلاني بدون انقطاع
يوضّح هذا الدليل كيفية إطلاق الميزات المختلفة واستخدامها في أداة فحص الإعلانات.
المتطلبات الأساسية
لاستخدام "أداة فحص الإعلانات"، يجب تنفيذ ما يلي:
- عليك إنشاء حساب على AdMob وإعداد تطبيق.
- أكمِل دليل البدء.
- استخدِم الإصدار 20.0.0 أو إصدار أحدث من "SDK لإعلانات Google على الأجهزة الجوّالة".
- أضِف جهازك كجهاز اختباري. لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية.
تشغيل "أداة فحص الإعلانات"
يمكن تشغيل "أداة فحص الإعلانات" من أي مكان في تطبيقك بالطرق التالية:
- استخدِم الإيماءة التي تم اختيارها في واجهة مستخدم AdMob عند تسجيل جهاز اختباري.
- آليًا باستخدام واجهة برمجة التطبيقات المقدَّمة
- استخدِم زر الإطلاق من قائمة تصحيح الأخطاء.
الإطلاق باستخدام الإيماءات
لا يلزم إجراء أي تغييرات في تطبيقك لتشغيل "أداة فحص الإعلانات" بإيماءة، ما عليك سوى تنفيذ الإيماءة (التمرير المزدوج أو الاهتزاز) التي ضبطتها في AdMob لهذا الجهاز الاختباري. مزيد من المعلومات
بعد ضبط إيماءة في واجهة مستخدم AdMob (والانتظار لمدة 15 دقيقة لكي تتم نشرها)، يجب أن يقدّم تطبيقك طلب إعلان لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة للتعرّف على إعداد الإيماءة. إذا كانت الإيماءة المحددة لا تعمل، جرِّب تحميل إعلان وإعادة تشغيل التطبيق واختبار الإيماءة مرة أخرى.
الإطلاق آليًا
يمكن أيضًا تشغيل "أداة فحص الإعلانات" آليًا:
Java
MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
public void onAdInspectorClosed(@Nullable AdInspectorError error) {
// Error will be non-null if ad inspector closed due to an error.
}
});
Kotlin
MobileAds.openAdInspector(context) { error ->
// Error will be non-null if ad inspector closed due to an error.
}
تعمل واجهة برمجة التطبيقات هذه مع الأجهزة الاختبارية المسجّلة آليًا أو في واجهة مستخدم AdMob.
عرض الوحدات الإعلانية وتحديد مشاكلها وحلّها
بعد إطلاق "أداة فحص الإعلانات"، تظهر الشاشة الرئيسية التي تتضمّن قائمة بجميع الوحدات الإعلانية في واجهة مستخدم AdMob المرتبطة برقم تعريف تطبيقك على AdMob التي تتضمّن إعدادات عروض أسعار أو توسّط:
ننصحك بإعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل استخدام أداة فحص الإعلانات.
الاطّلاع على تفاصيل العرض الإعلاني بدون انقطاع للتوسّط في وحدة إعلانية
انقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK)، والذي يقدّم تفاصيل عن تدفق التوسّط حتى نقطة تعبئة الإعلان (أو تدفق التوسّط الذي انتهى بدون تعبئة) لأحدث طلبات الإعلان.
يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض نتائج تدفق التوسط لهذا الطلب، إلى جانب أي خطأ ووقت استجابة كان ينطبق على هذا الطلب.
بالنسبة إلى مصادر الإعلانات التابعة لجهات خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان. وإذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.
عرض تفاصيل عروض الأسعار لوحدة إعلانية
المتطلّبات الأساسية: الإصدار 20.2.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة أو إصدار أحدث
إذا كنت مبتدئًا في مجال عروض الأسعار، اطّلِع على النظرة العامة.
في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على مصادر الإعلانات المستندة إلى عروض الأسعار التي يتم طلبها في طلب الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) للاطّلاع على تفاصيل كل مصدر إعلان في مزاد عروض الأسعار.
يتم ترتيب نتائج عروض الأسعار لتقريب العناصر القابلة للتنفيذ من أعلى القائمة:
في أعلى الصفحة، تظهر شبكة المواقع الإعلانية التي فازت بالمزاد.
في ما يلي شبكات المواقع الإعلانية التي تتضمّن مشاكل. يمكنك اتّباع خطوات تحديد المشاكل وحلّها.
وبعد ذلك، هناك شبكات الإعلانات التي لم تعرض أي إعلانات أو لم تقدم عروض أسعار. وهذا مؤشر محتمل للعديد من المشاكل المختلفة في مصدر الإعلان لأنه قد لا يتم تقديم عروض أسعار بسبب إعداده أو قراره. يمكنك الرجوع إلى دليل إعداد مصدر الإعلان أو التواصل مع مصدر الإعلان مباشرةً للحصول على الدعم.
أخيرًا، في أسفل القائمة، تظهر شبكات الإعلانات التي لم تفُز بمزاد عروض الأسعار.
يمكن أن يحدِّد العرض الإعلاني بدون انقطاع للتوسّط مصدر الإعلان الذي فاز بمزاد عروض الأسعار وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور (eCPM).
عند طلب مصدر إعلان في تدفق التوسّط، يمكنه عرض الإعلانات. لمعرفة المزيد من المعلومات عن آلية عمل عروض الأسعار مع العرض الإعلاني بدون انقطاع للتوسّط، يمكنك الاطّلاع على المثال 2 والمثال 3 على عروض الأسعار ومصادر الإعلانات للعرض بدون انقطاع في مجموعة توسّط.
تصحيح أخطاء الوحدة الإعلانية المتقدّم
عند تحديد المشاكل وحلّها في الوحدات الإعلانية، قد يكون من المفيد التوغّل في طلب الإعلان والاستجابة لتحديد مكان حدوث المشكلة، أو مشاركتها مع فريق دعم Google للمساعدة في تصحيح الأخطاء. انقر على رمز القائمة في أعلى سلسلة العرض الإعلاني بدون انقطاع، واختَر مشاركة طلب الإعلان والاستجابة لتصدير طلب الإعلان بالكامل والاستجابة. ويوفّر ذلك عناء الاضطرار إلى تشغيل عمليات تتبُّع الشبكات على تطبيقك.
بالإضافة إلى ذلك، يمكنك عرض مَعلمات عروض الأسعار التابعة لجهة خارجية التي تم فك ترميزها من خلال النقر على خيار مَعلمة عروض الأسعار التابعة لجهة خارجية في القائمة نفسها التي تتضمّن سلسلة الطلب. يوفّر هذا التقرير تفاصيل عن مَعلمات عروض الأسعار التابعة لجهات خارجية التي قد تواجه مشاكل، ما يساعدك في تصحيح أخطاء تطبيقك أو التأكّد من أنّ الشبكة تجمع إشاراتها بنجاح.
عرض المحوّلات المتاحة
انقر على علامة التبويب المحوِّلات للاطّلاع على قائمة بجميع المحوِّلات التابعة لجهات خارجية والمرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، وسِّع البطاقات للاطّلاع على حالات بدء التشغيل وإصدارات حزمة تطوير البرامج (SDK). بالإضافة إلى المحوِّلات المتوافقة التابعة لجهات خارجية، يمكنك أيضًا الاطّلاع على محوِّلات الأحداث المخصّصة. تتيح الأحداث المخصّصة للناشرِين استخدام شبكات المواقع الإعلانية التي لا تتوافق مع AdMob . يمكن تمييز الأحداث المخصّصة عن محوِّلات الطرف الثالث العادية في قائمة المحوِّلات من خلال أسماء الفئات الفريدة. إضافةً إلى توفير اسم الفئة ومعلومات الحالة، يعرض فاحص الإعلانات أيضًا التصنيفات المخصّصة لتلك الأحداث المخصّصة في واجهة الويب AdMob.
في حال عدم العثور على المحوّل أو تعذّر إعداده، يمكنك الاطّلاع على تحديد المشاكل التي تم العثور عليها باستخدام أداة فحص الإعلانات وحلّها للحصول على مزيد من المعلومات.
اختبار وحداتك الإعلانية
إذا كنت تريد اختبار وحدتك الإعلانية بدون الحاجة إلى الانتقال إليها في واجهة مستخدم تطبيقك، تتيح لك "أداة فحص الإعلانات" إجراء ذلك مباشرةً من شاشة تفاصيل الوحدة الإعلانية. بالإضافة إلى ذلك، يمكنك اختبار وحدات إعلانية متعدّدة في الوقت نفسه، وتحميل طلبات الإعلان الاختبارية وعرضها بشكل غير متزامن، وحتى إجراء اختبارات فردية لمصدر الإعلانات.
اختبار الإعلانات
تعتبر اختبارات الإعلانات لأداة فحص الإعلانات الموضّحة في هذا القسم أداة رائعة للتحقّق من تجربة الإعلانات الأساسية وللتحقّق من صحة إعدادات التوسّط عند استخدامها مع اختبار مصدر إعلان فردي.
عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزر طلب إعلان اختباري فيверху أعلى شاشة "أداة فحص الإعلانات" لبدء اختبار الإعلان في "أداة فحص الإعلانات". تظهر نتائج الاختبار بعد ذلك في سجلّ طلبات حزمة تطوير البرامج (SDK) أسفل العنوان تم طلبه من "أداة فحص الإعلانات".
اختبار مصدر إعلان واحد
تتضمّن "أداة فحص الإعلانات" ميزة لتقييد طلبات الإعلانات في تطبيقك لعرض الإعلانات فقط من مصدر إعلان واحد للتوسّط في عروض الأسعار أو للعرض بدون انقطاع. يتيح لك ذلك التحقّق من أنّك طبّقت بشكل صحيح المحوّل التابع لجهة خارجية وأنّ مصدر الإعلان يعرض الإعلانات على النحو المتوقّع.
لتفعيل هذه الميزة، فعِّل مفتاح التبديل اختبار مصدر إعلان فردي في أسفل الشاشة. يؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:
يجب إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل أن تتمكّن من استخدام اختبار مصدر إعلان فردي.
يمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان، تظهر الشاشة التالية:
ينطبق إعداد اختبار مصدر الإعلان الفردي على أي طلبات إعلان مستقبلية تقدّمها في الجلسة نفسها. ومع ذلك، لا ينطبق ذلك على أي إعلانات مخزنة مؤقتًا في تلك الجلسة لم يتم عرضها بعد. ننصحك بفرض إعادة تشغيل تطبيقك عند تطبيق اختبار مصدر إعلان فردي لإبطال أي إعلانات محفوظة في ذاكرة التخزين المؤقت يمكن عرضها بدلاً من أن يتلقّى مصدر الإعلان الذي اخترته طلبًا.
بعد إعادة تشغيل تطبيقك، تحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة المحدّدة فقط. عند تشغيل "أداة فحص الإعلانات" عندما يكون اختبار مصدر إعلان فردي نشطًا، يظهر مصدر الإعلان الاختباري النشط:
في وضع اختبار مصدر الإعلان الفردي، تحاول جميع طلبات الإعلان التعبئة باستخدام مصدر الإعلان المحدّد، بغض النظر عمّا إذا تم إعداد مصدر الإعلان هذا لتقديم عروض الأسعار أو التوسّط للوحدة الإعلانية المطلوبة. إذا لم يكن مصدر الإعلان الذي تختبره مُدرَجًا في تدفق التوسّط لإحدى الوحدات الإعلانية، ستظهر لك رسالة خطأ "تعذُّر عرض الإعلان".
في اختبار مصدر إعلان واحد، يمكنك النقر على وحدة إعلانية لعرض سجلّ طلبات حزمة تطوير البرامج (SDK) الخاص بها. يتيح لك ذلك معرفة ما إذا كان مصدر الإعلان قد ملأ طلبات الإعلان التي تم إجراؤها بعد تفعيل اختبار مصدر إعلان فردي. إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ تصف الخطأ.
إذا أضفت مثيلات متعددة من مصدر الإعلان المحدّد إلى العرض الإعلاني بدون انقطاع للتوسّط، سترى كل مثيل من الطلب المقدّم إلى مصدر الإعلان في العرض الإعلاني بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهى العرض الإعلاني بدون انقطاع بدون تعبئة.
إيقاف اختبار مصدر إعلان فردي
لإيقاف الاختبار، انقر على زر الإيقاف:
بعد ذلك، تظهر رسالة تأكيد على شاشة إعادة التشغيل التالية:
ننصحك بفرض إعادة تشغيل تطبيقك بعد إيقاف الاختبار لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تم اختباره.
نسخ نتائج تصحيح الأخطاء بالكامل
يتيح "أداة فحص الإعلانات" نسخ سلسلة JSON تحتوي على مخرجات كاملة لتحديد الأخطاء وحلّها من الأداة، بما في ذلك تفاصيل تطبيقك على AdMob، وحالات إعداد المُحوِّل، ونتائج اختبار جميع الوحدات الإعلانية.
ولإجراء ذلك، انقر على رمز التطبيق سبع مرات حتى تظهر لك الرسالة تم نسخ ملف JSON الخاص بأداة فحص الإعلان إلى الحافظة.