Le visualizzazioni banner sono annunci di testo o illustrati rettangolari che occupano uno spazio sullo schermo. Rimangono sullo schermo durante l'interazione degli utenti con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato un dispositivo mobile pubblicità, sono un ottimo punto di partenza. Case study.
Questa guida illustra come integrare le visualizzazioni banner in un'app Unity. Inoltre, agli snippet di codice e alle istruzioni, include anche informazioni sulle dimensioni correttamente i banner e rimandano a risorse aggiuntive.
Prerequisiti
- Completa la Guida introduttiva.
Esegui 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 nell'interfaccia web di AdMob e aver creato i tuoi ID unità pubblicitarie da utilizzare nell'app, configura esplicitamente il dispositivo come dispositivo di test durante lo sviluppo.
Android
ca-app-pub-3940256099942544/6300978111
iOS
ca-app-pub-3940256099942544/2934735716
Inizializzare l'SDK Mobile Ads
Prima di caricare gli annunci, chiedi all'app di inizializzare l'SDK Mobile Ads chiamando
MobileAds.Initialize()
. Questa operazione deve essere eseguita una sola volta, idealmente al momento del lancio dell'app.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
Se utilizzi la mediazione, attendi il callback prima di caricare gli annunci, in quanto questo garantirà l'inizializzazione di tutti gli adattatori di mediazione.
Esempio di BannerView
Il codice di esempio riportato di seguito illustra come utilizzare la visualizzazione del banner. In questo esempio,
per creare un'istanza di una visualizzazione banner, utilizza
AdRequest
per caricare un annuncio nella visualizzazione banner e
e poi estenderne le capacità gestendo gli eventi del ciclo di vita.
Creare una visualizzazione banner
Il primo passaggio per utilizzare una visualizzazione banner consiste nel creare un'istanza di una visualizzazione banner
in uno script C# allegato a un GameObject
.
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
private string _adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
private string _adUnitId = "unused";
#endif
BannerView _bannerView;
/// <summary>
/// Creates a 320x50 banner view at top of the screen.
/// </summary>
public void CreateBannerView()
{
Debug.Log("Creating banner view");
// If we already have a banner, destroy the old one.
if (_bannerView != null)
{
DestroyAd();
}
// Create a 320x50 banner at top of the screen
_bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
}
Il costruttore di un BannerView
ha quanto segue
parametri:
adUnitId
: l'ID unità pubblicitaria da cuiBannerView
dovrebbe caricare gli annunci.AdSize
: la dimensione dell'annuncio che vuoi utilizzare. Consulta Dimensioni banner per maggiori dettagli.AdPosition
: la posizione in cui devono essere inserite le visualizzazioni del banner. La L'enumAdPosition
elenca i valori di posizione dell'annuncio validi.
Tieni presente come vengono utilizzate unità pubblicitarie diverse, a seconda della piattaforma. Devi utilizzare un'unità pubblicitaria iOS per le richieste di annunci su iOS e un'unità pubblicitaria Android per effettuare richieste su Android.
(Facoltativo) Creare una visualizzazione banner con una posizione personalizzata
Per un maggiore controllo sulla posizione di un BannerView
posizionate sullo schermo rispetto ai valori di AdPosition
, usa il costruttore
che ha le coordinate x e y come parametri:
// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);
L'angolo in alto a sinistra di BannerView
è
ai valori x e y passati al costruttore, dove l'origine è
in alto a sinistra dello schermo.
(Facoltativo) Creare una visualizzazione banner con dimensioni personalizzate
Oltre a utilizzare una costante AdSize
, puoi anche specificare una dimensione personalizzata
per il tuo annuncio:
// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);
Carica un annuncio banner
Per caricare un annuncio, crea un AdRequest
e passalo al metodo LoadAd()
.
/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
// create an instance of a banner view first.
if(_bannerView == null)
{
CreateBannerView();
}
// create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
Debug.Log("Loading banner ad.");
_bannerView.LoadAd(adRequest);
}
Ascolta gli eventi di visualizzazione banner
Per personalizzare il comportamento dell'annuncio, puoi collegarti a una serie di eventi nel ciclo di vita dell'annuncio, come il caricamento, l'apertura o la chiusura. Per ascoltare questi eventi, registra un delegato:
/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
// Raised when an ad is loaded into the banner view.
_bannerView.OnBannerAdLoaded += () =>
{
Debug.Log("Banner view loaded an ad with response : "
+ _bannerView.GetResponseInfo());
};
// Raised when an ad fails to load into the banner view.
_bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
Debug.LogError("Banner view failed to load an ad with error : "
+ error);
};
// Raised when the ad is estimated to have earned money.
_bannerView.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Banner view paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
_bannerView.OnAdImpressionRecorded += () =>
{
Debug.Log("Banner view recorded an impression.");
};
// Raised when a click is recorded for an ad.
_bannerView.OnAdClicked += () =>
{
Debug.Log("Banner view was clicked.");
};
// Raised when an ad opened full screen content.
_bannerView.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Banner view full screen content opened.");
};
// Raised when the ad closed full screen content.
_bannerView.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Banner view full screen content closed.");
};
}
Eliminare la visualizzazione banner
Quando hai finito di utilizzare la visualizzazione banner, assicurati di chiamare Destroy()
per rilasciare
Google Cloud.
/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
if (_bannerView != null)
{
Debug.Log("Destroying banner view.");
_bannerView.Destroy();
_bannerView = null;
}
}
È tutto. L'app è ora pronta per mostrare annunci banner.
Dimensioni dei banner
La tabella seguente elenca le dimensioni standard dei banner.
Dimensioni in dp (LxH) | Descrizione | Disponibilità | Costante AdSize |
---|---|---|---|
320 x 50 | Banner standard | Cellulari e tablet | BANNER |
320 x 100 | Banner grande | Cellulari e tablet | LARGE_BANNER |
300 x 250 | Rettangolo medio IAB | Cellulari e tablet | MEDIUM_RECTANGLE |
468 x 60 | Banner a dimensione intera IAB | Tablet | FULL_BANNER |
728 x 90 | Classifica IAB | Tablet | LEADERBOARD |
Larghezza fornita x Altezza adattiva | Banner adattivo | Cellulari e tablet | N/D |
Larghezza schermo x 32|50|90 | Banner intelligente | Cellulari e tablet | SMART_BANNER |
Scopri di più sui banner adattivi. pensato per sostituire i banner intelligenti. |
Risorse aggiuntive
- Esempio di HelloWorld: Implementazione minima di tutti i formati degli annunci.