Annunci banner comprimibili

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

Gli annunci banner comprimibili sono annunci banner che inizialmente vengono presentati come un overlay più grande, con un pulsante per comprimerli alle dimensioni del banner richieste originariamente. Gli annunci banner comprimibili hanno lo scopo di migliorare il rendimento degli annunci ancorati che altrimenti avrebbero dimensioni inferiori. Questa guida mostra come attivare gli annunci banner comprimibili per i posizionamenti 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 aggiuntivo 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 all'annuncio banner.

Valore Placement Comportamento Caso d'uso previsto
top La parte superiore dell'annuncio espanso si allinea alla parte superiore dell'annuncio compresso. L'annuncio è posizionato nella parte superiore dello schermo.
bottom La parte inferiore dell'annuncio espanso si allinea 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 di oggetti View:

Kotlin

private fun loadCollapsibleBannerAd(adView: AdView, activity: Activity) {
  val adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360)

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

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

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.i(
          TAG,
          "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible.",
        )
      }


      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Banner ad failed to load: $adError")
      }
    },
  )
}

Java

private void loadCollapsibleBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  AdSize adSize = AdSize.getLargeAnchoredAdaptiveBannerAdSize(activity, 360);

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

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

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


        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Banner ad failed to load: " + adError);
        }
      });
}

Sostituisci AD_UNIT_ID con l'ID unità pubblicitaria.

Comportamento di aggiornamento degli annunci

Per le app che configurano l'aggiornamento automatico per gli annunci banner nell'interfaccia web di AdMob, quando viene richiesto un annuncio banner comprimibile per un'area banner, i successivi aggiornamenti dell'annuncio non richiederanno annunci banner comprimibili. Questo perché mostrare 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.

Verifica se un annuncio caricato è comprimibile

Gli annunci banner non comprimibili sono idonei a essere restituiti per le richieste di banner comprimibili per massimizzare il rendimento. Se la richiesta non viene caricata e il banner precedente è comprimibile, l'API restituisce il valore true. Per verificare se l'ultimo banner caricato è comprimibile, chiama il metodo isCollapsible:

Kotlin

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

Java

@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 normali annunci banner non comprimibili.