Configurare gli annunci banner

Seleziona la piattaforma: Android (beta) Android iOS Unity Flutter

Le visualizzazioni banner sono annunci rettangolari con immagini o testo che occupano uno spazio sullo schermo. Rimangono sullo schermo durante l'interazione degli utenti con l'app e possono essere aggiornate 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 banner in un'app Unity. Oltre a snippet di codice e istruzioni, include anche informazioni sul ridimensionamento corretto dei banner e link a risorse aggiuntive.

Prerequisiti

Prima di continuare, configura Google Mobile Ads Unity Plugin.

Esegui sempre i test con gli annunci di prova

Il seguente codice campione contiene un ID unità pubblicitaria che puoi utilizzare per richiedere annunci di prova. È stato configurato appositamente per restituire annunci di prova anziché annunci di produzione per ogni richiesta, il che lo rende sicuro da utilizzare.

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

Inizializza Google Mobile Ads Unity Plugin

Prima di caricare gli annunci, fai in modo che l'app inizializzi Google Mobile Ads Unity Plugin 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 Google Mobile Ads Unity Plugin.
        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 assicurarti che tutti gli adattatori di mediazione siano inizializzati.

Esempio di BannerView

Il seguente codice campione descrive in dettaglio come utilizzare la visualizzazione banner. Nell'esempio, crea un'istanza di una visualizzazione banner, utilizza un AdRequest per caricare un annuncio nella visualizzazione banner, quindi estendi le sue funzionalità gestendo gli eventi del ciclo di vita.

Crea una visualizzazione banner

Il primo passaggio per utilizzare una visualizzazione banner è creare un'istanza di una visualizzazione banner.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

Sostituisci AD_UNIT_ID con l'ID unità pubblicitaria.

Il costruttore di un BannerView ha i seguenti parametri:

• adUnitId: l'ID unità pubblicitaria dell'annuncio banner da caricare.
• AdSize: la dimensione del banner che vuoi utilizzare.
• AdPosition: la posizione in cui devono essere inserite le visualizzazioni banner.

(Facoltativo) Crea una visualizzazione banner con una posizione personalizzata

Per un maggiore controllo sulla posizione di una visualizzazione banner sullo schermo rispetto ai valori AdPosition, utilizza il costruttore con coordinate x e y come parametri:

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

L'angolo in alto a sinistra della visualizzazione banner è posizionato in corrispondenza dei valori x e y passati al costruttore, dove l'origine è l'angolo in alto a sinistra dello schermo.

(Facoltativo) Crea una visualizzazione banner con una dimensione personalizzata

Oltre a utilizzare una costante AdSize, puoi anche specificare una dimensione personalizzata per l'annuncio:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

Carica un annuncio banner

Per caricare un annuncio, crea un AdRequest e passalo al metodo LoadAd().

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

Ascolta gli eventi della 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:

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
BannerViewSnippets.cs

Elimina la visualizzazione banner

Per eliminare il banner, chiama il metodo Destroy() per rilasciare le risorse:

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

Per i banner che non vengono caricati, ti consigliamo di aggiornarli anziché eliminarli e crearne di nuovi. Per maggiori dettagli, consulta Aggiornare un annuncio.

Aggiorna un annuncio

Se hai configurato l'unità pubblicitaria per l'aggiornamento, non devi richiedere un altro annuncio quando il caricamento dell'annuncio non riesce. Google Mobile Ads Unity Plugin rispetta qualsiasi frequenza di aggiornamento specificata nell'interfaccia utente di AdMob. Se non hai attivato l'aggiornamento, invia una nuova richiesta. Per maggiori dettagli sull'aggiornamento delle unità pubblicitarie, ad esempio su ll'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 di Hello World: un'implementazione minima di tutti i formati degli annunci.

• Esempio di caso d'uso