Annonces interstitielles

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity Flutter

Les annonces interstitielles s'affichent en plein écran, recouvrant l'interface de l'application hôte. Elles sont généralement diffusées lors de points de transition naturels, par exemple pendant la pause entre les niveaux du jeu. Lorsqu'une application diffuse une annonce interstitielle, l'utilisateur peut appuyer dessus 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 tests plutôt que des annonces de production pour chaque requête, ce qui le rend sûr à utiliser.

Toutefois, une fois que vous avez 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 comme appareil de testlors du développement.

/21775744923/example/interstitial

Initialiser Google Mobile Ads Unity Plugin

Avant de charger les 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 garantira 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.
});
InterstitialAdSnippets.cs

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

**Avertissement** : Il est fortement déconseillé de tenter de charger une nouvelle annonce à partir du bloc d'achèvement de la demande d'annonce lorsqu' une annonce n'a pas pu être chargée. Si vous devez charger une annonce à partir du bloc d'achèvement de la demande d'annonce, limitez les tentatives de chargement d'annonces pour éviter les échecs continus de demandes d'annonces dans des situations telles qu'une connectivité réseau limitée.

Conseil : Vous pouvez utiliser des appels de chargement d'annonces pour créer un cache d'annonces préchargées avant de les diffuser, afin qu'elles puissent s'afficher sans latence en cas de besoin. Comme les annonces expirent au bout d'une heure, vous devez vider ce cache et recharger de nouvelles annonces toutes les heures.

Diffuser l'annonce interstitielle

Pour diffuser 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.

Remarque : Les annonces interstitielles doivent être diffusées lors de pauses naturelles dans le flux d' une application, par exemple entre les niveaux d'un jeu ou une fois que l'utilisateur a terminé une tâche.

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

Écouter les événements d'annonces interstitielles

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

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.
};
InterstitialAdSnippets.cs

Nettoyer l'annonce interstitielle

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

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

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.
    });
};
InterstitialAdSnippets.cs

Bonnes pratiques

Déterminez si les annonces interstitielles sont le type d'annonce adapté à votre application.

Les annonces interstitielles fonctionnent mieux dans les applications comportant des points de transition naturels. La fin d'une tâche dans une application, comme le partage d'une image ou la fin d'un niveau de jeu, crée un tel point. Veillez à déterminer à quels moments du flux de votre application il est préférable de diffuser des annonces interstitielles et comment l'utilisateur est susceptible de réagir.

Mettez l'action en pause lorsque vous diffusez une annonce interstitielle.

Il existe plusieurs types d'annonces interstitielles, comme les annonces textuelles, illustrées ou vidéo. Il est important de s'assurer que lorsque votre application diffuse une annonce interstitielle, elle suspend également l'utilisation de certaines ressources pour permettre à l'annonce d'en profiter. Par exemple, lorsque vous appelez l'annonce pour diffuser 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 terminé 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. Ainsi, l'utilisateur ne verra pas de graphismes lents ou qui ne répondent pas, ni de vidéos saccadées.

N'inondez pas les utilisateurs d'annonces.

Même si le fait d'augmenter la fréquence des annonces interstitielles dans votre application 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. Veillez à ce que les utilisateurs ne soient pas interrompus trop fréquemment, car ils risquent de ne plus pouvoir profiter de votre application.

Ressources supplémentaires

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