Migrasi SDK

Bermigrasi dari v19 ke v20

Ada banyak perubahan yang dapat menyebabkan gangguan pada 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 menyoroti 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 callback atau pengendali pemuatan yang serupa
• Mengandalkan class FullScreenContentCallback untuk callback presentasi

Penghapusan RewardedVideoAd API lama

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

RewardedVideoAd API lama dihapus di SDK versi 20.0.0.

Penghentian banner cerdas dan digantikan dengan banner adaptif

Iklan banner cerdas tidak digunakan lagi dan digantikan dengan 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 callback callback

Callback onAdLeftApplication untuk semua format iklan telah dihapus dan diganti dengan ProcessLifecycleOwner. Menggunakan API tingkat OS memberi tahu Anda setiap kali pengguna meninggalkan aplikasi, terlepas dari apakah itu karena interaksi iklan atau tidak.

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

Penggantian nama class

Tabel di bawah mencantumkan nama class tertentu yang telah diubah atau dihapus. Rangkuman:

• Sebagian besar class yang terkait dengan UnifiedNativeAd telah diganti namanya menjadi NativeAd.
• Class dan 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 usang telah dihapus dari class MobileAds.
• Beberapa metode dari class AdRequest.Builder() telah dihapus atau dipindahkan ke class RequestConfiguration.
• API RewardAd dan InterstisialAd telah diupdate agar selaras dengan semua format layar penuh.
• Fitur korelator telah dihapus.