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

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

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

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