Utiliser des bannières réductibles

Sélectionnez la plate-forme : Android (bêta) Android iOS Unity Flutter

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

Prérequis

• Suivez le guide de démarrage sur les bannières.

Implémentation

Assurez-vous que votre vue de bannière est définie avec la taille que vous souhaitez que les utilisateurs voient dans l'état standard de la bannière (c'est-à-dire l'état réduit). Incluez un paramètre supplémentaire dans la demande d'annonce 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.

Si l'annonce chargée est une bannière réductible, la superposition réductible s'affiche immédiatement une fois qu'elle est placée dans la hiérarchie des vues.

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

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

Comportement d'actualisation des annonces

Pour les applications qui configurent l'actualisation automatique des bannières dans l'interface Web AdMob, lorsqu'une bannière réductible est demandée pour un emplacement de bannière, les actualisations d'annonces suivantes ne demandent pas ce type d'annonce. En effet, l'affichage d'une bannière réductible à chaque actualisation 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 est réductible

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.

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

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

Médiation

Les bannières réductibles ne sont disponibles que pour la demande Google. Les annonces diffusées via la médiation s'affichent comme des bannières normales non réductibles.