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

اختيار المنصة: Android جديد Android iOS Unity Flutter

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

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

قبل المتابعة، عليك إعداد Google Mobile Ads 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
ملاحظة مهمة: تم ضبط هذه الوحدات الإعلانية التجريبية لعرض الإعلانات المباعة مباشرةً في "إدارة إعلانات Google"، ولا تعرض الإعلانات المباعة مباشرةً رابط AdChoices.

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

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

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

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

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

  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);

    Kotlin

    val testDeviceIds = listOf("TEST_DEVICE_ID")
    val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
    MobileAds.setRequestConfiguration(configuration)

    استبدِل TEST_DEVICE_ID برقم تعريف جهازك الاختباري.

    يمكنك اختياريًا التحقّق من isTestDevice() للتأكّد من أنّه تمّت إضافة جهازك بشكلٍ صحيح كجهاز اختباري.

  4. أعِد تشغيل تطبيقك. إذا كان الإعلان من Google، سيظهر لك تصنيف إعلان اختباري في أعلى وسط الإعلان (بانر أو إعلان بيني أو فيديو مقابل مكافأة):

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

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

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

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

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

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