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

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

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

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

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

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

شكل الإعلان نموذج رقم تعريف الوحدة الإعلانية
فتح التطبيق /6499/example/app-open
إعلان البانر التكيُّفي /6499/example/adaptive-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، سترى تصنيف إعلان تجريبي في أعلى الإعلان (إعلان بانر أو إعلان بيني أو فيديو يضم مكافأة):

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

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

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

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

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

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

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