Dernière mise à jour: février 2023
Cette page présente les migrations pour les versions actuelles et antérieures.
Passer 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 comportaient une méthode LoadAd()
au niveau de l'instance pour charger une annonce, tandis que les annonces interstitielles avec récompense et les annonces à l'ouverture d'une application comportaient une méthode Load()
statique pour charger les annonces. Dans la version 8, tous les formats d'annonces plein écran (interstitiels, avec récompense, interstitiels avec récompense et annonces à 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 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 vous êtes prêt à diffuser des annonces en plein écran.
Dans la version 7, les annonces plein écran (interstitiels, avec récompense, interstitiels avec récompense et annonces à l'ouverture d'une application) utilisaient la méthode IsLoaded()
qui renvoie 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 en plein écran tant que l'annonce n'est pas chargée. La méthode IsLoaded()
est donc 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 version)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.IsLoaded())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad is not ready yet.");
}
}
Utilisez "Afficher(Action)"pour diffuser des annonces avec récompense .
Dans la version 7 du plug-in, les annonces avec récompense utilisaient la méthode Show()
avec un événement OnUserEarnedReward
distinct pour gérer les signaux de récompense utilisateur, et l'annonce interstitielle avec récompense comportait 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 interstitielles avec récompense et avec récompense disposeront d'une méthode Show(Action<Reward>)
avec un rappel pour gérer la notification de récompense utilisateur.
Voici un exemple de diffusion 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 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 utilisions EventHandlers
pour définir des délégués d'événements. Dans la version 8, nous avons adopté les délégués génériques pour les événements d'annonce. Par conséquent, les événements émettent désormais directement des valeurs d'événement sans être encapsulés dans la classe EventArg
.
Voici un exemple d'utilisation de OnAdPaid
(à la place 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 suivent désormais une interface uniforme
Dans la version 7 du plug-in, il y avait des différences dans les noms d'événements entre les formats d'annonces plein écran. Dans la version 8, nous avons renommé un grand nombre de nos méthodes d'API pour assurer la cohérence entre nos formats d'annonces.
Le tableau suivant répertorie 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() |
Annonce avec récompense() | RewardedAd.Load() |
OnAdLoaded | RewardedAd.Load() |
OnAdFailedToLoad | RewardedAd.Load() |
OnAdOpening | OnAdFullScreenContentOpened |
OnAdClosed | OnAdFullScreenContentClosed |
OnAdFailedToShow | OnAdFullScreenContentFailed |
OnAdDidRecordImpression | OnAdImpressionRecorded |
OnPaidEvent | OnAdPaid |
Afficher() | Afficher() |
OnUserEarnedReward | Afficher() |
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 directement AdError. |
AdFailedToLoadEventArgs | |
AdFailedToLoadEventArgs.LoadAdError | Utilisez directement LoadAdError. |
AdValueEventArgs | |
AdValueEventArgs.AdValue | Utilisez directement AdValue. |