Utilizzare i banner comprimibili

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

Gli annunci banner comprimibili sono annunci banner che inizialmente vengono presentati come overlay più grandi, con un pulsante per comprimerli fino alla dimensione del banner richiesta in origine. Gli annunci banner comprimibili hanno lo scopo di migliorare il rendimento degli annunci ancorati che altrimenti sarebbero di dimensioni più ridotte. Questa guida mostra come attivare gli annunci banner comprimibili per i posizionamenti di banner esistenti.

Prerequisiti

• Completa la guida introduttiva agli annunci banner .

Implementazione

Assicurati che la visualizzazione del banner sia definita con le dimensioni che vuoi che gli utenti vedano nello stato standard (compresso) del banner. Includi un parametro extras nella richiesta di annunci con collapsible come chiave e il posizionamento dell'annuncio come valore.

Il posizionamento comprimibile definisce la modalità di ancoraggio della regione espansa all'annuncio banner.

Se l'annuncio caricato è un banner comprimibile, il banner mostra immediatamente l'overlay comprimibile una volta inserito nella gerarchia di oggetti View.

private fun loadBannerAd() {
  // ...

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest bannerAdRequest = new BannerAdRequest.Builder("AD_UNIT_ID", adSize)
      .setGoogleExtrasBundle(extras)
      .build();

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

Comportamento di aggiornamento degli annunci

Per le app che configurano l'aggiornamento automatico per gli annunci banner nell'interfaccia web di Ad Manager, quando viene richiesto un annuncio banner comprimibile per uno slot banner, i successivi aggiornamenti dell'annuncio non richiederanno annunci in questo formato. Questo perché la visualizzazione di un banner comprimibile a ogni aggiornamento potrebbe avere un impatto negativo sull'esperienza utente.

Se vuoi caricare un altro annuncio banner comprimibile più avanti nella sessione, puoi caricare un annuncio manualmente con una richiesta contenente il parametro che definisce il carattere comprimibile.

Verificare se un annuncio caricato è comprimibile

Per massimizzare il rendimento, gli annunci banner non comprimibili sono idonei a essere restituiti per le richieste di banner comprimibili. Chiama isCollapsible per verificare se l'ultimo banner caricato è comprimibile. Se la richiesta non riesce a caricare e il banner precedente è comprimibile, l'API restituisce il valore true.

override fun onAdLoaded(ad: BannerAd) {
  // ...
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible."
  )
}

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  // ...
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.",
      ad.isCollapsible() ? "" : "not "));
}

Mediazione

Gli annunci banner comprimibili sono disponibili solo per la domanda di Google. Gli annunci pubblicati tramite la mediazione vengono visualizzati come annunci banner normali e non comprimibili.