عروض إعلانات البانر هي إعلانات مصوّرة أو نصية مستطيلة تشغل موضعًا على الشاشة. وتظل معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن إعادة تحميلها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت مبتدئًا في مجال استخدام الأجهزة الجوّالة الإعلانية، فهي مكان رائع للبدء. دراسة الحالة:
يوضِّح لك هذا الدليل كيفية دمج طرق عرض إعلانات البانر في تطبيق 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
، استخدم الدالة الإنشائية
التي تحتوي على إحداثيي س وص كمعاملين:
// 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 DestroyAd()
{
if (_bannerView != null)
{
Debug.Log("Destroying banner view.");
_bannerView.Destroy();
_bannerView = null;
}
}
هذا كل شيء! أصبح تطبيقك جاهزًا الآن لعرض إعلانات البانر.
أحجام البانر
يسرد الجدول التالي الأحجام العادية لإعلانات البانر.
الحجم بوحدات بكسل مستقلة الكثافة (عرض × ارتفاع) | الوصف | مدى التوفّر | ثابت حجم الإعلان |
---|---|---|---|
320×50 | بانر عادي | الهواتف والأجهزة اللوحية | BANNER |
100x320 | بانر كبير | الهواتف والأجهزة اللوحية | LARGE_BANNER |
300×250 | مستطيل متوسط وفقًا لمعايير IAB | الهواتف والأجهزة اللوحية | MEDIUM_RECTANGLE |
468×60 | إعلان بانر بالحجم الكامل لمكتب الإعلانات التفاعلية (IAB) | الأجهزة اللوحية | FULL_BANNER |
728×90 | قائمة الإعلانات المتصدِّرة من مكتب الإعلانات التفاعلية (IAB) | الأجهزة اللوحية | LEADERBOARD |
العرض المقدم × الارتفاع التكيُّفي | بانر تكيُّفي | الهواتف والأجهزة اللوحية | لا ينطبق |
عرض الشاشة x 32|50|90 | بانر ذكي | الهواتف والأجهزة اللوحية | SMART_BANNER |
وتعرّف على مزيد من المعلومات حول إعلانات البانر التكيُّفية، أن تحلّ محلّ إعلانات البانر الذكية. |
مراجع إضافية
- مثال على HelloWorld: الحد الأدنى من التنفيذ لكل أشكال الإعلانات: