Migracja pakietów SDK

Ostatnia aktualizacja: luty 2023 r.

Ta strona dotyczy migracji w przypadku obecnej 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 wystąpienia do wczytywania reklam, a reklamy pełnoekranowe z nagrodą i reklamy otwierające aplikację miały stałą 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ą wczytywane za pomocą statycznej metody Load(). Oto przykład wczytywania reklamy pełnoekranowej:

Wersja 8 (obecna)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 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;
        });
}

#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)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()
{
    // 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;
        });
}

// 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 metody 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 true, jeśli reklama została wczytana. Ze względu na zmianę sposobu wczytywania reklam w wersji 8 nie masz dostępu do obiektu reklamy pełnoekranowej, dopóki reklama nie zostanie załadowana, co powoduje, że metoda IsLoaded() stała się nieaktualna.

Wersja 8 zawiera nową metodę o nazwie CanShowAd(), która zwraca wartość true, jeśli reklama może być nadal wyświetlana. Oto przykład użycia właściwości CanShowAd() w reklamie pełnoekranowej:

Wersja 8 (obecna)Wersja 7 (starsza)
private InterstitialAd _interstitalAd;

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


private InterstitialAd _interstitalAd;

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

Używanie funkcji Show(Action)do wyświetlania reklam z nagrodą

W wersji 7 wtyczki reklamy z nagrodą miały metodę Show() z oddzielnym zdarzeniem OnUserEarnedReward do obsługi sygnałów o nagrodzie dla użytkownika, a reklamy przejściowe z nagrodą – metodę Show(Action<Reward>) z metodą wywołania zwrotnego do obsługi sygnału o nagrodzie 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 funkcją wywołania zwrotnego do obsługi powiadomienia o nagrodach dla użytkownika.

Oto przykład wyświetlania reklamy z nagrodą:

Wersja 8 (obecna)Wersja 7 (starsza)
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.");
    }
}


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);
}

Delegowanie zdarzeń reklamowych korzysta teraz z argumentów o określonym typie

W wersji 7 interfejsu API użyliśmy funkcji EventHandlersdo definiowania delegowanych zdarzeń. W wersji 8 zastosowaliśmy generyczne delegowanie zdarzeń reklamowych. W rezultacie wartości zdarzeń będą teraz emitowane bezpośrednio, bez owijania ich w klasę EventArg.

Oto przykład użycia właściwości OnAdPaid (zamiast OnPaidEvent):

Wersja 8 (obecna)Wersja 7 (starsza)
private BannerView _bannerView;

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

private BannerView _bannerView;

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

Formaty reklam są teraz zgodne z jednolitym interfejsem

W wersji 7 plugina występowały rozbieżności w nazwach zdarzeń dotyczących formatów reklam pełnoekranowych. W wersji 8 zmieniliśmy nazwy wielu metod interfejsu API, aby zachować spójność w różnych formatach reklam.

W tabeli poniżej znajdziesz zmiany klas wprowadzone w wersji 8.

BannerView
wersja 7v8
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 właściwości AdError.
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError Użyj bezpośrednio błędu LoadAdError.
AdValueEventArgs
AdValueEventArgs.AdValue Użyj bezpośrednio atrybutu AdValue.