Bannières adaptatives intégrées

Les bannières adaptatives vous permettent de spécifier la largeur d'une annonce afin de déterminer taille de l'annonce. Les bannières adaptatives maximisent également les performances en optimisant la taille des annonces pour chaque appareil. Cette approche offre la possibilité de meilleures performances.

Par rapport aux bannières adaptatives ancrées, les bannières adaptatives intégrées sont plus grandes, plus hautes et utilisent des hauteurs variables plutôt que fixes. Les bannières adaptatives intégrées de hauteur variable, et peuvent occuper la totalité de l'écran ou une hauteur maximale que vous spécifiez.

Vous placez 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 en bannière.

Implémenter des bannières adaptatives

Contrairement aux bannières adaptatives ancrées, les bannières d'adaptateur intégrées se chargent à l'aide d'une taille de bannière adaptative intégrée. Pour créer une taille d'annonce adaptative intégrée, suivez les suivantes:

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. Utilisez les méthodes statiques appropriées sur la classe de taille d'annonce, par exemple AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) pour obtenir un objet de taille d'annonce adaptative intégré pour l'orientation choisie.
3. Si vous souhaitez limiter la hauteur de la bannière, utilisez la méthode statique AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

L'exemple suivant illustre ces étapes:

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

Important :Les tailles d'annonces par réservation Ad Manager peuvent être diffusées dans le même espace publicitaire. en tant que bannières adaptatives. Pour utiliser des bannières adaptatives avec Ad Manager annonces par réservation dans le même espace publicitaire, appelez setAdSizes avec une liste de tailles contenant la taille adaptative en plus de toutes les tailles d'annonces par réservation.

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 ou toute la largeur 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ûres applicables.

• Vous devrez peut-être mettre à jour ou créer des éléments de campagne pour utiliser les tailles adaptatives. En savoir plus

Orienter 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 dont la valeur maxHeight est égale à la hauteur de l'appareil. Pour limiter la hauteur de la bannière adaptative intégrée, utilisez la méthode AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

Ressources supplémentaires

Exemples sur GitHub

Téléchargez l'exemple d'application pour observer le fonctionnement des bannières adaptatives intégrées.

Java Kotlin