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

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

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

  1. استخدِم أحد نماذج الوحدات الإعلانية من Google.

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

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

  • أكمِل خطوات البدء.

  • استورِد المكوّن الإضافي Unity لـ "إعلانات Google على الأجهزة الجوّالة" إلى تطبيق Unity.

نماذج الوحدات الإعلانية

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

من المهم ملاحظة أنه يجب استخدام وحدات إعلانية اختبارية مختلفة توفرها Google اعتمادًا على النظام الأساسي. يجب استخدام وحدة إعلانية اختبارية لنظام التشغيل iOS من أجل إرسال طلبات عرض الإعلانات الاختبارية على أجهزة iOS، ووحدة إعلانية اختبارية لنظام التشغيل Android من أجل إرسال الطلبات على أجهزة Android.

في ما يلي نماذج للوحدات الإعلانية لكل شكل على نظامَي التشغيل Android وiOS:

Android

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

iOS

شكل الإعلان نموذج معرّف الوحدة الإعلانية
الإعلانات على شاشة فتح التطبيق ca-app-pub-3940256099942544/5575463023
إعلان بانر ثابت الحجم ca-app-pub-3940256099942544/2934735716
إعلان بانر تكيُّفي ثابت ca-app-pub-3940256099942544/2435281174
الإعلانات البينية ca-app-pub-3940256099942544/4411468910
الإعلانات مقابل مكافأة ca-app-pub-3940256099942544/1712485313
الإعلانات البينية مقابل مكافأة ca-app-pub-3940256099942544/6978759866
الإعلان المدمجة مع المحتوى ca-app-pub-3940256099942544/3986624511
نافذة ضمن النافذة ca-app-pub-3940256099942544/8810945611

وتشير هذه الوحدات الإعلانية إلى تصاميم إعلانات اختبارية محدّدة.

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

إذا أردت إجراء اختبار أكثر صرامة باستخدام إعلانات ذات مظهر نهائي، يمكنك الآن إعداد جهازك كجهاز اختباري واستخدام معرّفات الوحدات الإعلانية التي أنشأتها في واجهة مستخدم AdMob. يمكن إضافة الأجهزة الاختبارية إما في واجهة مستخدم AdMob أو آليًا باستخدام Google Mobile Ads Unity Plugin.

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

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

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

استخدام وضع الاختبار على مستوى التطبيق

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

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

إذا أردت اختبار الإعلانات في تطبيقك أثناء تطويره، اتّبِع الخطوات التالية لتسجيل جهاز الاختبار آليًا.

  1. شغِّل تطبيقًا تم ضبطه باستخدام Google Mobile Ads Unity Plugin وأرسِل طلب عرض إعلان باستخدام أحد معرّفات الوحدات الإعلانية الاختبارية المذكورة أعلاه. قائمة الرموز:

    ...
    private void RequestBanner()
    {
        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif
    
        // Create a 320x50 banner at the top of the screen.
        bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);
        // Create an empty ad request.
        AdRequest request = new AdRequest();
        // Load the banner with the request.
        bannerView.LoadAd(request);
    }
  2. تحقَّق من وحدة التحكّم أو مخرجات logcat بحثًا عن رسالة تبدو على النحو التالي:

    Android

    I/Ads: Use
      RequestConfiguration.Builder
        .setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
      to get test ads on this device.

    iOS

    <Google> To get test ads on this device, set:
      GADMobileAds.sharedInstance.requestConfiguration.testDeviceIdentifiers =
      @[ @"2077ef9a63d2b398840261c8221a0c9b" ];
  3. انسخ رقم تعريف الجهاز الاختباري المكوَّن من حروف أبجدية وأرقام إلى الحافظة.

  4. عدِّل الرمز البرمجي لإضافة أرقام تعريف الأجهزة الاختبارية إلى قائمة RequestConfiguration.TestDeviceIds.

    List<string> testDeviceIds = new List<string>();
    testDeviceIds.Add("TEST_DEVICE_ID");
    
    RequestConfiguration requestConfiguration = new RequestConfiguration
    {
        TestDeviceIds = testDeviceIds
    };

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

  5. اضبط السمة requestConfiguration على مستوى العالم على MobileAds.

    MobileAds.SetRequestConfiguration(requestConfiguration);
    
  6. أعِد تشغيل تطبيقك. إذا أضفت جهازك بشكل صحيح كجهاز اختباري، سيظهر لك تصنيف إعلان اختباري في منتصف الجزء العلوي من إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافآت:

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

  7. بعد تسجيل جهازك كجهاز اختباري، يمكنك البدء في تلقّي إعلانات اختبارية أكثر واقعية من خلال استبدال adUnitID الاختبار بـ adUnitID الخاص بك.

الاختبار باستخدام Unity Editor

بدءًا من الإصدار 5.4.0، يمكنك اختبار إعلاناتك مباشرةً في محرِّر Unity. سيضيف المحرّر صورة Prefab تمنح تجربة مشابهة لكيفية ظهور الإعلانات الفعلية على منصة الأجهزة الجوّالة.

الاختبار باستخدام ميزة "التوسّط"

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

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

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