تفعيل الإعلانات الاختبارية

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

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

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

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

في ما يلي وحدات إعلانية تجريبية تشير إلى تصميمات إعلانات اختبارية محدّدة لكل شكل إعلان:

شكل الإعلان رقم تعريف الوحدة الإعلانية التجريبية
فتح التطبيق /21775744923/example/app-open
إعلان البانر التكيُّفي /21775744923/example/adaptive-banner
إعلان البانر بحجم ثابت /21775744923/example/fixed-size-banner
الإعلانات البينية /21775744923/example/interstitial
الإعلانات التي تضم مكافأة /21775744923/example/rewarded
الإعلانات البينية التي تضمّ مكافأة /21775744923/example/rewarded-interstitial
المدمَجة مع المحتوى /21775744923/example/native
الإعلانات المدمَجة مع المحتوى /21775744923/example/native-video
النقطة الرئيسية: تم ضبط هذه الوحدات الإعلانية التجريبية لعرض الإعلانات المُباعة مباشرةً في "مدير إعلانات Google"، ولا تعرِض الإعلانات المُباعة مباشرةً ميزة AdChoices.

تفعيل الأجهزة الاختبارية

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

اتّبِع الخطوات التالية لإضافة جهازك كجهاز اختباري.

إضافة جهاز الاختبار آليًا

إذا كنت تريد اختبار الإعلانات في تطبيقك أثناء تطويره، اتّبِع الخطوات التالية لتسجيل جهازك التجريبي آليًا.

  1. حمِّل تطبيقك المُدمَج مع الإعلانات وأرسِل طلب إعلان.
  2. راجِع مخرجات logcat بحثًا عن رسالة تشبه الرسالة أدناه، والتي تعرِض لك رقم تعريف جهازك وكيفية إضافته كجهاز اختبار: 
    I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
to get test ads on this device."
     انسخ رقم تعريف جهاز الاختبار إلى الحافظة.
  3. عدِّل الرمز لاستدعاء RequestConfiguration.Builder.setTestDeviceIds() وإدخال قائمة بأرقام تعريف الأجهزة الاختبارية.

    Java

    List<String> testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231");
RequestConfiguration configuration =
    new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
MobileAds.setRequestConfiguration(configuration);

    Kotlin

    val testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231")
val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
MobileAds.setRequestConfiguration(configuration)
    يمكنك اختياريًا وضع علامة في المربّع بجانب isTestDevice() للتأكّد من إضافة جهازك بشكلٍ صحيح كجهاز اختبار.

  4. أعِد تشغيل تطبيقك. إذا كان الإعلان من إعلانات Google، سيظهر لك تصنيف إعلان اختباري في أعلى الإعلان (بانر أو إعلان بيني أو إعلان فيديو يضم مكافأة):

    بالنسبة إلى الإعلانات المدمجة مع المحتوى (المتقدّمة)، يتمّ وضع السلسلة إعلان اختباري في بداية مادة عرض العنوان.

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

ملاحظة: للاطّلاع على تصنيف الإعلان الاختباري، يجب استخدام إصدار حزمة تطوير البرامج (SDK) 11.6.0 أو إصدار أحدث.

الاختبار باستخدام التوسّط

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

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

إذا لم تكن متأكّدًا مما إذا كان محوِّل شبكة إعلانات التوسّط يتيح الإعلانات الاختبارية، من الأفضل تجنُّب النقر على الإعلانات من تلك الشبكة أثناء التطوير. يمكنك استخدام الأسلوب getMediationAdapterClassName() في أيّ من أشكال الإعلانات لمعرفة الشبكة الإعلانية التي عرضت الإعلان الحالي.