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

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

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

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

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

قبل المتابعة، عليك تنفيذ ما يلي:

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

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

  • In-context:

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

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

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

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

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

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

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

    صفحة سجلّ طلبات حزمة SDK مع رمز التعديل

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

    ضبط صفحة طلب عرض إعلان مخصّصة لإعلان بانر

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

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

      • البدء بكتم الصوت: مفتاح تبديل لكتم صوت المحتوى عند البدء
      • Click to Expand Requested: يحدّد ما إذا كان يجب أن يتضمّن الفيديو المطلوب سلوك النقر للتوسيع.
  4. انقر على طلب إعلان اختباري مخصّص. في حال نجاح العملية، سيظهر الإعلان الاختباري المخصّص في سجلّ طلبات حزمة تطوير البرامج (SDK).

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

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

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

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

    Android
    iOS

  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. انقر على إيقاف الاختبار.

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

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