Annunci banner comprimibili

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

Prerequisiti

Implementazione

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

Il posizionamento comprimibile definisce il modo in cui la regione espansa si ancora aggancia all'annuncio banner.

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

Se l'annuncio caricato è un banner comprimibile, il banner mostra l'overlay comprimibile subito dopo essere stato posizionato nella gerarchia di 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

Aggiornare gli annunci banner comprimibili in modo che vengano visualizzati ogni 30-120 secondi potrebbe essere troppo frequente, causando un'esperienza utente frustrante. Per le app che configurano l'aggiornamento automatico nell' Ad Manager interfaccia web, consigliamo di mostrare solo la prima richiesta di annuncio come comprimibile e i successivi annunci banner aggiornati nell'area in questione con le dimensioni della richiesta originale. Per farlo, passa un UUID come collapsible_request_id alla richiesta di annuncio:

Java

extras.putString("collapsible_request_id", UUID.randomUUID().toString());

Kotlin

extras.putString("collapsible_request_id", UUID.randomUUID().toString())

Se vuoi caricare un altro annuncio banner comprimibile in un secondo momento della sessione, puoi chiamare loadAd() manualmente con una richiesta contenente il parametro comprimibile.

Verificare se un annuncio caricato è comprimibile

Chiama isCollapsible per verificare se l'ultimo banner caricato è comprimibile. Se la richiesta non viene caricata 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 per la domanda di Google solo durante il periodo beta. Gli annunci pubblicati tramite mediante vengono mostrati come normali annunci banner non comprimibili.

Comportamento di pubblicazione degli annunci

Per massimizzare il rendimento degli annunci banner, gli annunci che non supportano un overlay comprimibile di dimensioni maggiori potrebbero restituire alcune richieste di banner comprimibili ed essere visualizzati immediatamente nelle normali dimensioni del banner.