SDK Taşıma

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

v22'den v23'e geçin

Minimum Android API düzeyi 21'dir

23.0.0 sürümünden itibaren, Google Mobile Ads SDK'sı tüm uygulamaların çalışması için tüm uygulamaların minimum Android API düzeyinde 21 olmasını zorunlu tutmaktadır. API seviyesini ayarlamak için uygulama düzeyindeki build.gradle dosyanızda minSdkVersion değerini 21 veya daha yüksek bir değer olarak değiştirin.

Kullanımdan Kaldırılan/Değiştirilen Yöntemler

v21'den v22'ye geçin

Google Mobile Ads SDK'sı sürümünü almak için MobileAds.getVersion() işlevini kullanın

MobileAds.getVersionString() yöntemi 22.0.0 sürümünde kaldırılmış olup MobileAds.getVersion() yöntemi kullanılmıştır.

Yeni yöntem, beklenen harici sürüm numarasını döndürür (örneğin, 22.0.0). Bu değişiklik hakkında daha fazla bilgi için Yeni Google Mobile Ads SDK'sı getVersion() yöntemini kullanma bölümüne bakın.

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

Aşağıdaki tabloda 22.0.0 sürümündeki değişiklikler listelenmiştir.

20. sürümden 21. sürüme geçin

minSdkVersion seçeneğini 19 veya daha yüksek bir sürüme güncelleyin

21.0.0 sürümünden itibaren, Google Mobile Ads SDK'sı tüm uygulamaların çalışması için tüm uygulamaların minimum Android API düzeyinde 19 olmasını zorunlu tutmaktadır. API seviyesini ayarlamak için uygulamanızın derleme dosyasındaki minSdkVersion değerini 19 veya daha yüksek olacak şekilde değiştirin.

Katı değer atanabilirliği zorunlu kıl

Katı değer atanabilirliğinin zorunlu kılınmasına hazırlık kapsamında, daha önce null değeri açık bir şekilde tanımlamayan tüm API'lere @NonNull ek açıklamaları eklenmiştir.

Bu değişiklik, boş güvenlik ihlalleri varsa ve null değerlerini daha önce güvenli bir şekilde işlemediyseniz Java boş kontrol çerçevelerini kullanan Kotlin uygulamalarını ve uygulamalarını bozabilir (Null-safety ile ilgili Kotlin dokümanlarına bakın).

addNetworkExtras() yönteminin kaldırılması

Belirli bir reklam ağı bağdaştırıcısına NetworkExtras örneği olarak ek parametreler ileten addNetworkExtras() yöntemi, SDK 20.3.0 sürümünde kullanımdan kaldırılmıştır ve 21.0.0 sürümünde kaldırılacaktır. Bunun yerine aynı AdRequest.Builder sınıfındaki addNetworkExtrasBundle() yöntemini kullanın.

Konum yöntemlerini kaldırma

Aşağıdaki konum yöntemleri 21.0.0 sürümünde kaldırılacaktır:

• AdRequest.Builder sınıfında, uyumlulaştırma hedefleme amaçları için kullanıcının konumunu ayarlayan setLocation(Location location) yöntemi.
• AdRequest sınıfında, kullanıcının daha önce setLocation(Location location) yöntemine iletilen konum hedefleme bilgilerini döndüren getLocation() yöntemi.
• AdRequest ile tanımlanırsa MediationAdConfiguration sınıfındaki, kullanıcının konumunu döndüren getLocation() yöntemi.

Google, konum verilerini reklamları hedeflemek için kullanmaz. Gerekirse üçüncü taraf reklam ağlarına bilgi sağlamak için üçüncü taraf API'lerini kullanmanız gerekir.

Özel etkinlik arayüzlerinin kullanımdan kaldırılması

Özel etkinlikler sayesinde yayıncılar,AdMob Uyumlulaştırması kullanarak AdMobdesteklenen reklam kaynaklarından biri olmayan bir şelale reklam kaynağı oluşturabilir.

