Primeiros passos
Os anúncios de sobreposição nativos são apresentados aos usuários por componentes de IU que são nativos à plataforma. Eles são apresentados como uma sobreposição para o aplicativo. Semelhante a como os anúncios de banner funcionam, mas com a capacidade de personalizar a aparência dos anúncios.
Os anúncios overlay nativos são compatíveis com mediação e anúncios em vídeo. Essa é uma grande vantagem os anúncios overlay nativo têm mais de anúncios nativos.
Este guia mostra como implementar anúncios de sobreposição nativos em um app Unity, bem como como algumas coisas importantes a serem consideradas ao longo do caminho.
Pré-requisitos
- Leia o Guia explicativo.
- Plug-in do Unity 9.0.0 ou mais recente.
Sempre faça testes com anúncios de teste
O exemplo de código a seguir contém um ID de bloco de anúncios, que você pode usar para solicitar anúncios de teste. Ele foi configurado especialmente para retornar anúncios de teste em vez anúncios de produção para todas as solicitações, o que torna o uso seguro.
No entanto, depois de registrar um aplicativo no na interface da Web do Ad Manager e criou seu próprio bloco de anúncios para uso no app, configure o dispositivo como um teste de forma explícita. dispositivo durante no desenvolvimento de software.
/21775744923/example/native
Carregar o anúncio de sobreposição nativo
É possível carregar um anúncio de sobreposição nativo usando o método estático Load()
a classe NativeOverlayAd
. O objeto NativeOverlayAd
carregado é fornecido como
um parâmetro no gerenciador de conclusão.
O código a seguir usa NativeOverlayAd
para carregar um anúncio:
// 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);
});
}
Renderizar e estilizar o anúncio de sobreposição nativo
Os anúncios de sobreposição nativos são renderizados usando um NativeTemplateStyle
. Esta turma
define os campos que permitem personalizar a aparência do anúncio.
TemplateID
é uma string obrigatória que define o modelo nativo usado para
renderizar o anúncio de sobreposição nativo. Use a constante NativeTemplateID
para escolher uma
o modelo nativo apropriado para o anúncio.
O código a seguir renderiza o anúncio nativo de sobreposição com um modelo médio e uma 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);
}
}
Mostrar e ocultar o anúncio de sobreposição nativo
O código a seguir demonstra como mostrar um anúncio de sobreposição nativo carregado.
/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Showing Native Overlay ad.");
_nativeOverlayAd.Show();
}
}
Ocultar o anúncio nativo overlay
O código a seguir demonstra como ocultar um anúncio de sobreposição nativo.
/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Hiding Native Overlay ad.");
_nativeOverlayAd.Hide();
}
}
Destruir o anúncio de sobreposição nativo
Ao terminar de usar o anúncio de sobreposição nativo, chame 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;
}
}