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

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

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

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

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

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

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

  • استورِد مكوّن Google Mobile Ads Unity الإضافي إلى تطبيق Unity.

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

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

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

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

Android

شكل الإعلان نموذج رقم تعريف الوحدة الإعلانية
الإعلانات على شاشة فتح التطبيق ca-app-pub-3940256099942544/9257395921
البانر ca-app-pub-3940256099942544/6300978111
Interstitial ca-app-pub-3940256099942544/1033173712
Rewarded ca-app-pub-3940256099942544/5224354917
إعلان بيني مقابل مكافأة ca-app-pub-3940256099942544/5354046379
Native ca-app-pub-3940256099942544/2247696110

iOS

شكل الإعلان نموذج رقم تعريف الوحدة الإعلانية
الإعلانات على شاشة فتح التطبيق ca-app-pub-3940256099942544/5575463023
البانر ca-app-pub-3940256099942544/2934735716
Interstitial ca-app-pub-3940256099942544/4411468910
Rewarded ca-app-pub-3940256099942544/1712485313
إعلان بيني مقابل مكافأة ca-app-pub-3940256099942544/6978759866
Native ca-app-pub-3940256099942544/3986624511

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

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

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

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

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

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

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

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

  1. شغِّل تطبيقًا تم إعداده باستخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" وقدِّم طلب إعلان باستخدام أحد أرقام تعريف الوحدات الإعلانية الاختبارية المدرَجة أعلاه. قائمة الرموز

    ...
    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() مع أي من أشكال الإعلانات لمعرفة الشبكة الإعلانية التي عرضت الإعلان الحالي.