Migrasi SDK

Halaman ini membahas migrasi untuk versi saat ini dan sebelumnya.

Bermigrasi dari v22 ke v23

Level API Android minimum adalah 21

Mulai versi 23.0.0, Google Mobile Ads SDK mengharuskan semua aplikasi menggunakan Android API level 21 minimum agar dapat berjalan. Untuk menyesuaikan level API, ubah nilai minSdkVersion di file build.gradle level aplikasi menjadi 21 atau yang lebih tinggi.

Metode yang Tidak Digunakan Lagi Dihapus/Diganti

Bermigrasi dari v21 ke v22

Menggunakan MobileAds.getVersion() untuk mendapatkan versi Google Mobile Ads SDK

Metode MobileAds.getVersionString() dihapus di versi 22.0.0 dan diganti dengan MobileAds.getVersion().

Metode baru akan menampilkan nomor versi eksternal yang diharapkan—misalnya, 22.0.0. Untuk informasi selengkapnya tentang perubahan ini, lihat Menggunakan metode getVersion() Google Mobile Ads SDK yang baru.

Metode yang dihapus atau diganti

Tabel di bawah mencantumkan perubahan spesifik dalam versi 22.0.0.

Bermigrasi dari v20 ke v21

Mengupdate minSdkVersion ke versi 19 atau yang lebih tinggi

Mulai versi 21.0.0, Google Mobile Ads SDK mengharuskan semua aplikasi menggunakan Android API level 19 minimum agar dapat berjalan. Untuk menyesuaikan level API, ubah nilai minSdkVersion di file build aplikasi menjadi 19 atau yang lebih tinggi.

Menerapkan nullability yang ketat

Sebagai persiapan untuk menerapkan nullability yang ketat, anotasi @NonNull ditambahkan di semua API yang sebelumnya tidak menentukan nullability secara eksplisit.

Perubahan ini dapat merusak aplikasi dan aplikasi Kotlin yang menggunakan framework pemeriksaan null Java jika terdapat pelanggaran keamanan null dan sebelumnya tidak menangani nilai null dengan cara yang aman (lihat dokumentasi Kotlin tentang Null-safety ).

Penghapusan metode addNetworkExtras()

Metode addNetworkExtras() yang meneruskan parameter tambahan sebagai instance NetworkExtras ke adaptor jaringan iklan tertentu tidak digunakan lagi di SDK versi 20.3.0 dan akan dihapus di versi 21.0.0. Gunakan metode addNetworkExtrasBundle() dari class AdRequest.Builder yang sama sebagai gantinya.

Penghapusan metode lokasi

Metode lokasi berikut akan dihapus dari versi 21.0.0:

• Metode setLocation(Location location) di class AdRequest.Builder yang menetapkan lokasi pengguna untuk tujuan penargetan mediasi.
• Metode getLocation() di class AdRequest yang menampilkan informasi penargetan lokasi pengguna yang sebelumnya diteruskan ke metode setLocation(Location location).
• Metode getLocation() di class MediationAdConfiguration yang menampilkan lokasi pengguna, jika ditentukan oleh AdRequest.

Data lokasi tidak digunakan oleh Google untuk menargetkan iklan. Anda harus menggunakan API pihak ketiga untuk memberikan informasi kepada jaringan iklan pihak ketiga jika diperlukan.

Penghentian antarmuka peristiwa kustom

Peristiwa kustom memungkinkan penayang menggunakan Mediasi untuk menyiapkan sumber iklan waterfall yang bukan salah satu dari AdMob sumber iklan yang didukung.

Semua antarmuka peristiwa kustom tidak digunakan lagi dan digantikan oleh class Adapter dan antarmuka MediationAdLoadCallback.

Tabel di bawah ini mencantumkan class atau antarmuka terkait yang harus digunakan untuk setiap antarmuka peristiwa kustom mulai dari versi 21.0.0:

Bermigrasi dari v19 ke v20

Ada banyak perubahan yang dapat menyebabkan gangguan di versi 20.0.0. Versi 19.7.0 memperkenalkan banyak API baru, dan menghentikan atau mengganti nama banyak class sebagai persiapan untuk versi 20.0.0. Panduan ini menjelaskan perubahan utama dalam versi 20.0.0.

Update API format layar penuh

Mulai versi 20.0.0, format iklan interstisial, reward, interstisial reward, dan Layar Pembuka Aplikasi distandarisasi untuk mengikuti desain API yang konsisten.

Semua API format layar penuh menggunakan prinsip berikut:

• Metode pemuatan statis
• Mekanisme pengendali atau callback pemuatan yang serupa
• Mengandalkan class FullScreenContentCallback untuk callback presentasi

Penghapusan RewardVideoAd API lama

RewardedAd API yang lebih baru pertama kali diperkenalkan pada Maret 2019 dan telah menjadi API reward pilihan selama lebih dari 18 bulan. Memiliki lebih banyak peningkatan dibandingkan dengan RewardedVideoAd API lama, termasuk kemampuan untuk memuat lebih dari satu iklan reward dalam satu waktu.

RewardedVideoAd API lama dihapus di SDK versi 20.0.0.

Penghentian penggunaan banner cerdas dan penggunaan banner adaptif

Iklan banner cerdas tidak digunakan lagi dan digantikan oleh iklan banner adaptif. Banner adaptif memberikan performa yang unggul dan lebih fleksibel dalam menetapkan lebar iklan. Jika Anda memilih untuk terus menggunakan banner lebar penuh, hal tersebut masih dapat dilakukan menggunakan banner adaptif, seperti yang ditunjukkan dalam cuplikan kode berikut:

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

Keluar dari penghapusan callback aplikasi

Callback onAdLeftApplication untuk semua format iklan telah dihapus dan digantikan oleh ProcessLifecycleOwner. Dengan menggunakan API level OS, Anda akan diberi tahu setiap kali pengguna keluar dari aplikasi, terlepas dari apakah itu karena interaksi iklan atau tidak.

Perhatikan bahwa callback onAdLeftApplication tidak pernah dimaksudkan untuk menjadi pengendali klik iklan, dan mengandalkan callback ini untuk melaporkan klik tidak akan menghasilkan metrik yang akurat. Misalnya, klik pada ikon AdChoices yang meluncurkan browser eksternal memanggil callback tetapi tidak dihitung sebagai klik.

Penggantian nama kelas

Tabel di bawah mencantumkan nama class tertentu yang telah berubah atau dihapus. Sebagai ringkasan:

• Sebagian besar class yang terkait dengan UnifiedNativeAd telah diganti namanya menjadi NativeAd.
• Class serta tampilan MobileAds.Settings, NativeExpressAdView, NativeAppInstallAd, NativeContentAd, dan InstreamAd telah dihapus.
• Semua class dengan awalan Publisher telah diganti dengan awalan AdManager.
• Nama paket InterstitialAd telah berubah.

Metode dihapus/diganti

Tabel di bawah mencantumkan perubahan spesifik dalam versi 20.0.0. Ringkasan:

• Metode inisialisasi yang sudah tidak berlaku telah dihapus dari class MobileAds.
• Beberapa metode dari class AdRequest.Builder() telah dihapus atau dipindahkan ke class RequestConfiguration.
• RewardAd dan InterstitialAd API telah diupdate agar sesuai dengan semua format layar penuh.
• Fitur korelator telah dihapus.