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

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

شروع کنید

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

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

این راهنما به شما نشان می‌دهد که چگونه آگهی‌های رونهاد بومی را در برنامه Unity پیاده‌سازی کنید، و همچنین برخی نکات مهم را که باید در این مسیر درنظر بگیرید.

پیش‌نیازها

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

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

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

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

بار کردن آگهی رونهاد بومی بااستفاده از روش ثابت Load() در کلاس NativeOverlayAd انجام می‌شود. شیء NativeOverlayAd بارشده به‌عنوان پارامتری در گرداننده تکمیل ارائه می‌شود.

کد زیر از NativeOverlayAd برای بار کردن آگهی استفاده می‌کند:



  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/2247696110";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/3986624511";
#else
  private string _adUnitId = "unused";
#endif


private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

پرداخت و سبک‌دهی آگهی رونهاد بومی

آگهی‌های رونهاد بومی بااستفاده از NativeTemplateStyle ارائه می‌شوند. این کلاس فیلدهایی را تعریف می‌کند که به شما امکان می‌دهد ظاهر آگهی را سفارشی‌سازی کنید.

TemplateID رشته‌ای الزامی است که الگوی بومی مورداستفاده برای رندر کردن آگهی رونهاد بومی را تعریف می‌کند. از ثابت NativeTemplateID برای انتخاب الگوی بومی مناسب برای آگهی‌تان استفاده کنید.

کد زیر آگهی رونهاد بومی را با الگوی متوسط و سبک سفارشی ارائه می‌دهد.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

نمایش و پنهان کردن آگهی رونهاد بومی

کد زیر نحوه نمایش آگهی رونهاد بومی بارشده را نشان می‌دهد.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

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

کد زیر نحوه پنهان کردن آگهی رونهاد بومی را نشان می‌دهد.

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

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

وقتی استفاده از آگهی رونهاد بومی تمام شد، حتماً Destroy() را فراخوانی کنید تا منابع آزاد شود.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}

مراحل بعدی