تبلیغات بنری

بنرهای نمایشی، تبلیغات تصویری یا متنی مستطیلی شکلی هستند که قسمتی از صفحه را اشغال می‌کنند. این بنرها در حین تعامل کاربران با برنامه، روی صفحه باقی می‌مانند و می‌توانند پس از مدت زمان مشخصی به طور خودکار به‌روزرسانی شوند. اگر در تبلیغات موبایلی تازه‌کار هستید، این بنرها نقطه شروع بسیار خوبی هستند. مطالعه موردی .

این راهنما به شما نشان می‌دهد که چگونه نماهای بنر را در یک برنامه Unity ادغام کنید. علاوه بر قطعه کدها و دستورالعمل‌ها، شامل اطلاعاتی در مورد اندازه‌بندی صحیح بنرها و پیوند به منابع اضافی نیز می‌شود.

پیش‌نیازها

• راهنمای شروع به کار را تکمیل کنید.

همیشه با تبلیغات آزمایشی تست کنید

کد نمونه زیر شامل یک شناسه واحد تبلیغاتی است که می‌توانید از آن برای درخواست تبلیغات آزمایشی استفاده کنید. این کد به طور ویژه طوری پیکربندی شده است که به جای تبلیغات اصلی، تبلیغات آزمایشی را برای هر درخواست برگرداند، که استفاده از آن را ایمن می‌کند.

با این حال، پس از اینکه یک برنامه را در رابط وب AdMob ثبت کردید و شناسه‌های واحد تبلیغاتی خود را برای استفاده در برنامه خود ایجاد کردید، صریحاً دستگاه خود را در طول توسعه به عنوان یک دستگاه آزمایشی پیکربندی کنید .

مقداردهی اولیه SDK تبلیغات موبایل

قبل از بارگذاری تبلیغات، برنامه خود را وادار کنید تا SDK تبلیغات موبایلی گوگل را با فراخوانی MobileAds.Initialize() مقداردهی اولیه کند. این کار فقط یک بار، در حالت ایده‌آل هنگام اجرای برنامه، باید انجام شود.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads SDK.
        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

برای بنرهایی که بارگذاری نمی‌شوند، توصیه می‌کنیم به جای از بین بردن و ایجاد یک بنر جدید، آن را به‌روزرسانی کنید. برای جزئیات بیشتر، به «به‌روزرسانی یک تبلیغ» مراجعه کنید.

تازه کردن یک آگهی

اگر واحد تبلیغاتی خود را برای به‌روزرسانی پیکربندی کرده‌اید، در صورت عدم بارگذاری تبلیغ، نیازی به درخواست تبلیغ دیگری ندارید. SDK تبلیغات موبایل گوگل هر نرخ به‌روزرسانی را که در رابط کاربری AdMob مشخص کرده‌اید، در نظر می‌گیرد. اگر به‌روزرسانی را فعال نکرده‌اید، یک درخواست جدید ارسال کنید. برای جزئیات بیشتر در مورد به‌روزرسانی واحد تبلیغاتی، مانند تنظیم نرخ به‌روزرسانی، به بخش «استفاده از به‌روزرسانی خودکار برای تبلیغات بنری» مراجعه کنید.

اندازه بنرها

جدول زیر اندازه‌های استاندارد بنر را نشان می‌دهد:

منابع اضافی

• مثال HelloWorld : پیاده‌سازی مینیمال از تمام قالب‌های تبلیغاتی.

• نمونه مورد استفاده