راه‌اندازی آگهی‌های برنمایی

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

این راهنما نحوه ادغام کردن نمای برنمایی در برنامه 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 مشخص کرده‌اید احترام می‌گذارد. اگر بازآوری را فعال نکرده‌اید، درخواست جدیدی صادر کنید. برای جزئیات بیشتر درباره بازآوری واحد آگهی، مثل تنظیم نرخ بازآوری، به استفاده از بازآوری خودکار برای آگهی‌های «برنمایی» مراجعه کنید.

اندازه‌های برنما

برنماهای تطبیقی بزرگ قالب بزرگ‌تری را ارائه می‌کنند که برای چیدمان‌های بدون پیمایش طراحی شده است. در مقایسه با برنماهای تطبیقی لنگرشده استاندارد، این برنماها اجازه می‌دهند ارتفاع بیشینه بلندتری داشته باشند (تا ۲۰٪ ارتفاع صفحه، بین ۵۰ تا ۱۵۰ نقطه در اینچ). این فضای افزایش‌یافته برای محتوای ویدیویی بهینه‌سازی شده است.

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

منابع بیشتر

• مثال «سلام دنیا»: پیاده‌سازی حداقلی از همه قالب‌های آگهی.

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