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

يوضِّح هذا الدليل كيفية تفعيل الإعلانات الاختبارية في عملية دمج الإعلانات. من المهم تفعيل الإعلانات الاختبارية أثناء التطوير حتى تتمكّن من النقر عليها بدون تحصيل رسوم من مُعلني 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
الإعلانات البينية ca-app-pub-3940256099942544/1033173712
إعلان بمكافأة ca-app-pub-3940256099942544/5224354917
الإعلان البيني بمكافأة ca-app-pub-3940256099942544/5354046379
مدمج مع المحتوى ca-app-pub-3940256099942544/2247696110

iOS

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

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

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

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

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

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

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

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

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

  1. يمكنك تشغيل تطبيق تم إعداده باستخدام حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة وتقديم طلب إعلان باستخدام أحد أرقام تعريف الوحدات الإعلانية الاختبارية المذكورة أعلاه. بيانات الرموز:

    ...
    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".

    RequestConfiguration requestConfiguration = new RequestConfiguration();
    requestConfiguration.TestDeviceIds.Add("2077ef9a63d2b398840261c8221a0c9b");
  5. ضبط requestConfiguration على مستوى العالم على MobileAds

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

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

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

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

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

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

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

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

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