Ostatnia aktualizacja: luty 2023 r.
Na tej stronie znajdziesz informacje o migracjach w przypadku bieżących i poprzednich wersji.
Migracja z wersji 7 do wersji 8
Formaty pełnoekranowe korzystają teraz ze statycznej metody wczytywania
W wersji 7 wtyczki reklamy pełnoekranowe i reklamy z nagrodą miały metodę LoadAd() na poziomie instancji do wczytywania reklamy, a reklamy pełnoekranowe z nagrodą i reklamy otwierane w aplikacji miały statyczną metodę Load() do wczytywania reklam. W wersji 8 wszystkie formaty reklam pełnoekranowych (reklamy pełnoekranowe, reklamy z nagrodą, reklamy pełnoekranowe z nagrodą i reklamy wyświetlane przy otwarciu aplikacji) będą miały statyczną metodę Load() wczytywania reklam. Oto przykład wczytywania reklamy pełnoekranowej:
Wersja 8 (obecna)
#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;
});
}
Wersja 7 (starsza)
#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());
}
}
Oto przykład wczytywania reklamy z nagrodą:
Wersja 8 (obecna)
// 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;
});
}
Wersja 7 (starsza)
// 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());
}
}
Używanie funkcji CanShowAd() do sprawdzania gotowości do wyświetlania reklam pełnoekranowych
W wersji 7 reklamy pełnoekranowe (pełnoekranowe, z nagrodą, pełnoekranowe z nagrodą i wyświetlane przy otwarciu aplikacji) miały metodę IsLoaded(), która zwracała wartość true, jeśli reklama została wczytana. W wersji 8 ze względu na zmianę sposobu wczytywania reklam nie masz dostępu do obiektu reklamy pełnoekranowej, dopóki reklama nie zostanie wczytana, co sprawia, że metoda IsLoaded() jest przestarzała.
Wersja 8 zawiera nową metodę o nazwie CanShowAd(), która zwraca wartość true, jeśli reklama nadal może się wyświetlać. Oto przykład użycia parametru CanShowAd() w reklamie pełnoekranowej:
Wersja 8 (obecna)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.CanShowAd())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad cannot be shown.");
}
}
Wersja 7 (starsza)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.IsLoaded())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad is not ready yet.");
}
}
Wyświetlanie reklam z nagrodą za pomocą funkcji Show(Action)
W wersji 7 wtyczki reklamy z nagrodą miały metodę Show() z oddzielnym zdarzeniem OnUserEarnedReward do obsługi sygnałów nagrody dla użytkownika, a reklama pełnoekranowa z nagrodą miała metodę Show(Action<Reward>) z wywołaniem zwrotnym do obsługi sygnału nagrody dla użytkownika. W wersji 8 formaty reklam z nagrodą i reklam pełnoekranowych z nagrodą będą miały metodę Show(Action<Reward>) z wywołaniem zwrotnym do obsługi powiadomienia o nagrodzie dla użytkownika.
Oto przykład, jak wyświetlić reklamę z nagrodą:
Wersja 8 (obecna)
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.");
}
}
Wersja 7 (starsza)
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);
}
Delegaty zdarzeń reklamowych przyjmują teraz argumenty określonego typu
W wersji 7 interfejsu API podczas definiowania delegatów zdarzeń używaliśmy EventHandlers. W wersji 8 wprowadziliśmy ogólne delegaty w przypadku zdarzeń związanych z reklamami. W rezultacie zdarzenia będą teraz emitować wartości zdarzeń bezpośrednio, bez opakowywania ich w klasę EventArg.
Oto przykład użycia właściwości OnAdPaid (zamiast OnPaidEvent):
Wersja 8 (obecna)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnAdPaid += (AdValue value) =>
{
AdValue value = value;
};
}
Wersja 7 (starsza)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
{
AdValue value = arg.Value;
};
}
Formaty reklam mają teraz jednolity interfejs
W wersji 7 wtyczki występowały rozbieżności w nazwach zdarzeń w przypadku formatów reklam pełnoekranowych. W wersji 8 zmieniliśmy nazwy wielu metod interfejsu API, aby były spójne w różnych formatach reklam.
W tabeli poniżej znajdziesz zmiany w klasach wprowadzone w wersji 8.
BannerView | |
|---|---|
| wersja 7 | 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 | Użyj bezpośrednio AdError. |
AdFailedToLoadEventArgs | |
| AdFailedToLoadEventArgs.LoadAdError | Użyj bezpośrednio LoadAdError. |
AdValueEventArgs | |
| AdValueEventArgs.AdValue | Użyj bezpośrednio AdValue. |