Cette page a été traduite par l'API Cloud Translation.

Bannières adaptatives ancrées

Les bannières adaptatives constituent la nouvelle génération d'annonces responsives. Elles permettent de maximiser les performances en optimisant la taille des annonces pour chaque appareil. Les bannières intelligentes, qui n'acceptaient que les hauteurs fixes, ont été améliorées. Les bannières adaptatives vous permettent de spécifier la largeur de l'annonce et de l'utiliser pour déterminer la taille d'annonce optimale.

Pour choisir la meilleure taille d'annonce, les bannières adaptatives utilisent des formats fixes plutôt que des hauteurs fixes. Vous obtenez ainsi des bannières qui occupent une portion plus homogène de l'écran sur tous les appareils et offrent la possibilité d'améliorer les performances.

Lorsque vous utilisez des bannières adaptatives, notez qu'elles renvoient toujours une taille constante pour un appareil et une largeur donnés. Une fois que vous avez testé votre mise en page sur un appareil donné, vous pouvez être sûr que la taille de l'annonce ne changera pas. Cependant, sa taille peut varier selon les appareils. Par conséquent, nous vous recommandons de faire en sorte que votre mise en page s'adapte aux variations de hauteur d'annonce. Dans de rares cas, il se peut que la taille adaptative complète ne soit pas remplie. Une création de taille standard est alors centrée dans cet emplacement.

Conditions préalables

Suivez les instructions du guide de démarrage pour savoir comment importer le plug-in Mobile Ads Unity et inclure le SDK Mobile Ads.

Quand utiliser les bannières adaptatives ?

Les bannières adaptatives sont conçues pour remplacer directement la taille de bannière standard 320 x 50 et le format de bannière intelligente qu'elles remplacent.

Ces tailles de bannière sont couramment utilisées comme bannières ancrées, qui sont généralement verrouillées en haut ou en bas de l'écran.

Pour ces bannières ancrées, le format utilisé pour les bannières adaptatives est semblable à celui d'une annonce standard 320 x 50, comme le montrent les trois exemples ci-dessous:

Bannière 320 x 50

Bannière adaptative

Bannière intelligente

Les bannières adaptatives exploitent mieux la taille d'écran disponible. En outre, une bannière adaptative est plus adaptée qu'une bannière intelligente pour les raisons suivantes:

Elle utilise la largeur que vous fournissez, au lieu de la forcer à s'afficher en plein écran, ce qui vous permet de tenir compte de la zone de sécurité sur iOS et des encoches sur Android.
Elle sélectionne une hauteur optimale pour l'appareil spécifique, plutôt que d'avoir une hauteur constante sur des appareils de différentes tailles, ce qui atténue les effets de la fragmentation des appareils.

Notes de mise en œuvre

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

Vous devez connaître la largeur de la vue dans laquelle l'annonce sera placée, en tenant compte de la largeur de l'appareil, ainsi que des zones de sécurité ou des encoches applicables.
Assurez-vous que l'arrière-plan du visionnage de l'annonce est opaque afin de respecter les règles AdMob lorsque des tailles d'annonces plus petites sont diffusées et ne remplissent pas l'espace publicitaire.
Assurez-vous d'utiliser la dernière version du plug-in Google Mobile Ads Unity. Pour la médiation, utilisez la dernière version de chaque adaptateur de médiation.
Les tailles de bannières adaptatives sont conçues pour fonctionner de manière optimale lorsque vous utilisez toute la largeur disponible. Dans la plupart des cas, il s'agit de la largeur totale de l'écran de l'appareil utilisé. Veillez à tenir compte des zones de sécurité applicables.
Lorsque vous utilisez les API adaptatives AdSize, le SDK Google Mobile Ads dimensionne la bannière avec une hauteur d'annonce optimisée pour la largeur donnée.
Il existe trois méthodes pour obtenir une taille d'annonce adaptative : AdSize.GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth pour le mode paysage, AdSize.GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth pour le mode portrait et AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth pour l'orientation actuelle au moment de l'exécution.
La taille renvoyée pour une largeur donnée sur un appareil donné sera toujours la même. Par conséquent, une fois que vous avez testé votre mise en page sur un appareil donné, vous pouvez être certain que la taille de l'annonce ne changera pas.
La hauteur de la bannière ancrée n'est jamais supérieure à 15% de la hauteur de l'appareil ou à 90 pixels indépendants de la densité, et jamais inférieure à 50 pixels indépendants de la densité.
Pour les bannières pleine largeur, vous pouvez utiliser l'indicateur AdSize.FullWidth au lieu de fournir une largeur spécifique.

