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

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

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

هناك طريقتان للحصول على إعلانات اختبارية:

1. استخدام إحدى الوحدات الإعلانية التجريبية من Google.
2. استخدام وحدتك الإعلانية وتفعيل الأجهزة الاختبارية.

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

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

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

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

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

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

شكل الإعلان	رقم تعريف الوحدة الإعلانية التجريبية
الإعلانات على شاشة فتح التطبيق	ca-app-pub-3940256099942544/9257395921
إعلانات البانر التكيُّفية الثابتة	ca-app-pub-3940256099942544/9214589741
إعلانات البانر التكيُّفية المضمّنة	ca-app-pub-3940256099942544/9214589741
إعلانات البانر ذات الحجم الثابت	ca-app-pub-3940256099942544/6300978111
الإعلانات البينية	ca-app-pub-3940256099942544/1033173712
الإعلانات مقابل مكافأة	ca-app-pub-3940256099942544/5224354917
الإعلانات البينية مقابل مكافأة	ca-app-pub-3940256099942544/5354046379
الإعلان المدمجة مع المحتوى	ca-app-pub-3940256099942544/2247696110
الإعلان المدمج مع المحتوى (فيديو)	ca-app-pub-3940256099942544/1044960115
نافذة ضمن النافذة	ca-app-pub-3940256099942544/9657123429

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

إذا أردت إجراء اختبار أكثر دقة باستخدام إعلانات ذات شكل نهائي، يمكنك الآن إعداد جهازك على أنّه جهاز اختباري واستخدام أرقام تعريف الوحدات الإعلانية التي أنشأتها في واجهة مستخدم AdMob. يمكن إضافة الأجهزة الاختبارية في واجهة مستخدم AdMob أو بطريقة آلية باستخدام Google Mobile Ads SDK (Legacy).

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

**ملاحظة مهمة:** يتم تلقائيًا إعداد محاكيات Android كأجهزة اختبارية.

إضافة جهازك الاختباري في واجهة مستخدم AdMob

لإضافة جهاز اختباري واختبار إصدارات التطبيقات الجديدة أو الحالية بطريقة غير آلية، استخدِم واجهة مستخدم AdMob. كيفية إجراء ذلك.

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

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

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

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". ولاختبار إعداد "توسّط AdMob" ، عليك استخدام أسلوب تفعيل أجهزة الاختبار.

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

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