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 offre des possibilités d'amélioration des 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 ont une hauteur variable et peuvent occuper l'intégralité 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:

Schéma illustrant les différences entre les bannières adaptatives et les bannières adaptatives intégrées

Avant de commencer

Avant de continuer, assurez-vous de disposer des éléments suivants:

  • SDK Google Mobile Ads 8.10.0 ou version ultérieure
  • Vous avez lu le guide de démarrage Annonces bannières.

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, 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. Utilisez les méthodes statiques appropriées sur la classe de taille d'annonce, telles que GADCurrentOrientationInlineBannerAdSizeWithWidth(CGFloat 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 GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight).

L'exemple suivant illustre ces étapes:

Swift

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or
// set your own width. This example sets a static width.
let adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320)
// Step 2: Create banner with the inline size and set ad unit ID.
let bannerView = GAMBannerView(adSize: adSize)
bannerView.adUnitID = "<var>ad unit ID</var>"
bannerView.rootViewController = self

// For Ad Manager, the `adSize` property is used for the adaptive banner ad
// size. The `validAdSizes` property is used as normal for the supported
// reservation sizes for the ad placement.
bannerView.validAdSizes = [NSValueFromGADAdSize(GADAdSizeBanner)]

// Step 3: Load an ad.
let request = GAMRequest()
bannerView.load(request)
// TODO: Insert banner view in table view or scroll view, etc.

Objective-C

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or set
// your own width. This example sets a static width.
GADAdSize *adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320);
// Step 2: Create banner with the inline size and set ad unit ID.
GAMBannerView bannerView = [[GAMBannerView alloc] initWithAdSize:adSize];
bannerView.adUnitID = @"<var>ad unit ID</var>";
bannerView.rootViewController = self;

// For Ad Manager, the adSize property is used for the adaptive banner ad size.
// The validAdSizes property is used as normal for the supported reservation
// sizes for the ad placement. This is optional and only needed if you wish to
// support reservation ad sizes.
bannerView.validAdSizes = @[ NSValueFromGADAdSize(GADAdSizeBanner) ];

// Step 3: Load an ad.
GAMRequest *request = [GAMRequest request];
[bannerView loadRequest:request];
// TODO: Insert banner view in table view or scroll view, etc.

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û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:

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 GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(CGFloat 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 maxHeight égale à la hauteur de l'appareil. Pour limiter la hauteur de la bannière adaptative intégrée, utilisez la méthode GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight).

Ressources supplémentaires

Exemples sur GitHub

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

Swift Objective-C