Последнее обновление: февраль 2023 г.
На этой странице описаны миграции для текущей и предыдущих версий.
Переход с версии 7 на версию 8
Полноэкранные форматы теперь используют метод статической загрузки.
В версии 7 плагина межстраничная реклама и реклама с вознаграждением имели метод LoadAd() уровня экземпляра для загрузки рекламы, тогда как межстраничная реклама с вознаграждением и объявления при открытии приложения имели статический метод Load() для загрузки рекламы. В версии 8 все полноэкранные форматы рекламы (межстраничная, с вознаграждением, межстраничная с вознаграждением и открытая в приложении) будут иметь статический метод Load() для загрузки рекламы. Вот пример загрузки межстраничной рекламы:
Версия 8 (текущая)
#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;
});
}
Версия 7 (устаревшая)
#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());
}
}
Вот пример загрузки объявления с вознаграждением:
Версия 8 (текущая)
// 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;
});
}
Версия 7 (устаревшая)
// 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());
}
}
Используйте CanShowAd() для проверки готовности к показу полноэкранной рекламы.
В версии 7 полноэкранные объявления (межстраничные объявления, объявления с вознаграждением, межстраничные объявления с вознаграждением и объявления при открытии приложения) имели метод IsLoaded() , который возвращает true , если объявление было загружено. Из-за изменения способа загрузки рекламы в версии 8 у вас нет доступа к объекту полноэкранной рекламы до тех пор, пока реклама не загрузится, что делает метод IsLoaded() устаревшим.
В версии 8 появился новый метод CanShowAd() , который возвращает true , если рекламу все еще можно показать. Вот пример использования CanShowAd() для межстраничной рекламы:
Версия 8 (текущая)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.CanShowAd())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad cannot be shown.");
}
}
Версия 7 (устаревшая)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.IsLoaded())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad is not ready yet.");
}
}
Используйте Показать(Действие ) для показа рекламы с вознаграждением
В версии 7 плагина объявления с вознаграждением имели метод Show() с отдельным событием OnUserEarnedReward для обработки сигналов вознаграждения пользователя, а межстраничное объявление с вознаграждением имело метод Show(Action<Reward>) с обратным вызовом для обработки вознаграждения пользователя. сигнал. В версии 8 форматы межстраничных объявлений с вознаграждением и с вознаграждением будут иметь метод Show(Action<Reward>) с обратным вызовом для обработки уведомления о вознаграждении пользователя.
Вот пример того, как показывать рекламу с вознаграждением:
Версия 8 (текущая)
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.");
}
}
Версия 7 (устаревшая)
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);
}
Делегаты рекламных событий теперь принимают аргументы определенного типа.
В версии 7 API мы использовали EventHandlers при определении делегатов событий. В версии 8 мы приняли общие делегаты для рекламных событий. В результате события теперь будут генерировать значения событий напрямую, без упаковки в класс EventArg .
Вот пример использования OnAdPaid (вместо OnPaidEvent ):
Версия 8 (текущая)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnAdPaid += (AdValue value) =>
{
AdValue value = value;
};
}
Версия 7 (устаревшая)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
{
AdValue value = arg.Value;
};
}
Форматы объявлений теперь соответствуют единому интерфейсу.
В 7 версии плагина были расхождения в названиях событий между форматами полноэкранной рекламы. В версии 8 мы переименовали многие методы API, чтобы обеспечить единообразие всех форматов объявлений.
В следующей таблице перечислены изменения классов, представленные в версии 8.
BannerView | |
|---|---|
| v7 | v8 |
| OnAdLoaded | OnBannerAdLoaded |
| Онадфаиледтолоад | Онбаннерадлоадфаилед |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnPaidEvent | OnAdPaid |
InterstitialAd | |
| ЗагрузитьОбъявление() | Межстраничная реклама.Load() |
| Межстраничное объявление() | Межстраничная реклама.Load() |
| OnAdLoaded | Межстраничная реклама.Load() |
| Онадфаиледтолоад | Межстраничная реклама.Load() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| Онадфаиледтошоу | Онадфуллскринконтентфаилед |
| Онаддидрекордимпрессион | Онадимпрессионрекордед |
| OnPaidEvent | OnAdPaid |
RewardedAd | |
| ЗагрузитьОбъявление() | ВознагражденноеОбъявление.Загрузка() |
| Объявление с вознаграждением() | ВознагражденноеОбъявление.Загрузка() |
| OnAdLoaded | ВознагражденноеОбъявление.Загрузка() |
| Онадфаиледтолоад | ВознагражденноеОбъявление.Загрузка() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| Онадфаиледтошоу | Онадфуллскринконтентфаилед |
| Онаддидрекордимпрессион | Онадимпрессионрекордед |
| OnPaidEvent | OnAdPaid |
| Показывать() | Показывать() |
| OnUserEarnedReward | Показывать() |
RewardedInterstitialAd | |
| ЗагрузитьОбъявление() | Вознаграждённое межстраничное объявление.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | Онадфуллскринконтентфаилед |
| Онаддидрекордимпрессион | Онадимпрессионрекордед |
AppOpenAd | |
| ЗагрузитьОбъявление() | AppOpenAd.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | Онадфуллскринконтентфаилед |
| Онаддидрекордимпрессион | Онадимпрессионрекордед |
AdErrorEventArgs | |
| AdErrorEventArgs.AdError | Используйте AdError напрямую. |
AdFailedToLoadEventArgs | |
| AdFailedToLoadEventArgs.LoadAdError | Используйте LoadAdError напрямую. |
AdValueEventArgs | |
| AdValueEventArgs.AdValue | Используйте AdValue напрямую. |