Annunci banner

Le visualizzazioni banner sono annunci illustrati o di testo 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 la pubblicità mobile, sono un ottimo punto di partenza. Case study.

Questa guida mostra come integrare le visualizzazioni dei banner in un'app Unity. Oltre a snippet di codice e istruzioni, include anche informazioni sul dimensionamento corretto dei banner e link a risorse aggiuntive.

Prerequisiti

• Completa la Guida introduttiva.

Esegui sempre i test con gli annunci di prova

Il seguente codice di esempio contiene un ID unità pubblicitaria che puoi utilizzare per richiedere annunci di test. È stato configurato appositamente per restituire annunci di test anziché annunci di produzione per ogni richiesta, rendendolo sicuro da usare.

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 tuo dispositivo come dispositivo di test durante lo sviluppo.

Inizializza l'SDK Mobile Ads

Prima di caricare gli annunci, fai in modo che la tua app inizializzi l'SDK Mobile Ads chiamando MobileAds.Initialize(). Questa operazione deve essere eseguita una sola volta, idealmente all'avvio 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 in questo modo ti assicurerai che tutti gli adattatori di mediazione vengano inizializzati.

Esempio di BannerView

Il codice campione riportato di seguito illustra in dettaglio come utilizzare la visualizzazione del banner. Nell'esempio, crei un'istanza di una visualizzazione banner, utilizzi un AdRequest per caricare un annuncio nella visualizzazione banner e poi estendi le sue funzionalità gestendo gli eventi del ciclo di vita.

Creare una visualizzazione banner

Il primo passaggio per utilizzare una visualizzazione banner è creare un'istanza di una visualizzazione banner in uno script C# collegato 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 per un BannerView ha i seguenti parametri:

• adUnitId: l'ID unità pubblicitaria da cui BannerView deve caricare gli annunci.
• AdSize: Le dimensioni dell'annuncio che vuoi utilizzare. Per maggiori dettagli, consulta Dimensioni dei banner.
• AdPosition: La posizione in cui devono essere inserite le visualizzazioni del banner. L'enumerazione AdPosition elenca i valori validi della posizione dell'annuncio.

Tieni presente come vengono utilizzate le diverse unità pubblicitarie, a seconda della piattaforma. Devi utilizzare un'unità pubblicitaria iOS per effettuare 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 sul posizionamento di un BannerView sullo schermo rispetto a quanto offerto dai valori AdPosition, utilizza 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 si trova in corrispondenza dei valori x e y passati al costruttore, dove l'origine è l'angolo in alto a sinistra dello schermo.

(Facoltativo) Creare una visualizzazione banner con una dimensione personalizzata

Oltre a utilizzare una costante AdSize, puoi anche specificare una dimensione personalizzata per l'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

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 dei banner

Per personalizzare il comportamento dell'annuncio, puoi collegarti a una serie di eventi nel ciclo di vita dell'annuncio, ad esempio caricamento, apertura o 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.");
    };
}

Elimina la visualizzazione del banner

Al termine dell'utilizzo della visualizzazione del banner, assicurati di chiamare Destroy() per rilasciare le risorse.

/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner view.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

È tutto. La tua app è ora pronta per mostrare annunci banner.

Aggiornare un annuncio

Se hai configurato l'unità pubblicitaria in modo che venga aggiornata, non devi richiedere un altro annuncio quando il caricamento dell'annuncio non va a buon fine. L'SDK Google Mobile Ads rispetta qualsiasi frequenza di aggiornamento che hai specificato nell'interfaccia utente AdMob. Se non hai attivato l'aggiornamento, invia una nuova richiesta. Per ulteriori dettagli sull'aggiornamento delle unità pubblicitarie, ad esempio l'impostazione di una frequenza di aggiornamento, consulta Utilizzare l'aggiornamento automatico per gli annunci banner.

Dimensioni dei banner

La tabella seguente elenca le dimensioni standard dei banner.

Risorse aggiuntive

• Esempio HelloWorld: Un'implementazione minima di tutti i formati degli annunci.

• Caso d'uso di esempio