Annunci banner comprimibili

Seleziona la piattaforma: Android iOS Unity Flutter

Gli annunci banner comprimibili sono annunci banner che inizialmente vengono presentati come overlay più grande, con un pulsante per comprimerli fino alle dimensioni del banner richieste in origine. Gli annunci banner comprimibili hanno lo scopo di migliorare il rendimento degli annunci ancorati che altrimenti hanno dimensioni più piccole. 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 di annuncio con collapsible come chiave e il posizionamento dell'annuncio come valore.

Il posizionamento comprimibile definisce in che modo la regione espansa si ancora 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, l'overlay comprimibile viene visualizzato immediatamente dopo essere stato inserito nella gerarchia delle visualizzazioni.

Java

private void loadCollapsibleBanner() {
  // 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");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // 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")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

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 influire negativamente 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

Gli annunci banner non comprimibili sono idonei per essere restituiti per le richieste di annunci banner comprimibili per massimizzare il rendimento. 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(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

Mediazione

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