Миграция SDK, Миграция SDK

Последнее обновление: февраль 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 напрямую.