Adapter sınıfı ve MediationAdLoadCallback arayüzü kullanılacak şekilde tüm özel etkinlik arayüzleri kullanımdan kaldırılmıştır.

Aşağıdaki tabloda, 21.0.0 sürümünden itibaren her özel etkinlik arayüzü için kullanılması gereken ilgili sınıf veya arayüz listelenmiştir:

19. sürümden 20. sürüme geçin

20.0.0 sürümünde zarar veren birçok değişiklik var. 19.7.0 sürümünde birçok yeni API kullanıma sunuldu ve 20.0.0 sürümüne hazırlanırken birçok sınıf kullanımdan kaldırıldı veya yeniden adlandırıldı. Bu kılavuzda, 20.0.0 sürümündeki önemli değişiklikler vurgulanmaktadır.

Tam ekran biçim API güncellemeleri

20.0.0 sürümünden itibaren geçiş reklamı, ödüllü, ödüllü geçiş reklamı ve uygulama açılış reklamı biçimleri, tutarlı bir API tasarımı oluşturacak şekilde standart hale getirilmiştir.

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

• Statik yükleme yöntemi
• Benzer bir yükleme geri çağırma veya işleyici mekanizması
• Sunu geri aramaları için FullScreenContentCallback sınıfından yararlanma

Eski ÖdüllüVideoAd API'nin kaldırılması

Yeni RewardedAd API ilk olarak Mart 2019'da kullanıma sunuldu ve 18 aydan uzun süredir tercih edilen ödüllü API. Uygulamada, eski RewardedVideoAd API'ye kıyasla tek seferde birden fazla ödüllü reklam yükleme özelliği de dahil olmak üzere daha fazla iyileştirme yapıldı.

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

Uyarlanabilir banner'ın yaygınlaşması için akıllı banner'ın kullanımdan kaldırılması

Akıllı banner reklamların desteği sonlandırılarak uyarlanabilir banner reklamların kullanılması amaçlanmaktadır. Uyarlanabilir banner'lar, reklam genişliğini ayarlamada üstün performans ve daha fazla esneklik sağlar. Tam genişlikte banner'lar kullanmaya devam etmek istiyorsanız bunu aşağıdaki kod snippet'inde gösterildiği gibi uyarlanabilir banner ile yapabilirsiniz:

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şleminden çık

Tüm reklam biçimleri için onAdLeftApplication geri çağırması kaldırılmış olup ProcessLifecycleOwner yerini almıştır. OS düzeyinde API kullanmak, bunun bir reklam etkileşiminden kaynaklanıp kaynaklanmadığına bakılmaksızın, kullanıcılar uygulamanızdan ayrıldığında sizi bilgilendirir.

onAdLeftApplication geri çağırmasının hiçbir zaman reklam tıklaması işleyici olarak tasarlanmadığını ve tıklamaları raporlamak için bu geri çağırmadan yararlanmanın doğru bir metrik oluşturmadığını unutmayın. Örneğin, harici bir tarayıcıyı başlatan Reklam Seçenekleri simgesine yapılan bir tıklama, geri çağırmayı çağırdı ancak tıklama olarak sayılmaz.

Sınıfları yeniden adlandırma

Aşağıdaki tabloda, değiştirilen veya kaldırılan belirli sınıf adları listelenmiştir. Özette:

• UnifiedNativeAd ile ilgili çoğu sınıfın adı NativeAd olarak değiştirildi.
• 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 önekiyle değiştirildi.
• InterstitialAd paketinin adı değişti.

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

Aşağıdaki tabloda 20.0.0 sürümündeki değişiklikler listelenmiştir. Özet olarak:

• Eski 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ı.
• Ödüllü Reklam ve Geçiş Reklamı API'leri, tüm tam ekran biçimleriyle uyumlu olacak şekilde güncellendi.
• İlişkilendirici özellikleri kaldırıldı.