Gli annunci banner sono annunci illustrati o di testo rettangolari che occupano uno spazio sullo schermo. Rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, questa è un ottimo punto di partenza. Case study:
Questa guida mostra come integrare gli annunci banner di AdMob in un'app Unity. Oltre agli snippet di codice e alle istruzioni, include anche informazioni sul dimensionamento corretto dei banner e link a risorse aggiuntive.
Prerequisiti
- Completa la Guida introduttiva.
Esegui sempre il test con gli annunci di prova
Il codice campione riportato di seguito 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, per cui è sicuro utilizzarlo.
Tuttavia, dopo aver registrato un'app nell'interfaccia utente di AdMob e aver creato ID di unità pubblicitarie utilizzabili nella tua app, durante la fase di sviluppo dovrai configurare il dispositivo come dispositivo di test in modo esplicito.
Android
ca-app-pub-3940256099942544/6300978111
iOS
ca-app-pub-3940256099942544/2934735716
Initialize the Mobile Ads SDK
Before loading ads, have your app initialize the Mobile Ads SDK by calling
MobileAds.Initialize()
. This needs to be done only once, ideally at app launch.
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.
});
}
}
If you're using mediation, wait until the callback occurs before loading ads as this will ensure that all mediation adapters are initialized.
Esempio di bannerView
Il codice campione riportato di seguito illustra come utilizzare la visualizzazione banner. Nell'esempio, crei un'istanza di una visualizzazione banner, utilizzi un AdRequest
per caricare un annuncio nella visualizzazione banner e poi estendi la funzionalità gestendo gli eventi del ciclo di vita.
Creare una visualizzazione banner
Il primo passaggio nell'utilizzo di una visualizzazione banner è creare un'istanza di una visualizzazione banner in uno script C# allegato a un elemento 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 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 per BannerView
ha i seguenti parametri:
adUnitId
: l'ID unità pubblicitaria di AdMob da cuiBannerView
deve caricare gli annunci.AdSize
: la dimensione dell'annuncio AdMob che vuoi utilizzare (per maggiori dettagli, consulta le dimensioni del banner).AdPosition
: la posizione in cui deve essere posizionato l'annuncio banner. L'enumerazioneAdPosition
elenca i valori validi della posizione dell'annuncio.
Nota come vengono utilizzate le diverse unità pubblicitarie, a seconda della piattaforma. Devi utilizzare un'unità pubblicitaria per iOS per effettuare richieste di annunci su iOS e un'unità pubblicitaria Android per inviare richieste su Android.
(Facoltativo) Creare una visualizzazione banner con una posizione personalizzata
Per un maggiore controllo sulla posizione dello schermo (BannerView
) rispetto a quanto offerto dai valori AdPosition
, utilizza BannerViewconstructor
che ha le coordinate x e y come parametri:
// Create a 320x50 banner ad at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);
L'angolo in alto a sinistra di BannerView
è posizionato ai valori x e y passati al costruttore, dove l'origine è la parte superiore sinistra dello schermo.
(Facoltativo) Creare una visualizzazione banner con una dimensione personalizzata
Oltre a utilizzare una costante AdSize
, puoi specificare anche 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);
Caricare un annuncio banner
Il secondo passaggio nell'utilizzo della visualizzazione banner consiste nel creare un elemento AdRequest
e passarlo
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();
adRequest.Keywords.Add("unity-admob-sample");
// 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: caricamento, apertura, chiusura e così via. Per ascoltare questi eventi, registra un delegato:
/// <summary>
/// listen to events the banner 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.");
};
}
Elimina la visualizzazione del banner
Quando hai terminato di utilizzare la visualizzazione banner, assicurati di chiamare Destroy()
per liberare risorse.
/// <summary>
/// Destroys the ad.
/// </summary>
public void DestroyAd()
{
if (_bannerView != null)
{
Debug.Log("Destroying banner ad.");
_bannerView.Destroy();
_bannerView = null;
}
}
È tutto. La tua app è ora pronta per mostrare annunci banner di AdMob.
Dimensioni dei banner
La tabella riportata di seguito elenca le dimensioni standard dei banner.
Dimensioni in dp (LxA) | Descrizione | Disponibilità | costante di dimensioni annuncio |
---|---|---|---|
320 x 50 | Banner standard | Telefoni e tablet | BANNER |
320 x 100 | Banner grande | Telefoni e tablet | LARGE_BANNER |
300 x 250 | Rettangolo medio IAB | Telefoni e tablet | MEDIUM_RECTANGLE |
468 x 60 | Banner a grandezza originale IAB | Tablet | FULL_BANNER |
728 x 90 | Classifica IAB | Tablet | LEADERBOARD |
Larghezza specificata x Altezza adattiva | Banner adattivo | Telefoni e tablet | N/A |
Larghezza schermo x 32|50|90 | Banner intelligente | Telefoni e tablet | SMART_BANNER |
Scopri di più sui banner adattivi, pensati per sostituire i banner intelligenti. |
Risorse aggiuntive
Esempi
- Esempio per HelloWorld: un'implementazione minima di tutti i formati degli annunci.