شروع کنید

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

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

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

پیش نیازها

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

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

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

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

/6499/example/native

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

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

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

// This ad unit is configured to always serve test ads.
private string _adUnitId = "/6499/example/native";



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;
    }
}