تبلیغات همپوشانی بومی

پلتفرم مورد نظر: اندروید، اندروید (بتا)، iOS، فلاتر، یونیتی

شروع کنید

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

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

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

پیش‌نیازها

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

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

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

اندروید

ca-app-pub-3940256099942544/2247696110

آی‌او‌اس

ca-app-pub-3940256099942544/3986624511

تبلیغ پوششی بومی را بارگذاری کنید

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

کد زیر از 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;
    }
}

مراحل بعدی