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

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

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

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

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

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

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

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

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

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

تجدر الإشارة إلى أنّه يجب استخدام الوحدات الإعلانية الاختبارية المختلفة التي توفّرها 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

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

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

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

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

إضافة جهاز الاختبار في واجهة "مدير الإعلانات" على الويب

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

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

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

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