Annonces interstitielles

Les annonces interstitielles sont des annonces en plein écran qui recouvrent l'interface de l'application qui les héberge. Elles s'affichent généralement à des points de transition naturels dans le flux d'une application, par exemple pendant la pause entre deux niveaux de jeu. Lorsqu'une application affiche une annonce interstitielle, l'utilisateur peut appuyer sur l'annonce et accéder à sa destination, ou la fermer et revenir à l'application.

Ce guide explique comment intégrer des annonces interstitielles dans une application Unity.

Prérequis

Avant de continuer, configurez Google Mobile Ads Unity Plugin.

Toujours tester 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 de test plutôt que des annonces de production pour chaque demande, ce qui permet de l'utiliser en toute sécurité.

Toutefois, après avoir enregistré une application dans l'interface Web Ad Manager 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.

/21775744923/example/interstitial

Initialiser Google Mobile Ads Unity Plugin

Avant de charger des annonces, demandez à votre application d'initialiser Google Mobile Ads Unity Plugin 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 Google Mobile Ads Unity Plugin.
        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 garantit que tous les adaptateurs de médiation sont initialisés.

Charger l'annonce interstitielle

Pour charger une annonce interstitielle, la méthode statique Load() doit être utilisée sur la classe InterstitialAd. La méthode de chargement nécessite un ID de bloc d'annonces, un objet AdManagerAdRequest et un gestionnaire d'achèvement appelé lorsque le chargement de l'annonce réussit ou échoue. L'objet AdManagerInterstitialAd chargé est fourni en tant que paramètre dans le gestionnaire d'achèvement. L'exemple suivant charge AdManagerInterstitialAd :

// Create our request used to load the ad.
var adRequest = new AdRequest();

// Send the request to load the ad.
InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd ad, LoadAdError error) =>
{
    if (error != null)
    {
        // The ad failed to load.
        return;
    }
    // The ad loaded successfully.
});

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

Afficher l'annonce interstitielle

Pour afficher une annonce interstitielle chargée, appelez la méthode Show() sur l'instance AdManagerInterstitialAd. Les annonces peuvent être diffusées une fois par chargement. Utilisez la méthode CanShowAd() pour vérifier que l'annonce est prête à être diffusée.

if (interstitialAd != null && interstitialAd.CanShowAd())
{
    interstitialAd.Show();
}

Écouter les événements d'annonces interstitielles

Pour personnaliser davantage le comportement de votre annonce, vous pouvez l'associer à un certain nombre d'événements de son cycle de vie. L'exemple suivant écoute les événements d'annonce :

interstitialAd.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
interstitialAd.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
interstitialAd.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
interstitialAd.OnAdFullScreenContentOpened += () =>
{
    // Raised when the ad opened full screen content.
};
interstitialAd.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
    // Raised when the ad failed to open full screen content.
};

Nettoyer l'annonce interstitielle

Lorsque vous avez terminé d'utiliser un AdManagerInterstitialAd, veillez à appeler la méthode Destroy() avant de supprimer la référence à cet objet :

if (interstitialAd != null)
{
    interstitialAd.Destroy();
}

Cela indique au plug-in que l'objet n'est plus utilisé et que la mémoire qu'il occupe peut être récupérée. Si vous n'appelez pas cette méthode, des fuites de mémoire se produiront.

Précharger l'annonce interstitielle suivante

Les annonces interstitielles sont des objets à usage unique. Cela signifie qu'une fois qu'une annonce interstitielle est diffusée, l'objet ne peut plus être utilisé. Pour demander une autre annonce interstitielle, créez un objet AdManagerInterstitialAd.

Pour préparer une annonce interstitielle pour la prochaine opportunité d'impression, préchargez-la une fois que l'événement d'annonce OnAdFullScreenContentClosed ou OnAdFullScreenContentFailed est déclenché.

interstitialAd.OnAdFullScreenContentClosed += () =>
{
    // Reload the ad so that we can show another as soon as possible.
    var adRequest = new AdRequest();
    InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd ad, LoadAdError error) =>
    {
        // Handle ad loading here.
    });
};

Bonnes pratiques

Déterminez si les annonces interstitielles sont adaptées à votre application.
Les annonces interstitielles sont plus efficaces dans les applications qui comportent des points de transition naturels. La finalisation d'une tâche dans l'application (partager une image, terminer un niveau dans un jeu, etc.) peut constituer un point de transition. Veillez à déterminer à quels moments du parcours de votre application il est préférable d'afficher des annonces interstitielles et comment l'utilisateur est susceptible de réagir.
Mettez l'action en pause lorsque vous affichez une annonce interstitielle.
Il existe plusieurs types d'annonces interstitielles, comme les annonces textuelles, illustrées ou vidéo. Lorsque votre application affiche une annonce interstitielle, il est important qu'elle suspende également l'utilisation de certaines ressources pour permettre à l'annonce d'en profiter. Par exemple, lorsque vous appelez l'affichage d'une annonce interstitielle, veillez à mettre en pause toute sortie audio produite par votre application. Vous pouvez reprendre la lecture des sons dans l'événement OnAdFullScreenContentClosed(), qui peut être appelé lorsque l'utilisateur a fini d'interagir avec l'annonce. En outre, envisagez d'interrompre temporairement les tâches de calcul intensives, telles qu'une boucle de jeu, pendant la diffusion de l'annonce. Cela permet d'éviter que l'utilisateur ne soit confronté à des graphismes lents ou qui ne répondent pas, ou à des vidéos saccadées.
Ne submergez pas l'utilisateur d'annonces.
Même si le fait d'augmenter la fréquence des annonces interstitielles dans votre appli peut sembler être un excellent moyen d'augmenter vos revenus, cela peut également dégrader l'expérience utilisateur et réduire les taux de clics. Assurez-vous que les utilisateurs ne sont pas interrompus si souvent qu'ils ne peuvent plus profiter de votre application.

Ressources supplémentaires