Son güncelleme: Şubat 2023
Bu sayfada, mevcut ve önceki sürümler için yapılan taşımalar ele alınmaktadır.
7. sürümden 8. sürüme taşıma
Tam ekran biçimleri artık statik yükleme yöntemini kullanıyor
Eklentinin 7. sürümünde, geçiş reklamları ve ödüllü reklamlar için reklam yüklemeye yönelik bir örnek düzeyi
LoadAd() yöntemi bulunurken ödüllü geçiş reklamları ve uygulama
açılış reklamları için reklam yüklemeye yönelik statik bir Load() yöntemi vardı. 8. sürümde tüm tam ekran reklam biçimleri (geçiş reklamı, ödüllü reklam, ödüllü geçiş reklamı ve uygulama açılış reklamı) reklam yüklemek için statik bir Load() yöntemine sahip olacak. Geçiş reklamının nasıl yükleneceğine dair bir örneği aşağıda bulabilirsiniz:
8. sürüm (mevcut)
#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;
});
}
Sürüm 7 (Eski)
#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());
}
}
Aşağıda, ödüllü reklamın nasıl yükleneceğine dair bir örnek verilmiştir:
8. sürüm (mevcut)
// 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;
});
}
Sürüm 7 (Eski)
// 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
7. sürümde, tam ekran reklamlar (geçiş reklamı, ödüllü reklam, ödüllü geçiş reklamı ve uygulama açılış reklamları) için reklam yüklendiyse true değerini döndüren IsLoaded() yöntemi vardı. Reklamların yüklenme şeklindeki değişiklik nedeniyle 8. sürümde, reklam yüklenene kadar tam ekran reklam nesnesine erişemezsiniz. Bu durum, IsLoaded() yöntemini geçersiz kılar.
8. sürümde, reklam hâlâ gösterilebiliyorsa true değerini döndüren CanShowAd() adlı yeni bir yöntem bulunur. Geçiş reklamında CanShowAd() nasıl kullanılacağına dair bir örneği aşağıda bulabilirsiniz:
8. sürüm (mevcut)
private InterstitialAd _interstitalAd;
public void ShowInterstitialAd()
{
if (_interstitalAd != null && _interstitalAd.CanShowAd())
{
_interstitalAd.Show();
}
else
{
Debug.Log("Interstitial ad cannot be shown.");
}
}
Sürüm 7 (Eski)
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 Show(Action) işlevini kullanın
Eklentinin 7. sürümünde, ödüllü reklamlar kullanıcı ödül sinyallerini işlemek için ayrı bir Show() etkinliğine sahip OnUserEarnedReward yöntemini kullanıyordu. Ödüllü geçiş reklamı ise kullanıcı ödül sinyalini işlemek için geri çağırma işlevine sahip Show(Action<Reward>) yöntemini kullanıyordu. 8. sürümde, ödüllü ve ödüllü geçiş reklamı biçimlerinde kullanıcı ödülü bildirimini işlemek için geri çağırma içeren bir Show(Action<Reward>) yöntemi bulunur.
Aşağıda, ödüllü reklamların nasıl gösterileceğine dair bir örnek verilmiştir:
8. sürüm (mevcut)
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.");
}
}
Sürüm 7 (Eski)
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 temsilcileri artık belirli türdeki bağımsız değişkenleri kullanıyor
API'nin 7. sürümünde, etkinlik temsilcilerini tanımlarken
EventHandlers
kullanmıştık. 8. sürümde, reklam etkinlikleri için genel temsilciler kullanmaya başladık. Sonuç olarak, etkinlikler artık EventArg sınıfına sarmalanmadan etkinlik değerlerini doğrudan yayınlayacak.
OnAdPaid (OnPaidEvent yerine) kullanımına ilişkin bir örneği aşağıda bulabilirsiniz:
8. sürüm (mevcut)
private BannerView _bannerView;
public void ConfigureBanner()
{
_bannerView.OnAdPaid += (AdValue value) =>
{
AdValue value = value;
};
}
Sürüm 7 (Eski)
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 uygun
Eklentinin 7. sürümünde, tam ekran reklam biçimleri arasındaki etkinlik adlarında tutarsızlıklar vardı. 8. sürümde, reklam biçimlerimizde tutarlılık sağlamak için birçok API yöntemimizi yeniden adlandırdık.
Aşağıdaki tabloda, v8'de kullanıma sunulan sınıf değişiklikleri listelenmektedir.
BannerView | |
|---|---|
| sürüm 7 | v8 |
| OnAdLoaded | OnBannerAdLoaded |
| OnAdFailedToLoad | OnBannerAdLoadFailed |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnPaidEvent | OnAdPaid |
InterstitialAd | |
| LoadAd() | InterstitialAd.Load() |
| InterstitialAd() | InterstitialAd.Load() |
| OnAdLoaded | InterstitialAd.Load() |
| OnAdFailedToLoad | InterstitialAd.Load() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnAdFailedToShow | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
| OnPaidEvent | OnAdPaid |
RewardedAd | |
| LoadAd() | RewardedAd.Load() |
| RewardedAd() | RewardedAd.Load() |
| OnAdLoaded | RewardedAd.Load() |
| OnAdFailedToLoad | RewardedAd.Load() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnAdFailedToShow | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
| OnPaidEvent | OnAdPaid |
| Show() | Show() |
| OnUserEarnedReward | Show() |
RewardedInterstitialAd | |
| LoadAd() | RewardedInterstitialAd.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
AppOpenAd | |
| LoadAd() | AppOpenAd.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
AdErrorEventArgs | |
| AdErrorEventArgs.AdError | AdError'u doğrudan kullanın. |
AdFailedToLoadEventArgs | |
| AdFailedToLoadEventArgs.LoadAdError | LoadAdError'u doğrudan kullanın. |
AdValueEventArgs | |
| AdValueEventArgs.AdValue | AdValue'yu doğrudan kullanın. |