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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (الإصدار القديم)

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

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

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

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

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

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

إعداد 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);

استبدِل 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);

يتم وضع الزاوية العلوية اليمنى لعرض البانر عند قيمتَي 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);

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

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

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

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

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

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.
};

محو عرض البانر

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

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

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

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

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

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

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

الحجم بوحدات dp (العرض × الارتفاع) الوصف مدى التوفّر ثابت AdSize
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
مزيد من المعلومات عن إعلانات البانر التكيّفية، المصمّمة لتحلّ محلّ إعلانات البانر الذكية

مراجع إضافية