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

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

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

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

قبل المتابعة، عليك إعداد GMA Next-Gen SDK.

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

أسرع طريقة لتفعيل الاختبار هي استخدام الوحدات الإعلانية التجريبية التي توفّرها 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"، ولا تعرض الإعلانات المُباعة مباشرةً رمز AdChoices.

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

إذا كنت تريد إجراء اختبارات أكثر دقة باستخدام إعلانات ذات شكل نهائي، يمكنك الآن إعداد جهازك على أنّه جهاز اختباري واستخدام أرقام تعريف الوحدات الإعلانية التي أنشأتها في واجهة مستخدم "مدير إعلانات 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("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، سيظهر لك التصنيف إعلان اختباري في منتصف أعلى الإعلان (بانر أو إعلان بيني أو فيديو مقابل مكافأة):

   

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

   

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

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

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

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

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

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