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

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

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

مراجع إضافية