Native Overlay-Anzeigen

Erste Schritte

Native Overlay-Anzeigen werden Nutzern über native UI-Komponenten präsentiert. auf die Plattform. Diese Anzeigen werden als Overlay . Das funktioniert ähnlich wie bei Banneranzeigen, das Erscheinungsbild der Anzeigen anpassen.

Native Overlay-Anzeigen unterstützen die Vermittlung und Videoanzeigen. Dies ist ein entscheidender Vorteil, native Overlay-Anzeigen mehr als native Anzeigen.

In diesem Leitfaden erfahren Sie, wie Sie native Overlay-Anzeigen einige wichtige Punkte, die Sie dabei berücksichtigen sollten.

Vorbereitung

  • Arbeiten Sie den Startleitfaden durch.
  • Unity-Plug-in 9.0.0 oder höher.

Immer mit Testanzeigen testen

Der folgende Beispielcode enthält eine Anzeigenblock-ID, mit der Sie zu testen. Es wurde speziell so konfiguriert, dass Testanzeigen zurückgegeben werden, Produktionsanzeigen für jede Anfrage erstellen, damit sie sicher verwendet werden können.

Nachdem Sie jedoch eine App in der AdMob-Weboberfläche und Erstellung eines eigenen Anzeigenblocks IDs zur Verwendung in Ihrer App – konfigurieren Sie Ihr Gerät explizit als Test. Gerät während Entwicklung.

Android

ca-app-pub-3940256099942544/2247696110

iOS

ca-app-pub-3940256099942544/3986624511

Native Overlay-Anzeige laden

Native Overlay-Anzeigen werden mit der statischen Load()-Methode geladen die Klasse NativeOverlayAd. Das geladene NativeOverlayAd-Objekt wird als Einen -Parameter im Abschluss-Handler.

Im folgenden Code wird eine Anzeige mit NativeOverlayAd geladen:



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

Native Overlay-Anzeige rendern und gestalten

Native Overlay-Anzeigen werden mithilfe eines NativeTemplateStyle gerendert. Dieser Kurs definiert Felder, mit denen Sie die Darstellung der Anzeige anpassen können.

TemplateID ist ein erforderlicher String, der die native Vorlage definiert, die für die native Overlay-Anzeige rendern. Verwenden Sie die Konstante NativeTemplateID, um eine für Ihre Anzeige aus.

Mit dem folgenden Code wird die native Overlay-Anzeige mit einer mittelgroßen Vorlage und einem benutzerdefinierten Stils.

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

Native Overlay-Anzeige ein- und ausblenden

Im folgenden Code sehen Sie, wie eine geladene native Overlay-Anzeige ausgeliefert wird.

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

Native Overlay-Anzeige ausblenden

Im folgenden Codebeispiel wird gezeigt, wie eine native Overlay-Anzeige ausgeblendet wird.

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

Native Overlay-Anzeige entfernen

Wenn Sie mit der nativen Overlay-Anzeige fertig sind, rufen Sie Destroy() auf, Ressourcen freigeben.

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

Nächste Schritte