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

اختيار المنصة: Android Android iOS Unity Flutter

تتيح "أداة فحص الإعلانات" الاختبارات التالية:

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

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

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

قبل المتابعة، يُرجى اتّخاذ الإجراءات التالية:

• أكمِل جميع البنود في المتطلبات الأساسية الأولية لإنشاء حساب على "مدير إعلانات Google" وضبط جهازك الاختباري وتهيئة Google Mobile Ads SDK، وتثبيت أحدث إصدار.
• افتح أداة فحص الإعلانات.

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

لطلب إعلان اختباري في "أداة فحص الإعلانات"، أكمِل الخطوات التالية. لمزيد من التفاصيل، يُرجى الاطّلاع على أداة فحص الإعلانات.

• داخل السياق:

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

• Out-of-context:

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

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

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

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

لإنشاء إعلان اختباري مخصّص، اتّبِع الخطوات التالية:

1. في علامة التبويب الوحدة الإعلانية ، انقر على الوحدة الإعلانية التي تريد إنشاء إعلان اختباري مخصّص لها.

2. انقر على تعديلتعديل:

   

   تظهر صفحة ضبط طلب عرض الإعلان المخصّص. يعرض المثال التالي صفحة ضبط طلب عرض الإعلان المخصّص لإعلان بانر:

   

3. أدخِل طلب عرض الإعلان وتفاصيله في الحقول التالية:

   • طلب الإعلان:
     • عنوان URL للمحتوى: عنوان URL للمحتوى المحيط بالإعلان لمزيد من التفاصيل، يُرجى الاطّلاع على عنوان URL للمحتوى.
     • عناوين URL للمحتوى المجاور: عنوان URL للمحتوى الذي يظهر قبل الإعلان وبعده لمزيد من التفاصيل، يُرجى الاطّلاع على تعيين المحتوى للتطبيقات.
     • الاستبعادات حسب الفئة: حظر الإعلانات من معلِنين أو علامات تجارية أو فئات معيّنة
     • المعرّف الذي يقدّمه الناشر: يمكنك ضبط معرّف في عناصر التحكّم في تحديد عدد مرات الظهور و عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة. لمزيد من التفاصيل، يُرجى الاطّلاع على المعرّفات التي يقدّمها الناشر.
   • استنادًا إلى شكل الإعلان، أدخِل تفاصيل الإعلان التالية:
     • إعلانات البانر: أدخِل عرض الإعلان وارتفاعه. لمزيد من التفاصيل، يُرجى الاطّلاع على إعلانات البانر.
     • إعلانات مدمجة مع المحتوى:
       • نسبة العرض إلى الارتفاع للوسائط: اختَر نسبة العرض إلى الارتفاع المفضّلة للوسائط. لمزيد من التفاصيل، يُرجى الاطّلاع على عرض "إعلان مدمج مع المحتوى" بملء الشاشة.
       • إيقاف تحميل مادة عرض الصورة: يحدّد ما إذا كان على Google Mobile Ads SDK تحميل محتوى مادة عرض الصورة. لمزيد من التفاصيل، يُرجى الاطّلاع على التحكّم في تنزيل الصور.
       • تجاهل هذا الإعلان المخصّص: يحدّد ما إذا كان سيتم استخدام ميزة "تجاهل هذا الإعلان" المخصّصة. لمزيد من التفاصيل، يُرجى الاطّلاع على customMuteThisAdRequested.
       • الموضع المفضّل لرمز "خيارات الإعلانات": يشير إلى الموضع المفضّل لرمز "خيارات الإعلانات" . لمزيد من التفاصيل، يُرجى الاطّلاع على مواضع "خيارات الإعلانات".

   • خيارات الفيديو:

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

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

ملاحظة: لكل وحدة إعلانية، تحفظ "أداة فحص الإعلانات" إعدادات الإعلان الاختباري المخصّص لأحدث طلب عرض إعلان مخصّص.

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

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

لاختبار مصدر إعلان فردي، أكمِل الخطوات التالية:

1. في أداة فحص الإعلانات، انقر على مفتاح التبديل اختبار مصدر إعلان فردي. يظهر مربّع حوار اختبار مصدر إعلان فردي:

   

2. اختَر مصدر إعلان لاختباره. بعد ذلك، ستظهر لك صفحة فرض إعادة تشغيل التطبيق:

   

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

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

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

Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME

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

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

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

لإيقاف الاختبار، أكمِل الخطوات التالية:

1. في أداة فحص الإعلانات، انقر على مفتاح التبديل اختبار مصدر إعلان فردي لإيقافه. يظهر مربّع الحوار هل تريد إيقاف اختبار مصدر إعلان فردي؟.

2. انقر على إيقاف الاختبار.

   

   في حال نجاح هذا الإجراء، ستظهر رسالة تأكيد فوق فرض إعادة تشغيل التطبيق:

   

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