Annunci banner

Le visualizzazioni dei banner sono annunci di testo o illustrati 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, questo è 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 su come ridimensionare correttamente i banner e link a risorse aggiuntive.

Prerequisiti

Esegui sempre test con annunci di prova

Il codice di esempio riportato di seguito contiene un ID unità pubblicitaria da utilizzare per richiedere annunci di prova. È stato appositamente configurato per restituire annunci di prova anziché annunci di produzione per ogni richiesta, rendendone l'utilizzo sicuro.

Tuttavia, dopo aver registrato un'app nell'AdMob interfaccia web e creato i tuoi ID unità pubblicitaria da utilizzare nell'app, configura esplicitamente il dispositivo come dispositivo di prova durante lo sviluppo.

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

Inizializza l'SDK Google Mobile Ads

Prima di caricare gli annunci, chiedi all'app di inizializzare l'SDK Mobile Ads chiamando il numero 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 che si verifichi il callback prima di caricare gli annunci, in modo da garantire che tutti gli adattatori di mediazione siano inizializzati.

Esempio di BannerView

Il codice di esempio riportato di seguito spiega 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 le sue funzionalità 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# associato 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 BannerView ha i seguenti parametri:

  • adUnitId: l'ID unità pubblicitaria da cui BannerView deve caricare gli annunci.
  • AdSize: la dimensione dell'annuncio da utilizzare. Per ulteriori dettagli, consulta Dimensioni dei banner.
  • AdPosition: la posizione in cui devono essere posizionate le visualizzazioni del banner. L'enumerazione AdPosition elenca i valori di posizione dell'annuncio validi.

Nota come vengono utilizzate 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 ottenere un maggiore controllo sulla posizione di BannerView sullo schermo rispetto ai valori offerti dai valori AdPosition, utilizza come parametri il costruttore con le coordinate x e y:

// 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 è posizionato in corrispondenza dei valori x e y passati al costruttore, dove l'origine è la parte superiore sinistra dello schermo.

(Facoltativo) Creare una visualizzazione banner con dimensioni personalizzate

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);

Carica un annuncio banner

Per caricare un annuncio, crea un elemento AdRequest e trasmettilo 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);
}

Ascoltare gli eventi di visualizzazione del banner

Per personalizzare il comportamento dell'annuncio, puoi agganciarti 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.");
    };
}

Elimina la visualizzazione del banner

Quando hai finito di utilizzare la visualizzazione banner, assicurati di chiamare Destroy() per rilasciare le risorse.

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

È tutto. La tua app è ora pronta per la pubblicazione degli annunci banner.

La tabella riportata di seguito elenca le dimensioni standard dei banner.

Dimensioni in dp (LxA) Descrizione Disponibilità costante AdSize
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 IAB a grandezza originale Tablet FULL_BANNER
728 x 90 Classifica IAB Tablet LEADERBOARD
Larghezza fornita x Altezza adattiva Banner adattivo Telefoni e tablet N/D
Larghezza schermo x 32|50|90 Banner intelligente Telefoni e tablet SMART_BANNER
Scopri di più sui banner adattivi destinati a sostituire i banner intelligenti.

Risorse aggiuntive