Bannières adaptatives intégrées

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

Par rapport 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. Les bannières adaptatives intégrées ont une hauteur variable. Elles 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 :

Avant de commencer

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

Implémenter des bannières adaptatives

Contrairement aux bannières ancrées adaptatives, les bannières adaptatives intégrées se chargent à l'aide d'une taille de bannière adaptative intégrée. Pour créer un format 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.

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 :

   L'exemple suivant illustre ces étapes :

   Kotlin

   private fun loadAd() {
     // Create an inline adaptive ad size. 320 is a placeholder value.
     // Replace 320 with your banner container width.
     val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)
   
     // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
     val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()
   
     // Step 2 - Load the ad.
     BannerAd.load(
       adRequest,
       object : AdLoadCallback<BannerAd> {
         override fun onAdLoaded(ad: BannerAd) {
           // Assign the loaded ad to the BannerAd object.
           bannerAd = ad
           // Step 3 - Call BannerAd.getView() to get the View and add it
           // to view hierarchy on the UI thread.
           activity?.runOnUiThread {
             binding.bannerViewContainer.addView(ad.getView(requireActivity()))
           }
         }
   
         override fun onAdFailedToLoad(loadAdError: LoadAdError) {
           bannerAd = null
         }
       }
     )
   }
   

   Java

   private void loadAd() {
     // Create an inline adaptive ad size. 320 is a placeholder value.
     // Replace 320 with your banner container width.
     AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);
   
     // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
     BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
         adSize).build();
   
     // Step 2 - Load the ad.
     BannerAd.load(
         adRequest,
         new AdLoadCallback<BannerAd>() {
           @Override
           public void onAdLoaded(@NonNull BannerAd ad) {
             // Assign the loaded ad to the BannerAd object.
             bannerAd = ad;
             // Step 3 - Call BannerAd.getView() to get the View and add it
             // to view hierarchy on the UI thread.
             if (getActivity() != null) {
               getActivity()
                   .runOnUiThread(() ->
                       binding.bannerViewContainer.addView(ad.getView(getActivity())));
             }
           }
   
           @Override
           public void onAdFailedToLoad(@NonNull LoadAdError adError) {
             bannerAd = null;
           }
         });
   }
   

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

   • Les bannières adaptatives intégrées sont plus efficaces lorsqu'elles utilisent toute la largeur disponible. Dans la plupart des cas, il s'agit de la largeur totale de l'écran de l'appareil utilisé ou de la largeur totale du contenu parent de la bannière. Vous devez connaître la largeur de la vue à insérer dans l'annonce, la largeur de l'appareil, la largeur du contenu parent et les zones de sécurité applicables.

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

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

   • AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

   • AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

   Si votre application est compatible avec les vues Portrait et Paysage, et que vous souhaitez précharger une 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 des bannières adaptatives intégrées

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