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 vers 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 les annonces App Open disposaient d'une méthode statique Load() pour charger les annonces. Dans la version 8, tous les formats d'annonce en plein écran (interstitiel, avec récompense, interstitiel avec récompense et à l'ouverture de l'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 version)
#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 version)
// 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());
}
}
Utilisez 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 chargement des annonces, vous n'avez pas accès à l'objet d'annonce en plein écran dans la version 8 tant que l'annonce n'est pas chargée, ce qui rend la méthode IsLoaded() obsolète.
La version 8 comporte 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() dans 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 version)
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 méthode Show() avec un événement OnUserEarnedReward distinct pour gérer les signaux de récompense utilisateur. L'annonce interstitielle avec récompense disposait quant à elle d'une méthode Show(Action<Reward>) avec un rappel pour gérer le signal de récompense 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 de procédure à suivre pour afficher 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 version)
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'annonce 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 émettront désormais directement des valeurs d'événement 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 version)
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, les noms d'événements des formats d'annonces plein écran étaient différents. Dans la version 8, nous avons renommé de nombreuses méthodes d'API pour assurer la cohérence entre nos formats d'annonces.
Le tableau suivant liste les modifications apportées aux classes dans la version 8.
BannerView | |
|---|---|
| v7 | v8 |
| 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 | Utilisez AdError directement. |
AdFailedToLoadEventArgs | |
| AdFailedToLoadEventArgs.LoadAdError | Utilisez directement LoadAdError. |
AdValueEventArgs | |
| AdValueEventArgs.AdValue | Utilisez directement AdValue. |