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

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

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

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

قبل المتابعة، عليك إعداد Google Mobile Ads Unity Plugin.

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

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

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

إعداد Google Mobile Ads Unity Plugin

قبل تحميل الإعلانات، يجب أن يبدأ تطبيقك Google Mobile Ads Unity Plugin من خلال طلب MobileAds.Initialize(). يجب تنفيذ هذا الإجراء مرة واحدة فقط، ويُفضَّل أن يكون ذلك عند تشغيل التطبيق.

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

إذا كنت تستخدم التوسّط، انتظِر حتى يتم تنفيذ عملية الاستدعاء قبل تحميل الإعلانات، لأنّ ذلك سيضمن إعداد جميع محوّلات التوسّط.

مثال على BannerView

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

إنشاء عرض بانر

الخطوة الأولى لاستخدام عرض إعلان بانر هي إنشاء مثيل لعرض إعلان بانر.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

استبدِل AD_UNIT_ID بمعرّف الوحدة الإعلانية.

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

• ‫adUnitId: معرّف الوحدة الإعلانية لإعلان البانر المطلوب تحميله
• ‫AdSize: حجم البانر الذي تريد استخدامه
• ‫AdPosition: الموضع الذي يجب أن تظهر فيه مشاهدات إعلانات البانر

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

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

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

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

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

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

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

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

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

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

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

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

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
BannerViewSnippets.cs

إلغاء عرض البانر

لإزالة البانر، استخدِم طريقة Destroy() لإخلاء الموارد:

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

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

إعادة تحميل إعلان

إذا ضبطت وحدتك الإعلانية لإعادة التحميل، لن تحتاج إلى طلب إعلان آخر عند تعذُّر تحميل الإعلان. تلتزم Google Mobile Ads Unity Plugin بأي معدّل إعادة تحميل تحدّده في واجهة مستخدم AdMob. إذا لم تكن قد فعّلت إعادة التحميل، يمكنك إرسال طلب جديد. لمزيد من التفاصيل حول إعادة تحميل الوحدات الإعلانية، مثل ضبط معدّل إعادة التحميل، يُرجى الاطّلاع على مقالة ضبط خيار إعادة التحميل التلقائية لإعلانات البانر.

أحجام البانر

توفّر "إعلانات البانر التكيُّفية" الكبيرة شكل إعلان أكبر مصمّمًا للتنسيقات التي لا تتضمّن إمكانية التمرير. مقارنةً بـ "إعلانات البانر التكيُّفية الثابتة" العادية، تتيح هذه الإعلانات حدًا أقصى للارتفاع أكبر (يصل إلى %20 من ارتفاع الشاشة، بين 50 و150 بكسل مستقل الكثافة). تم تحسين هذه المساحة الإضافية لمحتوى الفيديو.

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

موارد إضافية

• مثال HelloWorld: هو تطبيق بسيط لجميع أشكال الإعلانات.

• مثال على حالة استخدام