Natywne nakładki reklamowe

Rozpocznij

Natywne nakładki reklamowe wyświetlają się użytkownikom w natywnych komponentach interfejsu związanych z platformą. Reklamy te są wyświetlane jako nakładka na górze aplikacji. Funkcja ta działa podobnie do banerów reklamowych, dostosować wygląd reklam.

Natywne nakładki reklamowe obsługują zapośredniczenie i reklamy wideo. Jest to główna zaleta reklam natywnych z nakładką w porównaniu z reklamami natywnymi.

Z tego przewodnika dowiesz się, jak wdrożyć natywne nakładki reklamowe w aplikacji Unity wartą uwagi.

Wymagania wstępne

Zawsze korzystaj z reklam testowych

Ten przykładowy kod zawiera identyfikator jednostki reklamowej, którego możesz użyć do przesłania żądania reklam testowych. Został on skonfigurowany tak, aby wyświetlać reklamy testowe, a nie aby tworzyć bezpieczne reklamy dla każdego żądania.

Jeśli jednak zarejestrujesz aplikację w Interfejs internetowy Ad Managera i utworzona własną jednostkę reklamową Identyfikatory do wykorzystania w aplikacji; jawnie skonfiguruj urządzenie jako testowe urządzenia w trakcie w Google Cloud.

/21775744923/example/native

Wczytaj natywną nakładkę reklamową

Wczytywanie natywnej nakładki reklamowej odbywa się przy użyciu metody statycznej Load() klasy NativeOverlayAd. Wczytany obiekt NativeOverlayAd jest przesyłany jako w module obsługi uzupełniania.

Ten kod do wczytywania reklamy używa parametru NativeOverlayAd:




// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/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);
    });
}

Renderowanie i określanie stylu natywnej nakładki reklamowej

Reklamy natywne nakładki są renderowane za pomocą NativeTemplateStyle. Ta klasa definiuje pola, które umożliwiają dostosowanie wyglądu reklamy.

TemplateID to wymagany ciąg znaków, który określa szablon natywny używany do wyrenderować natywną nakładkę reklamową. Użyj stałej NativeTemplateID, aby wybrać odpowiedni szablon natywny do reklamy.

Poniższy kod renderuje reklamę natywną z nakładką za pomocą szablonu średniego i niestandardowego stylu.

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

Wyświetlanie i ukrywanie natywnej nakładki reklamowej

Ten kod ilustruje sposób wyświetlania wczytanej natywnej nakładki reklamowej.

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

Ukryj natywną nakładkę reklamową

Ten kod pokazuje, jak ukryć natywną nakładkę reklamową.

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

Usuwanie nakładki reklamy natywnej

Gdy skończysz korzystać z natywnej nakładki reklamowej, wywołaj Destroy() w celu i uwolnij zasoby.

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