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. Véritable progrès par rapport aux bannières intelligentes qui ne toléraient que des hauteurs fixes, les bannières adaptatives vous permettent de spécifier la largeur de l'annonce et de l'utiliser pour déterminer la taille 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 plus ou moins la même portion de l'écran sur tous les appareils et offrent des opportunités d'amélioration des performances.

Lorsque vous travaillez avec 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 concevoir votre mise en page de manière à tenir compte des variations de hauteur des annonces. Dans de rares cas, la taille adaptative complète peut ne pas être remplie et une création de taille standard sera 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 les bannières standards au format 320 x 50, ainsi que les bannières intelligentes dont elles ont pris la place.

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 des bannières adaptatives sera 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

La bannière adaptative exploite 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 à être affichée en plein écran, ce qui vous permet de tenir compte de la zone sûre sur iOS et des encoches sur Android.
Elle sélectionne une hauteur optimale pour l'appareil spécifique, plutôt qu'une hauteur constante pour les 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 de l'affichage de l'annonce est opaque pour respecter les règles AdMob lorsque des annonces de taille plus petite sont diffusées et ne remplissent pas l'espace publicitaire.
Assurez-vous d'utiliser la dernière version du plug-in Unity Google Mobile Ads. 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 à prendre en compte les zones sécurisées 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 sûr que la taille de l'annonce ne changera pas.
La hauteur de la bannière ancrée ne dépasse jamais la valeur la plus faible entre 15 % de la hauteur de l'appareil ou 90 pixels indépendants de la densité, et n'est jamais inférieure à 50 pixels indépendants de la densité.
Pour les bannières pleine largeur, vous pouvez utiliser l'option 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 d'annonce bannière adaptative. Cette taille sera utilisée pour demander votre bannière adaptative. Pour obtenir la taille d'annonce adaptative, assurez-vous de :
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 diviser par l'échelle de l'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 requête d'annonce et chargez votre bannière à l'aide de la méthode LoadAd() sur votre vue d'annonce préparée, comme vous le feriez avec une requête de bannière normale.

Exemple de code

Voici un exemple de script qui charge et recharge une bannière adaptative pour l'adapter à 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 est utilisée pour obtenir la taille d'une bannière dans une position ancrée pour l'orientation de l'interface actuelle. Pour précharger une bannière ancrée dans une orientation donnée, utilisez la fonction appropriée de AdSize.GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth et AdSize.GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth.