Utiliser des bannières adaptatives intégrées pour les bannières à faire défiler

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

Les bannières adaptatives vous permettent de spécifier la largeur d'une annonce pour déterminer sa taille optimale. Elles maximisent également les performances en optimisant la taille de l'annonce pour chaque appareil. Cette approche permet d'améliorer les performances.

Contrairement aux bannières adaptatives ancrées, les bannières adaptatives intégrées sont plus grandes, plus larges et utilisent une hauteur variable plutôt qu'une hauteur fixe. Elles ont une hauteur variable et peuvent occuper tout l'écran ou une hauteur maximale que vous spécifiez.

Vous pouvez placer des bannières adaptatives intégrées dans du contenu à faire défiler, par exemple :

Diagramme montrant les différences entre les bannières adaptatives et les bannières adaptatives intégrées

Avant de commencer

Avant de continuer, assurez-vous d'avoir suivi le guide de démarrage, Annonces bannières.

Implémenter des bannières adaptatives intégrées

Pour créer une taille d'annonce adaptative intégrée, procédez comme suit :

  1. Obtenez la largeur de l'appareil utilisé ou définissez votre propre largeur si vous ne souhaitez pas utiliser toute la largeur de l'écran.

    Kotlin

    private val adWidth: Int
  get() {
    val displayMetrics = resources.displayMetrics
    val adWidthPixels =
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
        windowMetrics.bounds.width()
      } else {
        displayMetrics.widthPixels
      }
    val density = displayMetrics.density
    return (adWidthPixels / density).toInt()
  }

    MainActivity.kt

    Java

    public int getAdWidth() {
  DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
  int adWidthPixels = displayMetrics.widthPixels;

  if (VERSION.SDK_INT >= VERSION_CODES.R) {
    WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
    adWidthPixels = windowMetrics.getBounds().width();
  }

  float density = displayMetrics.density;
  return (int) (adWidthPixels / density);
}

    MainActivity.java

  2. Pour obtenir un objet de taille d'annonce adaptative intégrée pour l'orientation choisie, utilisez une méthode statique sur la classe de taille d'annonce :

    Kotlin

    val adView = AdView(this@MainActivity)
adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
    MainActivity.kt

    Java

    final AdView adView = new AdView(MainActivity.this);
adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
    MainActivity.java

Lorsque vous implémentez des bannières adaptatives dans votre application, tenez compte des points suivants :

  • Les tailles de bannières adaptatives intégrées fonctionnent mieux lorsque vous utilisez toute la largeur disponible. Dans la plupart des cas, cette taille correspond à la largeur totale de l'écran de l'appareil utilisé ou à la largeur totale du contenu parent de la bannière. Vous devez connaître la largeur de la vue à placer dans l'annonce, la largeur de l'appareil, la largeur du contenu parent et les zones sécurisées applicables.
  • Vous devrez peut-être mettre à jour ou créer des éléments de campagne pour qu'ils fonctionnent avec les tailles adaptatives. En savoir plus.

Orienter la taille de la bannière adaptative intégrée

Pour précharger une annonce de bannière adaptative intégrée pour une orientation spécifique, utilisez les méthodes suivantes :

Si votre application est compatible avec les vues portrait et paysage, et que vous souhaitez précharger une annonce de bannière adaptative dans l'orientation actuelle, utilisez AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Cette méthode charge une annonce dans l'orientation actuelle.

Limiter la hauteur de la bannière adaptative intégrée

Par défaut, les bannières adaptatives intégrées instanciées sans valeur maxHeight ont une maxHeight égale à la hauteur de l'appareil. Pour limiter la hauteur de la bannière adaptative intégrée, utilisez la AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) méthode.

Ressources supplémentaires

Exemples sur GitHub

Téléchargez l'exemple d'application pour voir les bannières adaptatives intégrées en action.

Java Kotlin