Comenzar
Los anuncios superpuestos nativos se presentan a los usuarios a través de componentes de la IU nativos. a la plataforma. Estos anuncios se presentan como una superposición sobre el y mantener la integridad de su aplicación. Esto es similar al funcionamiento de los anuncios de banner, pero con la capacidad de personalizar el aspecto de los anuncios.
Los anuncios superpuestos nativos son compatibles con anuncios de video y de mediación. Esta es una ventaja clave los anuncios nativos superpuestos tienen sobre los anuncios nativos.
En esta guía, también se muestra cómo implementar anuncios superpuestos nativos en una app para Unity como algunos aspectos importantes que se deben considerar en el camino.
Requisitos previos
- Completa la Guía de introducción.
- Complemento de Unity 9.0.0 o una versión posterior
Probar siempre con anuncios de prueba
El siguiente código de muestra contiene un ID de unidad de anuncios que puedes usar para solicitar anuncios de prueba. Se configuró de forma especial para mostrar anuncios de prueba en lugar de mostrar anuncios de producción para cada solicitud, por lo que es seguro de usar.
Sin embargo, después de registrar una app en la de Ad Manager y creaste tu propia unidad de anuncios IDs para usar en tu app, configura tu dispositivo como una prueba de manera explícita dispositivo durante en el desarrollo de software.
/21775744923/example/native
Cómo cargar el anuncio nativo superpuesto
La carga de un anuncio superpuesto nativo se realiza con el método estático Load()
.
la clase NativeOverlayAd
. El objeto NativeOverlayAd
cargado se proporciona como
un parámetro en el controlador de finalización.
El siguiente código usa NativeOverlayAd
para cargar un anuncio:
// This ad unit is configured to always serve test ads.
private string _adUnitId = /2"1775744923/example/native;
"
private NativeOverlayAd _nativeOverlayAd;
/// su<mmary
/>// Loads the ad.
/// /s<ummary
p>ublic void LoadAd()
{
// Clean up the old ad before loading a new one.
if (_nativeOverlayAd != null)
{
DestroyAd();
}
Debug.Log(Lo"ading 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(Na"tive Overlay ad failed to load an ad +"
w"ith 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(Un"expected error: Native Overlay ad load event +"
f"ired with null ad and null error.);"
return;
}
// The operation completed successfully.
Debug.Log(Na"tive Overlay ad loaded with response : +"
ad.GetResponseInfo());
_nativeOverlayAd = ad;
// Register to ad events to extend functionality.
RegisterEventHandlers(ad);
});
}
Renderiza el anuncio superpuesto nativo y aplícale un estilo
Los anuncios superpuestos nativos se renderizan con un elemento NativeTemplateStyle
. Esta clase
define campos que te permiten personalizar el aspecto del anuncio.
TemplateID
es una cadena obligatoria que define la plantilla nativa que se usa para lo siguiente:
dibujar el anuncio nativo superpuesto. Usa la constante NativeTemplateID
para elegir un
plantilla nativa apropiada para tu anuncio.
El siguiente código renderiza el anuncio superpuesto nativo con una plantilla mediana y una un estilo personalizado.
/// <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);
}
}
Cómo mostrar y ocultar el anuncio superpuesto nativo
En el siguiente código, se demuestra cómo mostrar un anuncio superpuesto nativo cargado.
/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Showing Native Overlay ad.");
_nativeOverlayAd.Show();
}
}
Ocultar el anuncio nativo superpuesto
En el siguiente código, se muestra cómo ocultar un anuncio superpuesto nativo.
/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Hiding Native Overlay ad.");
_nativeOverlayAd.Hide();
}
}
Destruya el anuncio superpuesto nativo
Cuando termines de usar el anuncio superpuesto nativo, asegúrate de llamar a Destroy()
para
liberar recursos.
/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Destroying native overlay ad.");
_nativeOverlayAd.Destroy();
_nativeOverlayAd = null;
}
}