Guide de démarrage rapide

Suivez les étapes ci-dessous pour implémenter une bannière ancrée adaptative simple.

Obtenez une taille de bannière adaptative. La taille obtenue sera utilisée pour demander votre bannière adaptative. Pour obtenir la taille d'annonce adaptative, assurez-vous que :
1. Obtenez la largeur de l'appareil utilisé en pixels indépendants de la densité, ou définissez votre propre largeur si vous ne souhaitez pas utiliser toute la largeur de l'écran. Étant donné que les API Unity telles que Screen.width renvoient des pixels absolus, vous devez procéder à une répartition par taille d'appareil (récupérable à partir de MobileAds.Utils.GetDeviceScale()).
2. Utilisez l'indicateur AdSize.FullWidth pour les bannières pleine largeur.
3. Utilisez les méthodes statiques appropriées sur la classe de taille d'annonce, telles que AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(width), afin d'obtenir un objet AdSize adaptatif pour l'orientation actuelle.
Créez un objet BannerView avec votre ID de bloc d'annonces, la taille adaptative et la position pertinente pour votre annonce.
Créez un objet de demande d'annonce et chargez votre bannière à l'aide de la méthode LoadAd() sur l'affichage de l'annonce préparée, comme vous le feriez pour une demande de bannière normale.

Exemple de code

Voici un exemple de script qui charge et actualise une bannière adaptative pour qu'elle s'adapte à la largeur de l'écran, en tenant compte de la zone de sécurité:

using UnityEngine;
using System;
using GoogleMobileAds.Api;

public class AdaptiveBannerSample : MonoBehaviour
{
    private BannerView _bannerView;

    // Use this for initialization
    void Start()
    {
        // Set your test devices.
        // https://developers.google.com/admob/unity/test-ads
        RequestConfiguration requestConfiguration = new RequestConfiguration
        {
            TestDeviceIds = new List<string>
            {
                AdRequest.TestDeviceSimulator,
                // Add your test device IDs (replace with your own device IDs).
                #if UNITY_IPHONE
                "96e23e80653bb28980d3f40beb58915c"
                #elif UNITY_ANDROID
                "75EF8D155528C04DACBBA6F36F433035"
                #endif
            }
        };
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus status) => 
        {
            RequestBanner();
        });
    }

    public void OnGUI()
    {
        GUI.skin.label.fontSize = 60;
        Rect textOutputRect = new Rect(
          0.15f * Screen.width,
          0.25f * Screen.height,
          0.7f * Screen.width,
          0.3f * Screen.height);
        GUI.Label(textOutputRect, "Adaptive Banner Example");
    }

    private void RequestBanner()
    {
        // These ad units are configured to always serve test ads.
        #if UNITY_EDITOR
            string adUnitId = "unused";
        #elif UNITY_ANDROID
            string adUnitId = "ca-app-pub-3212738706492790/6113697308";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3212738706492790/5381898163";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        // Clean up banner ad before creating a new one.
        if (_bannerView != null)
        {
            _bannerView.Destroy();
        }

        AdSize adaptiveSize =
                AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(AdSize.FullWidth);

        _bannerView = new BannerView(adUnitId, adaptiveSize, AdPosition.Bottom);

        // Register for ad events.
        _bannerView.OnBannerAdLoaded += OnBannerAdLoaded;
        _bannerView.OnBannerAdLoadFailed += OnBannerAdLoadFailed;

        AdRequest adRequest = new AdRequest();

        // Load a banner ad.
        _bannerView.LoadAd(adRequest);
    }

    #region Banner callback handlers

    private void OnBannerAdLoaded(object sender, EventArgs args)
    {
        Debug.Log("Banner view loaded an ad with response : "
                 + _bannerView.GetResponseInfo());
        Debug.Log("Ad Height: {0}, width: {1}",
                _bannerView.GetHeightInPixels(),
                _bannerView.GetWidthInPixels());
    }

    private void OnBannerAdLoadFailed(LoadAdError error)
    {
        Debug.LogError("Banner view failed to load an ad with error : "
                + error);
    }

    #endregion
}

Ici, la fonction AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth permet d'obtenir la taille d'une bannière à une position ancrée dans l'orientation actuelle de l'interface. Pour précharger une bannière ancrée dans une orientation donnée, utilisez la fonction appropriée de AdSize.GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth et AdSize.GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth.