Migrasi SDK

Terakhir diperbarui: Februari 2023

Halaman ini membahas migrasi untuk versi saat ini dan sebelumnya.

Bermigrasi dari versi 7 ke versi 8

Format Layar Penuh kini menggunakan metode pemuatan statis

Pada plugin versi 7, iklan interstisial dan iklan reward memiliki metode LoadAd() level instance untuk memuat iklan, sedangkan iklan interstisial reward dan iklan di layar pembuka aplikasi memiliki metode Load() statis untuk memuat iklan. Pada versi 8, semua format iklan layar penuh (interstisial, reward, interstisial reward, dan layar pembuka aplikasi) akan memiliki metode Load() statis untuk memuat iklan. Berikut contoh cara memuat iklan interstisial:

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

Berikut contoh cara memuat iklan reward:

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

Gunakan CanShowAd() untuk memeriksa kesiapan dalam menampilkan iklan layar penuh

Pada versi 7, iklan layar penuh (iklan interstisial, reward, interstisial reward, dan di layar pembuka aplikasi) memiliki metode IsLoaded() yang menampilkan true jika iklan dimuat. Karena perubahan pada cara pemuatan iklan, pada versi 8 Anda tidak memiliki akses ke objek iklan layar penuh hingga iklan dimuat, sehingga metode IsLoaded() tidak digunakan lagi.

Versi 8 memiliki metode baru bernama CanShowAd() yang menampilkan true jika iklan masih dapat ditampilkan. Berikut adalah contoh cara menggunakan CanShowAd() pada iklan interstisial:

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

Menggunakan Tampilkan(Tindakan) untuk menampilkan iklan reward

Pada plugin versi 7, iklan reward memiliki metode Show() dengan peristiwa OnUserEarnedReward yang terpisah untuk menangani sinyal reward pengguna, dan iklan interstisial reward memiliki metode Show(Action<Reward>) dengan callback untuk menangani sinyal reward pengguna. Pada versi 8, format iklan interstisial reward dan reward akan memiliki metode Show(Action<Reward>) dengan callback untuk menangani notifikasi reward pengguna.

Berikut contoh cara menampilkan iklan reward:

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

Delegasi peristiwa iklan kini mengadopsi argumen jenis tertentu

Dalam API versi 7, kami menggunakan EventHandlers saat menentukan delegasi peristiwa. Pada versi 8, kami mengadopsi delegasi generik untuk peristiwa iklan. Akibatnya, peristiwa sekarang akan memunculkan nilai peristiwa secara langsung tanpa digabungkan dalam class EventArg.

Berikut adalah contoh penggunaan OnAdPaid (sebagai pengganti 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;
    };
}

Format iklan kini sesuai dengan antarmuka yang seragam

Dalam plugin versi 7, ada perbedaan nama peristiwa di antara format iklan layar penuh. Di versi 8, kami telah mengganti nama banyak metode API agar konsisten di seluruh format iklan kami.

Tabel berikut mencantumkan perubahan class yang diperkenalkan di v8.