Esta página foi traduzida pela API Cloud Translation.

Migração do SDK

Última atualização: fevereiro de 2023

Nesta página, você encontra informações sobre migrações da versão atual e das anteriores.

Migrar da versão 7 para a versão 8

Os formatos de tela cheia agora usam um método de carregamento estático

Na versão 7 do plug-in, os anúncios intersticiais e premiados tinham um método LoadAd() no nível da instância para carregar um anúncio, enquanto os anúncios intersticiais premiados e de abertura do app tinham um método Load() estático para carregar anúncios. Na versão 8, todos os formatos de anúncio em tela cheia (intersticial, premiado, intersticial premiado e de abertura do app) terão um método Load() estático para carregar anúncios. Confira um exemplo de como carregar um anúncio intersticial:

Versão 8 (atual)

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

Versão 7 (legada)

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

Confira um exemplo de como carregar um anúncio premiado:

Versão 8 (atual)

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

Versão 7 (legada)

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

Use CanShowAd() para verificar a prontidão para exibir anúncios em tela cheia

Na versão 7, os anúncios em tela cheia (intersticiais, premiados, intersticiais premiados e de abertura do app) tinham o método IsLoaded(), que retornava true quando o anúncio foi carregado. Devido à mudança na forma como os anúncios são carregados, na versão 8, não é possível acessar o objeto de anúncio em tela cheia até que ele seja carregado, o que torna o método IsLoaded() obsoleto.

A versão 8 tem um novo método chamado CanShowAd(), que retorna true se o anúncio ainda puder ser mostrado. Confira um exemplo de como usar CanShowAd() em um anúncio intersticial:

Versão 8 (atual)

private InterstitialAd _interstitalAd;

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

Versão 7 (legada)

private InterstitialAd _interstitalAd;

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

Use Show(Action) para exibir anúncios premiados

Na versão 7 do plug-in, os anúncios premiados tinham o método Show() com um evento OnUserEarnedReward separado para processar os indicadores de recompensa do usuário, e o anúncio intersticial premiado tinha um método Show(Action<Reward>) com um callback para processar o indicador. Na versão 8, os formatos de anúncios intersticiais premiados e premiados terão um método Show(Action<Reward>) com um callback para processar a notificação de recompensa do usuário.

Confira um exemplo de como exibir um anúncio premiado:

Versão 8 (atual)

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

Versão 7 (legada)

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

Os delegados de eventos de anúncio agora adotam argumentos de tipo específico

Na versão 7 da API, usamos EventHandlers ao definir delegados de eventos. Na versão 8, adotamos delegados genéricos para eventos de anúncios. Como resultado, os eventos agora vão emitir valores de evento diretamente, sem serem agrupados na classe EventArg.

Este é um exemplo de como usar OnAdPaid (no lugar de OnPaidEvent):

Versão 8 (atual)

private BannerView _bannerView;

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

Versão 7 (legada)

private BannerView _bannerView;

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

Os formatos de anúncios agora estão em conformidade com uma interface uniforme

Na versão 7 do plug-in, havia discrepâncias nos nomes de eventos entre os formatos de anúncios em tela cheia. Na versão 8, renomeamos muitos dos nossos métodos de API para manter a consistência em todos os formatos de anúncios.

A tabela a seguir lista as alterações de classe introduzidas na v8.

`BannerView`
v7	v8
OnAdLoaded	OnBannerAdLoaded
OnAdFailedToLoad	OnBannerAdLoadFailed
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnPaidEvent	OnAdPaid
`InterstitialAd`
Função LoadAd()	InterstitialAd.Load()
InterstitialAd()	InterstitialAd.Load()
OnAdLoaded	InterstitialAd.Load()
OnAdFailedToLoad	InterstitialAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
`RewardedAd`
Função LoadAd()	RewardedAd.Load()
PremiadoAd()	RewardedAd.Load()
OnAdLoaded	RewardedAd.Load()
OnAdFailedToLoad	RewardedAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
Função()	Show() (link em inglês)
OnUserEarnedReward	Show() (link em inglês)
`RewardedInterstitialAd`
Função LoadAd()	RewardedInterstitialAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
`AppOpenAd`
Função LoadAd()	AppOpenAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
`AdErrorEventArgs`
AdErrorEventArgs.AdError	Use AdError diretamente.
`AdFailedToLoadEventArgs`
AdFailedToLoadEventArgs.LoadAdError	Use LoadAdError diretamente.
`AdValueEventArgs`
AdValueEventArgs.AdValue	Use AdValue diretamente.