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

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

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

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

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

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

شكل الإعلان نموذج رقم تعريف الوحدة الإعلانية
فتح التطبيق /6499/example/app-open
بانر تكيُّفي /21775744923/example/banner
بانر بحجم ثابت /6499/example/banner
الإعلانات البينية /6499/example/interstitial
إعلان بمكافأة /6499/example/rewarded
الإعلان البيني بمكافأة /21775744923/example/rewarded_interstitial
مدمج مع المحتوى /6499/example/native
فيديو مدمج مع المحتوى /6499/example/native-video

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

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

    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، سترى عبارة إعلان تجريبي في وسط أعلى الإعلان (بانر أو بيني أو فيديو يضم مكافأة):

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

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

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

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

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

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

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