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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

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

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

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

شكل الإعلان	معرّف الوحدة الإعلانية التجريبية
الإعلانات على شاشة فتح التطبيق	/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

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

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

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

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

ملاحظة مهمة: يتم ضبط برامج محاكاة Android تلقائيًا كأجهزة اختبار.

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

لتسجيل جهازك الاختباري، أكمِل الخطوات التالية:

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، سيظهر تصنيف إعلان اختباري في منتصف الجزء العلوي من الإعلان (إعلان بانر أو إعلان بيني أو إعلان فيديو بمكافأة):

   

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

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

   

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

ملاحظة: لا تعرض الإعلانات المعروضة عبر التوسّط تصنيف إعلان اختباري. يُرجى الاطّلاع على القسم التالي لمعرفة التفاصيل.

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

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

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

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