Inizia
Gli annunci in overlay nativi vengono presentati agli utenti tramite componenti dell'interfaccia utente che sono nativi alla piattaforma. Questi annunci vengono presentati come overlay sulla parte superiore un'applicazione. Si tratta di un funzionamento simile a quello degli annunci banner, ma con la possibilità di personalizzare l'aspetto degli annunci.
Gli annunci in overlay nativi supportano la mediazione e gli annunci video. Si tratta di un vantaggio fondamentale Gli annunci nativi in overlay contengono più di annunci nativi.
Questa guida illustra come implementare gli annunci in overlay nativi in un'app Unity, nonché alcuni aspetti importanti da considerare durante il processo.
Prerequisiti
- Completa la Guida introduttiva.
- Plug-in Unity 9.0.0 o successivo.
Effettua sempre test con annunci di prova
Il seguente codice di esempio contiene un ID unità pubblicitaria che puoi utilizzare per richiedere annunci di prova. È stato appositamente configurato per restituire annunci di prova anziché annunci di produzione per ogni richiesta, quindi è possibile usarla in sicurezza.
Tuttavia, dopo aver registrato un'app nella nell'interfaccia web di AdMob e creato la tua unità pubblicitaria ID da utilizzare nella tua app, configura il dispositivo come prova in modo esplicito dispositivo durante sviluppo del prodotto.
Android
ca-app-pub-3940256099942544/2247696110
iOS
ca-app-pub-3940256099942544/3986624511
Carica l'annuncio in overlay nativo
Il caricamento di un annuncio in overlay nativo viene eseguito utilizzando il metodo Load()
statico su
la classe NativeOverlayAd
. L'oggetto NativeOverlayAd
caricato viene fornito come
parametro nel gestore del completamento.
Il seguente codice utilizza NativeOverlayAd
per caricare un annuncio:
// 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);
});
}
Visualizza e personalizza l'annuncio in overlay nativo
Gli annunci nativi in overlay vengono visualizzati utilizzando un NativeTemplateStyle
. Questo corso
definisce i campi che ti consentono di personalizzare l'aspetto dell'annuncio.
TemplateID
è una stringa obbligatoria che definisce il modello nativo utilizzato
per il rendering dell'annuncio in overlay nativo. Usa la costante NativeTemplateID
per scegliere una
modello nativo appropriato per il tuo annuncio.
Il seguente codice esegue il rendering dell'annuncio in overlay nativo con un modello medio e una uno stile personalizzato.
/// <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);
}
}
Mostrare e nascondere l'annuncio in overlay nativo
Il seguente codice illustra come mostrare un annuncio in overlay nativo caricato.
/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Showing Native Overlay ad.");
_nativeOverlayAd.Show();
}
}
Nascondi l'annuncio in overlay nativo
Il seguente codice mostra come nascondere un annuncio in overlay nativo.
/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Hiding Native Overlay ad.");
_nativeOverlayAd.Hide();
}
}
Elimina l'annuncio in overlay nativo
Quando hai finito di utilizzare l'annuncio in overlay nativo, assicurati di chiamare Destroy()
per
di svincolare le risorse.
/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Destroying native overlay ad.");
_nativeOverlayAd.Destroy();
_nativeOverlayAd = null;
}
}
Passaggi successivi
- Scopri di più sugli annunci nativi nella nostra guida pratica sugli annunci nativi.
- Consulta le norme e linee guida sugli annunci nativi.