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

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

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

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

پیش‌نیازها

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

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

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

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

/21775744923/example/interstitial

مقداردهی اولیه 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

کد نمونه زیر جزئیات نحوه استفاده از نمای برنما را نشان می‌دهد. در این مثال، نمونه‌ای از نمای برنما ایجاد کنید، از AdManagerAdRequest برای بار کردن آگهی در نمای برنما استفاده کنید، و سپس قابلیت‌های آن را با مدیریت رویدادهای چرخه حیات گسترش دهید.

ایجاد نمای برنما

اولین گام در استفاده از نمای برنما، ایجاد نمونه‌ای از نمای برنما است.

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
AdManagerBannerViewSnippets.cs

AD_UNIT_ID را با شناسه واحد آگهی‌تان جایگزین کنید.

سازنده AdManagerBannerView پارامترهای زیر را دارد:

• adUnitId: شناسه واحد آگهی آگهی برنمایی که باید بار شود.
• AdSize: اندازه برنما که می‌خواهید استفاده کنید.
• ‫AdPosition: جایگاهی که نماهای برنما باید در آن قرار گیرد.

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

(اختیاری) ایجاد نمای برنما با جایگاه سفارشی

برای کنترل بیشتر بر محل قرارگیری نمای برنما در صفحه نسبت‌به آنچه مقادیر AdPosition ارائه می‌دهند، از سازنده‌ای استفاده کنید که مختصات x و y را به‌عنوان پارامتر دارد:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
AdManagerBannerViewSnippets.cs

گوشه بالا سمت چپ نمای برنما در مقادیر x و y که به سازنده ارسال شده است قرار می‌گیرد، که در آن مبدأ گوشه بالا سمت چپ صفحه است.

(اختیاری) ایجاد نمای برنما با اندازه سفارشی

علاوه‌بر استفاده از ثابت AdSize، می‌توانید اندازه سفارشی هم برای آگهی‌تان مشخص کنید:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
AdManagerBannerViewSnippets.cs

(اختیاری) اندازه‌های آگهی متعدد

Ad Manager به شما امکان می‌دهد چندین اندازه آگهی را که ممکن است برای ارائه در AdManagerBannerView واجدشرایط باشند مشخص کنید. قبل‌از پیاده‌سازی این ویژگی در SDK، یک ردیف هدف‌یابی برای همان واحدهای آگهی مرتبط با طرح‌آگهی‌های با اندازه‌های مختلف ایجاد کنید.

در برنامه‌تان، چند پارامتر AdSize را به ValidAdSizes منتقل کنید:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};
AdManagerBannerViewSnippets.cs

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

بار کردن آگهی برنمایی

پس‌از اینکه AdManagerBannerView در جای خود قرار گرفت، آگهی را با روش LoadAd() در کلاس AdManagerBannerView بار کنید. این روش پارامتر را می‌گیرد که اطلاعات زمان اجرا را نگه می‌دارد، مانند اطلاعات هدف‌یابی، برچسب‌های استثنا، و شناسه ارائه‌شده توسط ناشر.

برای بار کردن آگهی، یک AdManagerAdRequest ایجاد کنید و آن را به روش LoadAd() ارسال کنید.

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());
AdManagerBannerViewSnippets.cs

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

گوش دادن به رویدادهای نمای برنما

برای سفارشی‌سازی رفتار آگهی‌تان، می‌توانید به تعدادی از رویدادها در چرخه حیات آگهی، مانند بارگیری، باز کردن، یا بستن، متصل شوید. برای گوش دادن به این رویدادها، یک نماینده ثبت کنید:

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
AdManagerBannerViewSnippets.cs

Destroy the banner view

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

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

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

بازآوری آگهی

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

توجه: هنگام تنظیم نرخ بازآوری در Ad Manager UI، بازآوری خودکار فقط درصورتی انجام می‌شود که برنما در صفحه نمایان باشد.

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

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

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

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

توجه: اگر برنامه Android سعی کند برنمایی را بار کند که برای چیدمان آن خیلی بزرگ است، کیت توسعه نرم‌افزار آن را نمایش نمی‌دهد و به‌جای آن پیام خطا ثبت می‌کند.

رویدادهای برنامه

رویدادهای برنامه به شما امکان می‌دهد آگهی‌هایی ایجاد کنید که می‌توانند به کد برنامه آن‌ها پیام ارسال کنند. سپس برنامه می‌تواند براساس این پیام‌ها اقدام کند.

می‌توانید بااستفاده از AppEvent به رویدادهای برنامه خاص Ad Manager گوش دهید. این رویدادها می‌توانند در هر زمانی درطول چرخه حیات آگهی رخ دهند، حتی قبل‌از اینکه بارگیری فراخوانی شود.

OnAppEventReceived زمانی مطرح می‌شود که رویداد برنامه در آگهی رخ دهد. در اینجا نمونه‌ای از نحوه مدیریت این رویداد در کد شما آورده شده است:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Data}.");
};
AdManagerBannerViewSnippets.cs

در اینجا مثالی آورده شده است که نشان می‌دهد چگونه رنگ پس‌زمینه برنامه خود را بسته به رویداد برنامه با نام رنگ تغییر دهید:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};
AdManagerBannerViewSnippets.cs

و در اینجا عنصر خلاقانه مربوطه که رویداد برنامه رنگ را ارسال می‌کند آورده شده است:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0;
      left: 0;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>
AppEventSnippets.html

منابع بیشتر

• نمونه HelloWorld: پیاده‌سازی حداقلی همه قالب‌های آگهی.