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

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

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

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

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

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

  • أكمِل البدء.

  • استورِد المكوّن الإضافي Google 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. سيضيف المحرّر صورة أوّلية توفّر تجربة مماثلة لطريقة عمل الإعلانات الفعلية على النظام الأساسي للأجهزة الجوّالة.

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

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

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

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