Annunci banner comprimibili

Gli annunci banner comprimibili sono annunci banner inizialmente presentati come overlay più grandi, con un pulsante per comprimerli fino alle dimensioni del banner richieste inizialmente. Gli annunci banner comprimibili hanno lo scopo di migliorare il rendimento degli annunci ancorati che, diversamente, hanno dimensioni inferiori. Questa guida mostra come attivare gli annunci banner comprimibili per i posizionamenti dei banner esistenti.

Prerequisiti

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 extra nella richiesta dell'annuncio con collapsible come chiave e il posizionamento dell'annuncio come valore.

Il posizionamento comprimibile definisce il modo in cui la regione espansa viene ancorata all'annuncio banner.

Valore Placement Comportamento Caso d'uso previsto
top La parte superiore dell'annuncio espanso è allineata alla parte superiore dell'annuncio compresso. L'annuncio è posizionato nella parte superiore dello schermo.
bottom La parte inferiore dell'annuncio espanso è allineata alla parte inferiore dell'annuncio compresso. L'annuncio è posizionato nella parte inferiore dello schermo.

Se l'annuncio caricato è un banner comprimibile, il banner mostra l'overlay comprimibile immediatamente dopo essere stato inserito nella gerarchia della visualizzazione.

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // 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 adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

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 un'area banner, i successivi aggiornamenti dell'annuncio non richiederanno annunci banner comprimibili. 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.

Controllare se un annuncio caricato è comprimibile

Per massimizzare il rendimento, gli annunci banner non comprimibili possono essere restituiti per le richieste di annunci banner comprimibili. Chiama isCollapsible per verificare se l'ultimo banner caricato è comprimibile. Se il caricamento della richiesta non riesce e il banner precedente è comprimibile, l'API restituisce true.

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

Mediazione

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