Migrer les versions du SDK

Sélectionnez une plate-forme : Android iOS Unity

Dernière mise à jour : février 2023

Cette page traite des migrations pour les versions actuelles et précédentes.

Migrer de la version 7 à la version 8

Les formats plein écran utilisent désormais une méthode de chargement statique

Dans la version 7 du plug-in, les annonces interstitielles et avec récompense disposaient d'une méthode LoadAd() au niveau de l'instance pour charger une annonce, tandis que les annonces interstitielles avec récompense et à l'ouverture d'une application disposaient d'une méthode Load() statique pour charger les annonces. Dans la version 8, tous les formats d'annonces plein écran (interstitielles, avec récompense, interstitielles avec récompense et à l'ouverture d'une application) disposeront d'une méthode Load() statique pour charger les annonces. Voici un exemple de chargement d'une annonce interstitielle :

Version 8 (actuelle)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadAd()
{
    // Load an interstitial ad
    InterstitialAd.Load(adUnitId, new AdRequest(),
        (InterstitialAd ad, LoadAdError loadAdError) =>
        {
            if (loadAdError != null)
            {
                Debug.Log("Interstitial ad failed to load with error: " +
                           loadAdError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Interstitial ad failed to load.");
                return;
            }

            Debug.Log("Interstitial ad loaded.");
            _interstitialAd = ad;
        });
}

Version 7 (ancienne)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadInterstitialAd()
{
    // Initialize an InterstitialAd.
    _interstitialAd = new InterstitialAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _interstitialAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _interstitialAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _interstitialAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Interstitial ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Interstitial ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

Voici un exemple de chargement d'une annonce avec récompense :

Version 8 (actuelle)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Load a rewarded ad
    RewardedAd.Load(adUnitId, new AdRequest(),
        (Rewarded ad, LoadAdError loadError) =>
        {
            if (loadError != null)
            {
                Debug.Log("Rewarded ad failed to load with error: " +
                           loadError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Rewarded ad failed to load.");
                    return;
            }

            Debug.Log("Rewarded ad loaded.");
            _rewardedAd = ad;
        });
}

Version 7 (ancienne)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Initialize an InterstitialAd.
    _rewardedAd = new RewardedAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _rewardedAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _rewardedAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _rewardedAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Rewarded ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Rewarded ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

Utiliser CanShowAd() pour vérifier si les annonces plein écran sont prêtes à être diffusées

Dans la version 7, les annonces plein écran (interstitielles, avec récompense, interstitielles avec récompense et à l'ouverture d'une application) disposaient de la méthode IsLoaded(), qui renvoyait true si l'annonce était chargée. En raison de la modification du mode de chargement des annonces, dans la version 8, vous n'avez pas accès à l'objet d'annonce plein écran tant que l'annonce n'est pas chargée, ce qui rend la méthode IsLoaded() obsolète.

La version 8 dispose d'une nouvelle méthode nommée CanShowAd() qui renvoie true si l'annonce peut toujours être diffusée. Voici un exemple d'utilisation de CanShowAd() sur une annonce interstitielle :

Version 8 (actuelle)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.CanShowAd())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad cannot be shown.");
    }
}

Version 7 (ancienne)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.IsLoaded())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad is not ready yet.");
    }
}

Utiliser Show(Action) pour afficher des annonces avec récompense

Dans la version 7 du plug-in, les annonces avec récompense disposaient de la Show() méthode avec un événement OnUserEarnedReward distinct pour gérer les signaux de récompense de l'utilisateur, et l' annonce interstitielle avec récompense disposait d'une Show(Action<Reward>) méthode avec un rappel pour gérer le signal de récompense de l'utilisateur. Dans la version 8, les formats d'annonces avec récompense et interstitielles avec récompense disposeront d'une méthode Show(Action<Reward>) avec un rappel pour gérer la notification de récompense de l'utilisateur.

Voici un exemple d'affichage d'une annonce avec récompense :

Version 8 (actuelle)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.Show((Reward reward) =>
        {
            Debug.Log("Rewarded ad granted a reward: " +
                    reward.Amount);
        });
    }
    else
    {
        Debug.Log("Rewarded ad cannot be shown.");
    }
}

Version 7 (ancienne)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.OnUserEarnedReward += HandleUserEarnedReward;
        _rewardedAd.Show();
    }
    else
    {
        Debug.Log("Rewarded ad is not ready yet.");
    }
}
public void HandleUserEarnedReward(object sender, Reward reward)
{
    Debug.Log("Rewarded ad granted a reward: " +
               reward.Amount);
}

Les délégués d'événements d'annonces adoptent désormais des arguments de type spécifiques

Dans la version 7 de l'API, nous avons utilisé EventHandlers lors de la définition des délégués d'événements. Dans la version 8, nous avons adopté des délégués génériques pour les événements d'annonces. Par conséquent, les événements émettent désormais directement des valeurs d'événements sans être encapsulés dans la classe EventArg.

Voici un exemple d'utilisation de OnAdPaid (au lieu de OnPaidEvent) :

Version 8 (actuelle)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnAdPaid += (AdValue value) =>
    {
        AdValue value = value;
    };
}

Version 7 (ancienne)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
    {
        AdValue value = arg.Value;
    };
}

Les formats d'annonces sont désormais conformes à une interface uniforme

Dans la version 7 du plug-in, il existait des différences dans les noms d'événements entre les formats d'annonces plein écran. Dans la version 8, nous avons renommé de nombreuses méthodes d'API pour qu'elles soient cohérentes dans tous nos formats d'annonces.

Le tableau suivant répertorie les modifications de classe introduites dans la version 8.

BannerView
v7v8
OnAdLoaded OnBannerAdLoaded
OnAdFailedToLoad OnBannerAdLoadFailed
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnPaidEvent OnAdPaid
InterstitialAd
LoadAd() InterstitialAd.Load()
InterstitialAd() InterstitialAd.Load()
OnAdLoaded InterstitialAd.Load()
OnAdFailedToLoad InterstitialAd.Load()
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
OnPaidEvent OnAdPaid
RewardedAd
LoadAd() RewardedAd.Load()
RewardedAd() RewardedAd.Load()
OnAdLoaded RewardedAd.Load()
OnAdFailedToLoad RewardedAd.Load()
OnAdOpening OnAdFullScreenContentOpened
OnAdClosed OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
OnPaidEvent OnAdPaid
Show() Show()
OnUserEarnedReward Show()
RewardedInterstitialAd
LoadAd() RewardedInterstitialAd.Load()
OnPaidEvent OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
AppOpenAd
LoadAd() AppOpenAd.Load()
OnPaidEvent OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFailed
OnAdDidRecordImpression OnAdImpressionRecorded
AdErrorEventArgs
AdErrorEventArgs.AdError Utiliser AdError directement.
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError Utiliser LoadAdError directement.
AdValueEventArgs
AdValueEventArgs.AdValue Utiliser AdValue directement.