SDK'yı Taşıma

SDK v20'ye geçiş yapın

20.0.0 sürümünde gelen birçok kırılma değişikliği var. Sürüm 19.7.0, birçok yeni API'yi tanıttı ve 20.0.0 sürümüne hazırlanırken birçok sınıfı kullanımdan kaldırdı veya yeniden adlandırdı. Bu kılavuz, 19.7.0 sürümünde getirilen büyük değişikliklerin yanı sıra 20.0.0 sürümünde (2021 başları) gelecekleri vurgulamaktadır.

Tam ekran biçimi API güncellemeleri

20.0.0 sürümünden itibaren, geçiş reklamı, ödüllü, ödüllü geçiş reklamı ve Uygulama Açma reklam biçimleri, tutarlı bir API tasarımı izleyecek şekilde standartlaştırıldı.

Tüm tam ekran biçimli API'ler aşağıdaki ilkeleri kullanır:

• Statik bir yükleme yöntemi
• Benzer bir yük geri çağırma veya işleyici mekanizması
• Sunum geri aramaları için FullScreenContentCallback sınıfına güven

Eski ÖdüllüVideoAd API kaldırma

Daha yeni RewardedAd API, ilk olarak Mart 2019'da tanıtıldı ve 18 aydan uzun süredir tercih edilen ödüllü API oldu. Eski RewardedVideoAd API'sine kıyasla, aynı anda birden fazla ödüllü reklam yükleme yeteneği de dahil olmak üzere daha fazla iyileştirmeye sahiptir.

Eski RewardedVideoAd API, SDK 20.0.0 sürümünde kaldırılmıştır.

Uyarlanabilir banner lehine akıllı banner'ın kullanımdan kaldırılması

Akıllı banner reklamlar, uyarlanabilir banner reklamlar yerine kullanımdan kaldırılmıştır. Uyarlanabilir banner'lar, reklam genişliğinin ayarlanmasında üstün performans ve daha fazla esneklik sağlar. Tam genişlikte banner'ları kullanmaya devam etmeyi tercih ederseniz, bu, aşağıdaki kod parçacığında gösterildiği gibi, uyarlamalı banner kullanılarak yine de yapılabilir:

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

Uygulama geri arama kaldırma işlemini bırakın

Tüm reklam biçimleri için onAdLeftApplication geri çağrısı, ProcessLifecycleOwner lehine kaldırılmıştır. İşletim sistemi düzeyinde bir API kullanmak, bir reklam etkileşiminden kaynaklanıp kaynaklanmadığına bakılmaksızın, kullanıcılar uygulamanızdan her ayrıldığında sizi bilgilendirir.

onAdLeftApplication geri çağrısının hiçbir zaman bir reklam tıklama işleyicisi olarak tasarlanmadığını ve tıklamaları raporlamak için bu geri çağrıya güvenmenin doğru bir ölçüm sağlamadığını unutmayın. Örneğin, harici bir tarayıcıyı başlatan AdChoices simgesine tıklama, geri aramayı başlattı ancak tıklama olarak sayılmadı.

Sınıf yeniden adlandırma

Aşağıdaki tablo, değiştirilen veya kaldırılan belirli sınıf adlarını listeler. Özetle:

• NativeAd ile ilgili sınıfların çoğu UnifiedNativeAd olarak yeniden adlandırılmıştır.
• MobileAds.Settings , NativeExpressAdView , NativeAppInstallAd , NativeContentAd ve InstreamAd sınıfları ve görünümleri kaldırıldı.
• Publisher ön ekine sahip tüm sınıflar, bir AdManager ön ekiyle değiştirilmiştir.
• InterstitialAd paketi adı değişti.

Kaldırılan/değiştirilen yöntemler

Aşağıdaki tablo, 20.0.0 sürümündeki belirli değişiklikleri listeler. Özetle:

• Güncel olmayan başlatma yöntemleri MobileAds sınıfından kaldırıldı.
• AdRequest.Builder() sınıfındaki bazı yöntemler kaldırıldı veya RequestConfiguration sınıfına taşındı.
• RewardedAd ve InterstitialAd API'leri, tüm tam ekran biçimleriyle uyumlu olacak şekilde güncellendi.
• Korelatör özellikleri kaldırıldı.