SDK Taşıma

Son güncelleme tarihi: Şubat 2023

Bu sayfada mevcut ve önceki sürümler için taşıma işlemleri ele alınmaktadır.

Sürüm 7'den sürüm 8'e taşıma

Tam Ekran biçimleri artık statik yükleme yöntemi kullanıyor

Eklentinin 7. sürümünde, geçiş reklamları ve ödüllü reklamlar reklam yüklemek için örnek düzeyinde LoadAd() yöntemini kullanırken ödüllü geçiş reklamı ve uygulama açılış reklamlarında reklam yüklemek için statik Load() yöntemi kullanılıyordu. Sürüm 8'de, tüm tam ekran reklam biçimlerinde (geçiş reklamı, ödüllü, ödüllü geçiş reklamı ve uygulama açılışı), reklam yüklemek için statik bir Load() yöntemi olacaktır. Aşağıda, bir geçiş reklamının nasıl yükleneceğiyle ilgili örnek verilmiştir:

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

Ödüllü reklamların nasıl yükleneceğiyle ilgili bir örnek aşağıda verilmiştir:

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

Tam ekran reklam göstermeye hazır olup olmadığını kontrol etmek için CanShowAd() işlevini kullanın.

Sürüm 7'de, tam ekran reklamlarda (geçiş reklamı, ödüllü, ödüllü geçiş reklamı ve uygulama açılış reklamları), reklam yüklendiğinde true döndüren IsLoaded() yöntemi bulunuyordu. Reklamların yüklenme yöntemindeki değişiklik nedeniyle, sürüm 8'de reklam yüklenene kadar tam ekran reklam nesnesine erişiminiz olmaz. Bu durum, IsLoaded() yöntemini geçersiz kılar.

Sürüm 8'de, reklam hâlâ gösterilebiliyorsa true değerini döndüren CanShowAd() adlı yeni bir yöntem bulunmaktadır. Aşağıda, geçiş reklamında CanShowAd() özelliğinin nasıl kullanılacağına dair bir örnek verilmiştir:

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

Ödüllü reklamları göstermek için Göster(İşlem) işlevini kullanın

Eklentinin 7. sürümünde, ödüllü reklamlar, kullanıcı ödül sinyallerini işlemek için ayrı bir OnUserEarnedReward etkinliğiyle Show() yöntemini, ödüllü geçiş reklamında ise kullanıcı ödül sinyalini işlemek için geri çağırma içeren bir Show(Action<Reward>) yöntemi bulunuyordu. Sürüm 8'de, ödüllü ve ödüllü geçiş reklamı biçimlerinde, kullanıcı ödülü bildirimini işlemek için geri çağırma içeren Show(Action<Reward>) yöntemi bulunacaktır.

Aşağıda, ödüllü reklamların nasıl gösterileceğiyle ilgili bir örnek verilmiştir:

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

Reklam etkinliği yetki verilmiş kullanıcılar için artık belirli türde bağımsız değişkenler kullanılıyor

API'nin 7. sürümünde, etkinlik için yetki verilmiş kullanıcıları tanımlarken EventHandlers kullandık. 8. sürümde, reklam etkinlikleri için genel yetki verilmiş kullanıcıları benimsedik. Sonuç olarak, etkinlikler artık etkinlik değerlerini EventArg sınıfına sarmalanmadan doğrudan yayacak.

Aşağıda, OnAdPaid özelliğinin nasıl kullanıldığına dair bir örnek verilmiştir (OnPaidEvent yerine):

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

Reklam biçimleri artık tek tip bir arayüze uyuyor

Eklentinin 7. sürümünde, tam ekran reklam biçimleri arasında etkinlik adlarında tutarsızlıklar vardı. Sürüm 8'de, API yöntemlerimizin birçoğunu reklam biçimlerimizle tutarlı olacak şekilde yeniden adlandırdık.

Aşağıdaki tabloda, v8'de kullanıma sunulan sınıf değişiklikleri listelenmiştir.