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