Bannières réductibles

Les bannières réductibles sont des bannières qui sont initialement présentées sous la forme d'une superposition plus grande, avec un bouton permettant de les réduire à la taille de bannière demandée à l'origine. Les bannières réductibles sont conçues pour améliorer les performances des annonces ancrées qui sont autrement de petite taille. Ce guide explique comment activer une bannière réductible pour les emplacements de bannières existants.

Prérequis

Implémentation

Assurez-vous que l'affichage de votre bannière correspond à la taille que vous souhaitez montrer aux utilisateurs. à l'état normal (réduit) de la bannière. Inclure un paramètre "extras" dans l'annonce requête avec collapsible comme clé et l'emplacement de l'annonce comme valeur.

L'emplacement réductible définit la façon dont la région développée s'ancre à la bannière publicitaire.

Valeur Placement Comportement Cas d'utilisation prévu
top La partie supérieure de l'annonce développée s'aligne sur la partie supérieure de l'annonce réduite. L'annonce est placée en haut de l'écran.
bottom La partie inférieure de l'annonce développée s'aligne sur la partie inférieure de l'annonce réduite. annonce. L'annonce est placée en bas de l'écran.

Si l'annonce chargée est une bannière réductible, la bannière affiche qui se superposent dès qu'elles sont placées dans la hiérarchie des vues.

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)
}

Comportement d'actualisation des annonces

Pour les applications qui configurent l'actualisation automatique des bannières dans l'interface Web d'Ad Manager, lorsqu'une bannière réductible est demandée pour un emplacement de bannière, les actualisations d'annonces suivantes n'en requièrent pas. En effet, l'affichage d'une bannière réductible peut avoir un impact négatif sur l'expérience utilisateur.

Si vous souhaitez charger une autre bannière réductible ultérieurement lors de la session, vous pouvez charger une annonce manuellement avec une requête contenant le paramètre définissant le caractère réductible.

Vérifier si une annonce chargée peut être réduite

Les bannières non réductibles peuvent être renvoyées pour les demandes de bannières réductibles afin de maximiser les performances. Appelez isCollapsible pour vérifier si la dernière bannière chargée est réductible. Si la requête ne parvient pas à se charger et que la bannière précédente est réductible, l'API renvoie la valeur "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.")
}

Médiation

Les bannières réductibles ne sont disponibles que pour la demande Google pendant la phase bêta période. Les annonces diffusées via la médiation s'affichent sous forme de bannières non réductibles.