Bannières

Les vues de bannières sont des annonces rectangulaires illustrées ou textuelles qui occupent une partie de l'écran. Elles restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous débutez dans la publicité mobile, elles constituent un excellent point de départ. Étude de cas.

Ce guide vous explique comment intégrer des vues de bannières dans une application Unity. En plus des extraits de code et des instructions, il inclut également des informations sur le dimensionnement correct des bannières et des liens vers des ressources supplémentaires.

Prérequis

• Suivez le guide de démarrage.

Toujours effectuer des tests avec des annonces tests

L'exemple de code suivant contient un ID de bloc d'annonces que vous pouvez utiliser pour demander des annonces tests. Il a été spécialement configuré pour renvoyer des annonces tests plutôt que des annonces de production pour chaque demande, ce qui le rend sûr à utiliser.

Toutefois, après avoir enregistré une application dans l'interface Web AdMob et créé vos propres ID de bloc d'annonces à utiliser dans votre application, configurez explicitement votre appareil en tant qu'appareil de test pendant le développement.

Initialiser le SDK Mobile Ads

Avant de charger des annonces, faites en sorte que votre application initialise le SDK Mobile Ads en appelant MobileAds.Initialize(). Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Si vous utilisez la médiation, attendez que le rappel se produise avant de charger les annonces. Cela garantira que tous les adaptateurs de médiation sont initialisés.

Exemple BannerView

L'exemple de code suivant montre comment utiliser la vue de bannière. Dans l'exemple, créez une instance de vue de bannière, utilisez un AdRequest pour charger une annonce dans la vue de bannière, puis étendez ses capacités en gérant les événements de cycle de vie.

Créer une vue de bannière

La première étape pour utiliser une vue de bannière consiste à créer une instance de vue de bannière.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

Remplacez AD_UNIT_ID par l'ID de votre bloc d'annonces.

Le constructeur d'un BannerView comporte les paramètres suivants :

• adUnitId : ID du bloc d'annonces bannière à charger.
• AdSize : taille de la bannière que vous souhaitez utiliser.
• AdPosition : position où les vues de bannière doivent être placées.

(Facultatif) Créer une vue de bannière avec une position personnalisée

Pour mieux contrôler l'emplacement d'une vue de bannière à l'écran que ce que proposent les valeurs AdPosition, utilisez le constructeur qui comporte des coordonnées x et y comme paramètres :

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

L'angle supérieur gauche de la vue de la bannière est positionné sur les valeurs x et y transmises au constructeur, où l'origine est l'angle supérieur gauche de l'écran.

(Facultatif) Créer une vue de bannière avec une taille personnalisée

En plus d'utiliser une constante AdSize, vous pouvez également spécifier une taille personnalisée pour votre annonce :

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

Charger une bannière

Pour charger une annonce, créez un AdRequest et transmettez-le à la méthode LoadAd().

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

Écouter les événements de vue de bannière

Pour personnaliser le comportement de votre annonce, vous pouvez vous connecter à un certain nombre d'événements du cycle de vie de l'annonce, tels que le chargement, l'ouverture ou la fermeture. Pour écouter ces événements, enregistrez un délégué :

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
BannerViewSnippets.cs

Détruire la vue de la bannière

Lorsque vous avez terminé d'utiliser la vue de bannière, veillez à appeler Destroy() pour libérer les ressources.

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

Et voilà ! Votre application est maintenant prête à diffuser des bannières publicitaires.

Actualiser une annonce

Si vous avez configuré votre bloc d'annonces pour qu'il s'actualise, vous n'avez pas besoin de demander une autre annonce lorsque l'annonce ne se charge pas. Le SDK Google Mobile Ads respecte toute fréquence d'actualisation que vous avez spécifiée dans l'UI AdMob. Si vous n'avez pas activé l'actualisation, envoyez une nouvelle demande. Pour en savoir plus sur l'actualisation des blocs d'annonces, par exemple sur la définition d'une fréquence d'actualisation, consultez Utiliser l'actualisation automatique pour les bannières.

Tailles des bannières

Le tableau suivant répertorie les tailles de bannières standards :

Ressources supplémentaires

• Exemple HelloWorld : Implémentation minimale de tous les formats d'annonces.

• Exemple d'utilisation