إعلانات البانر

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

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

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

الاختبار دائمًا باستخدام الإعلانات الاختبارية

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

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

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة

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

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

إذا كنت تستخدم التوسط، انتظر حتى يحدث رد الاتصال قبل تحميل الإعلانات حيث سيضمن ذلك إعداد جميع محوّلات التوسط.

مثال على BannerView

يوضح الرمز النموذجي أدناه كيفية استخدام عرض البانر. في المثال، يمكنك إنشاء مثيل لعرض إعلان بانر واستخدام AdRequest لتحميل إعلان في طريقة عرض البانر، ثم توسيع إمكاناته من خلال التعامل مع أحداث مراحل النشاط.

إنشاء طريقة عرض بانر

تتمثل الخطوة الأولى في استخدام طريقة عرض البانر في إنشاء مثيل لعرض البانر في نص برمجي C# مرفق بـ GameObject.


  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
  private string _adUnitId = "unused";
#endif

  BannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner view at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

تتضمن الدالة الإنشائية لـ BannerView المَعلمات التالية:

  • adUnitId: الرقم التعريفي للوحدة الإعلانية التي يجب على "BannerView" تحميل الإعلانات منها
  • AdSize: حجم الإعلان الذي تريد استخدامه. راجِع أحجام إعلانات البانر لمعرفة التفاصيل.
  • AdPosition: الموضع الذي يجب أن يكون فيه مشاهدات البانر يسرد التعداد AdPosition القيم الصالحة الخاصة بمتوسّط موضع الإعلان.

لاحظ كيفية استخدام الوحدات الإعلانية المختلفة حسب النظام الأساسي. يلزمك استخدام وحدة إعلانية لنظام التشغيل iOS لتقديم طلبات الإعلان على نظام التشغيل iOS ووحدة إعلانية لنظام التشغيل Android لتقديم الطلبات على نظام التشغيل Android.

(اختياري) إنشاء طريقة عرض بانر بموضع مخصّص

للتحكم بشكل أكبر في مكان وضع BannerView على الشاشة أكثر مما تقدمه قيم AdPosition، استخدم الدالة الإنشائية التي تتضمن الإحداثيات x وy كمعلمات:

// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);

يتم وضع الزاوية العلوية اليسرى من BannerView عند قيمتَي x وy التي تم تمريرها إلى الدالة الإنشائية، حيث يكون الأصل في أعلى يسار الشاشة.

(اختياري) إنشاء عرض بانر بحجم مخصّص

بالإضافة إلى استخدام ثابت AdSize، يمكنك أيضًا تحديد حجم مخصّص لإعلانك:

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);

تحميل إعلان بانر

لتحميل إعلان، أنشئ AdRequest ومرِّره إلى الطريقة LoadAd().

/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
    // create an instance of a banner view first.
    if(_bannerView == null)
    {
        CreateBannerView();
    }

    // create our request used to load the ad.
    var adRequest = new AdRequest();

    // send the request to load the ad.
    Debug.Log("Loading banner ad.");
    _bannerView.LoadAd(adRequest);
}

الاستماع إلى أحداث عرض البانر

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

/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
    // Raised when an ad is loaded into the banner view.
    _bannerView.OnBannerAdLoaded += () =>
    {
        Debug.Log("Banner view loaded an ad with response : "
            + _bannerView.GetResponseInfo());
    };
    // Raised when an ad fails to load into the banner view.
    _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
    {
        Debug.LogError("Banner view failed to load an ad with error : "
            + error);
    };
    // Raised when the ad is estimated to have earned money.
    _bannerView.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Banner view paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    _bannerView.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Banner view recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    _bannerView.OnAdClicked += () =>
    {
        Debug.Log("Banner view was clicked.");
    };
    // Raised when an ad opened full screen content.
    _bannerView.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Banner view full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    _bannerView.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Banner view full screen content closed.");
    };
}

محو طريقة عرض البانر

عند الانتهاء من استخدام عرض البانر، احرص على طلب Destroy() لتحرير الموارد.

/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyBannerView()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner view.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

أكملت هذه الخطوة. تطبيقك جاهز الآن لعرض إعلانات البانر.

يسرد الجدول التالي الأحجام العادية لإعلانات البانر.

الحجم بوحدات بكسل مستقلة الكثافة (عرض × ارتفاع) الوصف مدى التوفّر ثابت حجم الإعلان
320 × 50 بانر عادي الهواتف والأجهزة اللوحية BANNER
320×100 بانر كبير الهواتف والأجهزة اللوحية LARGE_BANNER
300 × 250 مستطيل متوسط IAB الهواتف والأجهزة اللوحية MEDIUM_RECTANGLE
468×60 إعلان بانر بالحجم الكامل لمكتب الإعلانات التفاعلية (IAB) الأجهزة اللوحية FULL_BANNER
728×90 قائمة الإعلانات المتصدِّرة من مكتب الإعلانات التفاعلية (IAB) الأجهزة اللوحية LEADERBOARD
العرض المقدم × الارتفاع التكيُّفي بانر تكيُّفي الهواتف والأجهزة اللوحية لا ينطبق
عرض الشاشة × 32|50|90 بانر ذكي الهواتف والأجهزة اللوحية SMART_BANNER
تعرَّف على مزيد من المعلومات عن إعلانات البانر التكيُّفية التي تهدف إلى استبدال إعلانات البانر الذكية.

مصادر إضافية