Bannières réductibles

Les bannières réductibles sont initialement présentées sous la forme avec un bouton permettant de les réduire à la taille de bannière demandée à l'origine. Les bannières réductibles sont destinées à améliorer les performances des annonces ancrées sont de taille inférieure. 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 manière dont la zone développée s'ancre par rapport à la bannière. annonce.

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

L'actualisation des bannières réductibles toutes les 30 à 120 secondes trop fréquentes, entraînant une expérience utilisateur frustrante. Pour les applications qui configurent l'actualisation automatique dans l'interface Web AdMob, recommandent de ne diffuser que la première demande d'annonce comme réductible et les suivantes des bannières actualisées dans cet emplacement à la taille de la demande initiale. À Pour ce faire, transmettez un UUID en tant que collapsible_request_id à la demande d'annonce:

Java 

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

Kotlin 

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

Si vous souhaitez charger une autre bannière réductible plus tard au cours de la session, vous pouvez charger manuellement une annonce avec une demande contenant le paramètre réductible ;

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

Appelez isCollapsible pour vérifier si la dernière bannière chargée peut être réduite. Si le chargement de la requête échoue et que la bannière précédente peut être réduite, 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 par le biais de la médiation se présentent comme des bannières standards non réductibles.

Comportement de diffusion des annonces

Pour maximiser les performances de vos bannières, les annonces qui n'acceptent pas la superposition réductible pourrait renvoyer des demandes de bannières réductibles et s'afficher immédiatement à la taille de bannière standard.