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

پلاتفرم را انتخاب کنید: Android iOS Unity Flutter Android (Legacy)

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

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

پیش‌نیازها

پیش‌از ادامه دادن، Google Mobile Ads Unity Plugin را راه‌اندازی کنید.

همیشه با آگهی‌های آزمایشی آزمایش کنید

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

مقداردهی اولیه Google Mobile Ads Unity Plugin

قبل‌از بار کردن آگهی‌ها، با فراخوانی MobileAds.Initialize()، برنامه خود را مقداردهی اولیه Google Mobile Ads Unity Plugin کنید. این کار فقط یک‌بار باید انجام شود، ترجیحاً هنگام راه‌اندازی برنامه.

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 the banner view

برای ازبین بردن برنما، روش Destroy() را برای آزاد کردن منابع فراخوانی کنید:

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

برای برنماهایی که بار نمی‌شوند، توصیه می‌کنیم به‌جای ازبین بردن و ایجاد برنمای جدید، برنما را بازآوری کنید. برای جزئیات، به بازآوری آگهی مراجعه کنید.

بازآوری آگهی

اگر واحد آگهی‌تان را برای بازآوری پیکربندی کرده‌اید، وقتی آگهی بار نمی‌شود، لازم نیست آگهی دیگری درخواست کنید. Google Mobile Ads Unity Plugin به هر نرخ بازآوری که در AdMob UI مشخص کرده‌اید احترام می‌گذارد. اگر بازآوری را فعال نکرده‌اید، درخواست جدیدی صادر کنید. برای جزئیات بیشتر درباره بازآوری واحد آگهی، مانند تنظیم نرخ بازآوری، به استفاده از بازآوری خودکار برای آگهی‌های برنما مراجعه کنید.

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

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

اندازه به دی‌پی (عرض×ارتفاع) شرح دردسترس بودن ثابت AdSize
۳۲۰×۵۰ برنمای استاندارد تلفن‌ها و رایانه‌های لوحی BANNER
۳۲۰×۱۰۰ برنمای بزرگ تلفن‌ها و رایانه‌های لوحی LARGE_BANNER
۳۰۰×۲۵۰ مستطیل متوسط IAB تلفن‌ها و رایانه‌های لوحی MEDIUM_RECTANGLE
۴۶۸×۶۰ برنمای اندازه کامل IAB رایانه لوحی FULL_BANNER
۷۲۸×۹۰ آگهی نواری IAB رایانه لوحی LEADERBOARD
عرض ارائه‌شده × ارتفاع تطبیقی برنمای تطبیقی تلفن‌ها و رایانه‌های لوحی موجود نیست
عرض صفحه × ۳۲|۵۰|۹۰ برنمای هوشمند تلفن‌ها و رایانه‌های لوحی SMART_BANNER
درباره برنماهای تطبیقی که قرار است جایگزین برنماهای هوشمند شوند بیشتر بدانید.

منابع بیشتر