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

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

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

قبل المتابعة، عليك إعداد Google Mobile Ads SDK (Legacy).

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

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

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

شكل الإعلان	رقم تعريف الوحدة الإعلانية التجريبية
الإعلانات على شاشة فتح التطبيق	/21775744923/example/app-open
إعلانات البانر التكيُّفية الثابتة	/21775744923/example/adaptive-banner
إعلانات البانر التكيُّفية المضمّنة	/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
نافذة ضمن النافذة	/21775744923/example/picture-in-picture

ملاحظة مهمة: تم ضبط هذه الوحدات الإعلانية التجريبية لعرض الإعلانات المباعة مباشرةً في Ad Manager، ولا تعرض الإعلانات المباعة مباشرةً ميزة "خيارات الإعلانات".

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

إذا أردت إجراء اختبار أكثر دقة باستخدام إعلانات ذات شكل نهائي، يمكنك الآن إعداد جهازك على أنّه جهاز اختباري واستخدام أرقام تعريف الوحدات الإعلانية التي أنشأتها في واجهة مستخدم Ad Manager.

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

إضافة جهازك الاختباري بطريقة آلية

لتسجيل جهازك الاختباري، يُرجى اتّباع الخطوات التالية:

1. حمِّل تطبيقك المتكامل مع الإعلانات وأرسِل طلب عرض إعلان.
2. ابحث في سجلّ logcat عن رسالة مشابهة للرسالة التالية، والتي تعرض رقم تعريف جهازك وكيفية إضافته كجهاز اختباري:

   I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
   to get test ads on this device."

   انسخ رقم تعريف الجهاز الاختباري إلى الحافظة.

3. عدِّل الرمز البرمجي لاستدعاء RequestConfiguration.Builder.setTestDeviceIds() وتوفير قائمة بأرقام تعريف أجهزتك الاختبارية.

   جافا

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

   Kotlin

   val testDeviceIds = listOf("TEST_DEVICE_ID")
   val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
   MobileAds.setRequestConfiguration(configuration)
   RequestConfigurationSnippets.kt

   استبدِل TEST_DEVICE_ID برقم تعريف جهازك الاختباري.

   يمكنك اختياريًا التحقّق من isTestDevice() للتأكّد من أنّه تمّت إضافة جهازك بشكلٍ سليم كجهاز اختباري.

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

   

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

   

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

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

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

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

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