أداة فحص الإعلانات (إصدار تجريبي)

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

وباستخدام "أداة فحص الإعلانات"، يمكنك إجراء ما يلي:

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

يوضّح هذا الدليل كيفية تشغيل الميزات المختلفة في أداة فحص الإعلانات واستخدامها.

المتطلبات الأساسية

لاستخدام "أداة فحص الإعلانات"، يجب تنفيذ ما يلي:

• تحديد رقم تعريف تطبيق "مدير الإعلانات"

• أكمِل دليل البدء.

• استخدام من Google إصدار حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة 20.2.0 أو إصدار أحدث

• فعِّل وضع الاختبار أو اربط جهازك بخدمة "مدير إعلانات Google". لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية أو الأجهزة المرتبطة.

تشغيل أداة فحص الإعلانات

ويمكن تشغيل "أداة فحص الإعلانات" من أيّ مكان في تطبيقك بالطرق التالية:

1. استخدِم زرّ الإطلاق من قائمة تصحيح الأخطاء.
2. استخدِم الإيماءة التي اخترتها في إعدادات "أداة فحص الإعلانات".
3. استخدام واجهة برمجة التطبيقات المقدَّمة آليًا

الإطلاق باستخدام قائمة تصحيح الأخطاء

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

إذا لم تربط جهازك، قد يُطلب منك لتسجيل الدخول إلى حسابك على "مدير إعلانات 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.
}

تعمل واجهة برمجة التطبيقات هذه مع الأجهزة الاختبارية. مسجّلة آليًا.

عرض الوحدات الإعلانية وتحديد المشاكل وحلّها

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

نوصي بتهيئة إعلانات Google للجوّال حزمة SDK قبل الاستعانة بأداة فحص الإعلانات

الاطّلاع على تفاصيل العرض الإعلاني بدون انقطاع للتوسّط في وحدة إعلانية

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

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

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

عرض تفاصيل عروض الأسعار لوحدة إعلانية

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

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

يتم تصنيف نتائج عروض الأسعار كي تقرّب العناصر القابلة للتنفيذ من أعلى القائمة:

• وفي أعلى الصفحة، تظهر شبكة الإعلانات التي فازت بالمزاد.

• في ما يلي شبكات المواقع الإعلانية التي تتضمّن مشاكل. يمكنك اتباع خطوات تحديد المشاكل وحلّها في نهاية الأسئلة الشائعة عن عروض الأسعار

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

• أخيرًا، في أسفل القائمة، تظهر شبكات الإعلانات التي لم تفُز بمزاد عروض الأسعار.

  

يمكن أن يحدِّد العرض الإعلاني بدون انقطاع في التوسّط مصدر الإعلان الذي فاز بالمزاد المستنِد إلى عروض الأسعار. وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور

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

تصحيح أخطاء الوحدة الإعلانية المتقدمة

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

ملاحظة: لا يمكنك تصدير استجابة الإعلان إلا بعد ربط جهازك من خلال قائمة خيارات تصحيح الأخطاء

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

عرض المحوِّلات المتاحة

انقر على علامة التبويب المحوِّلات للاطّلاع على قائمة بجميع المحوِّلات التابعة لجهات خارجية والمرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، وسِّع البطاقات للاطّلاع على حالات بدء التشغيل وإصدارات حزمة تطوير البرامج (SDK). بالإضافة إلى المحوِّلات المتوافقة التابعة لجهات خارجية، يمكنك أيضًا الاطّلاع على محوِّلات الأحداث المخصّصة. تتيح الأحداث المخصّصة للناشرِين استخدام شبكات المواقع الإعلانية التي Ad Manager لا تتوافق مع منصّتك. يمكن تمييز الأحداث المخصّصة عن محوِّلات الطرف الثالث العادية في قائمة المحوِّلات من خلال أسماء الفئات الفريدة. بالإضافة إلى وتوفير معلومات اسم الفئة والحالة، فإن أداة فحص الإعلانات تعرض أيضًا التصنيفات المعيّنة لهذه الأحداث المخصَّصة في Ad Manager واجهة ويب.

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

ملاحظة: عمليات تنفيذ أحداث مخصّصة في وقت سابق، قبل واجهة برمجة التطبيقات الإصدار v20.0.0 أن واجهات برمجة التطبيقات المتوقّفة نهائيًا عن الفئة الفرعية لا تدعم الإعداد وتظهر تمّ رصد مشكلة ضمن "أداة فحص الإعلانات". إذا ظهر لك هذا التحذير في "أداة فحص الإعلانات" على الرغم من أنّ عملية دمج الحدث المخصّص تبدو ناجحة، تحقّق مما إذا كان تطبيقك يستخدم واجهات متوقّفة نهائيًا مثل CustomEventBanner استبدِلها بالفئة الجديدة Adapter .

اختبار وحداتك الإعلانية

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

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

اختبار الإعلانات

تُعدّ اختبارات الإعلانات في "أداة فحص الإعلانات" الموضّحة في هذا القسم أداة رائعة والتحقّق من تجربة الإعلانات الأساسية والتحقّق من صحة التوسّط الإعدادات عند استخدامها مع اختبار مصدر إعلان فردي.

نقطة رئيسية: على الرغم من أن وحدتك الإعلانية قد تتوافق مع أشكال إعلانات متعددة، إلا أن الإعلان لا يسمح لك برنامج الفحص بتحديد التنسيق الذي ترغب في اختباره، ولكن بدلاً من ذلك، تلقائيًا على آخر تنسيق مطلوب.

عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزر طلب إعلان اختباري فيверху أعلى شاشة "أداة فحص الإعلانات" لبدء اختبار الإعلان في "أداة فحص الإعلانات". اختبار تظهر النتائج بعد ذلك في سجل طلبات SDK أسفل العنوان من أداة فحص الإعلانات

ملاحظة: لاستخدام ميزة طلب إعلان تجريبي، إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" مع سياق Activity

اطّلع على كيفية استخدام "أداة فحص الإعلانات" في التطبيق

اختبار مصدر إعلان فردي

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

لتفعيل هذه الميزة، فعِّل مفتاح التبديل اختبار مصدر إعلان فردي في أسفل الشاشة. وسيؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:

عليك إعداد حزمة تطوير برامج "SDK لإعلانات Google على الأجهزة الجوّالة" قبل أن تتمكّن من اختبار مصدر إعلان واحد.

ويمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان، تظهر الشاشة التالية:

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

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

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

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

في حال أضفت عدّة مثيلات من مصدر الإعلان المحدّد إلى تدفق التوسّط ، سترى كل مثيل من الطلب المقدّم إلى مصدر الإعلان في تدفق الإعلانات بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهى تدفق الإعلانات بدون انقطاع من غير تعبئة إعلان.

إيقاف اختبار مصدر إعلان واحد

لإيقاف الاختبار، انقر على زر الإيقاف:

ستظهر بعد ذلك رسالة تأكيد على شاشة إعادة التشغيل التالية:

ننصحك بفرض إعادة تشغيل تطبيقك بعد إيقافه من أجل تنفيذ ما يلي: إيقاف أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تمّ اختباره.

نسخ نتائج تصحيح الأخطاء بالكامل

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

لإجراء ذلك، انقر على رمز التطبيق سبع مرات إلى أن تظهر لك الرسالة تم نسخ ملف JSON الخاص بالمدقّق الإعلاني إلى الحافظة.