Migracja pakietów SDK

Ostatnia aktualizacja: luty 2023 r.

Ta strona zawiera informacje na temat migracji obecnej i poprzednich wersji.

Migracja z wersji 7 do 8

Formaty pełnoekranowe korzystają teraz ze statycznej metody wczytywania

W wersji 7 wtyczki reklamy pełnoekranowe i reklamy z nagrodą korzystały z metody LoadAd() na poziomie instancji, a reklamy pełnoekranowe z nagrodą i reklamy wyświetlane przy otwarciu aplikacji miały statyczną metodę Load() ładowania reklam. W wersji 8 wszystkie formaty reklam pełnoekranowych (pełnoekranowe, z nagrodą, pełnoekranowe z nagrodą i reklamy przy otwarciu aplikacji) będą zawierały statyczną metodę Load() do wczytywania reklam. Oto przykład wczytywania reklamy pełnoekranowej:

#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ą:

// 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żyj CanShowAd(), aby sprawdzić gotowość do wyświetlania reklam pełnoekranowych

W wersji 7 reklamy pełnoekranowe (pełnoekranowe, z nagrodą, pełnoekranowe z nagrodą i reklamy wyświetlane przy otwarciu aplikacji) korzystały z metody IsLoaded(), która zwraca wartość 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 do momentu wczytania reklamy, przez co metoda IsLoaded() jest przestarzała.

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

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

Aby wyświetlać reklamy z nagrodą, użyj opcji Pokaż(działanie).

W wersji 7 wtyczki reklamy z nagrodą miały metodę Show() z osobnym zdarzeniem OnUserEarnedReward do obsługi sygnałów nagrody dla użytkownika, a reklama pełnoekranowa z nagrodą używała metody Show(Action<Reward>) z wywołaniem zwrotnym do obsługi sygnału nagrody dla użytkownika. W wersji 8 formaty reklam pełnoekranowych z nagrodą i reklam pełnoekranowych z nagrodą będą zawierać metodę Show(Action<Reward>) z wywołaniem zwrotnym do obsługi powiadomień o nagrodzie dla użytkownika.

Oto przykład, jak wyświetlić reklamę z nagrodą:

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

Przedstawiciele zdarzeń reklamowych przyjmują teraz argumenty określonego typu

W wersji 7 interfejsu API do definiowania przedstawicieli zdarzeń użyliśmy EventHandlers. W wersji 8 wprowadziliśmy ogólnych przedstawicieli obsługi zdarzeń reklamowych. W rezultacie zdarzenia będą teraz bezpośrednio emitować wartości zdarzeń bez umieszczania ich w klasie EventArg.

Oto przykład użycia OnAdPaid (zamiast OnPaidEvent):

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 dopasowują się teraz do jednolitego interfejsu

W wersji 7 wtyczki występowały rozbieżności w nazwach zdarzeń między formatami reklam pełnoekranowych. W wersji 8 zmieniliśmy nazwy wielu metod interfejsu API, aby zapewnić spójność w formatach reklam.

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