Halaman ini diterjemahkan oleh Cloud Translation API.

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 minimum Android API level 21 agar dapat dijalankan. Untuk menyesuaikan API level, ubah atribut minSdkVersion dalam file build.gradle tingkat aplikasi ke 21 atau yang lebih tinggi.

Metode yang Tidak Digunakan Lagi Dihapus/Diganti

API v22.0.0	API v23.0.0
AdRequest.Builder.addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()
AdRequest.Builder.tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()
AdRequest.Builder.setIsDesignedForFamilies()	RequestConfiguration.Builder.setMaxAdContentRating()
AdFormat.UNKNOWN	Tidak ada penggantian
AdLoader.Builder.forUnifiedNativeAd()	AdLoader.Builder.forNativeAd()
AdLoader.Builder.forCustomTemplateAd()	AdLoader.Builder.forCustomFormatAd()
AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`formats`.NativeAdOptions)	AdLoader.Builder.withNativeAdOptions(com.google.android.gms.ads.`nativead`.NativeAdOptions)
void MobileAds.setSameAppKeyEnabled()	boolean MobileAds.putPublisherFirstPartyIdEnabled()

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 digantikan pengguna MobileAds.getVersion().

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

Metode yang dihapus atau diganti

Tabel di bawah mencantumkan perubahan spesifik dalam versi 22.0.0.

v21.0.0	v22.0.0
MobileAds.getVersionString()	MobileAds.getVersion()
NativeCustomFormatAd.getVideoMediaView()	NativeCustomFormatAd.getMediaContent()
NativeCustomFormatAd.getVideoController()	NativeCustomFormatAd.getMediaContent().getVideoController()
AdRequest.Builder.setAdInfo()	AdRequest.Builder.setAdString()
MediationRewardedVideoAdAdapter	Adaptor
MediationRewardedVideoAdListener	Adaptor
com.google.android.gms.ads.mediation.VersionInfo	com.google.android.gms.ads.VersionInfo
com.google.android.gms.ads.doubleclick.AppEventListener	com.google.android.gms.ads.admanager.AppEventListener

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 minimum Android API level 19 agar dapat dijalankan. Untuk menyesuaikan API level, ubah atribut minSdkVersion dalam file build aplikasi Anda ke 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 secara eksplisit menentukan nullability.

Perubahan ini dapat mengganggu aplikasi dan aplikasi Kotlin yang menggunakan pemeriksaan null Java jika ada pelanggaran keamanan null dan sebelumnya tidak ditangani Nilai null dengan cara yang aman (lihat dokumentasi Kotlin tentang Keamanan null ).

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 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 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. Sebaiknya Anda menggunakan API pihak ketiga untuk memberikan informasi ke jaringan iklan pihak ketiga jika tidak diperlukan.

Penghentian antarmuka peristiwa kustom

Dengan peristiwa kustom, penayang dapat menggunakan Mediasi AdMob untuk menyiapkan sumber iklan waterfall yang tidak salah satu dari AdMob sumber iklan yang didukung.

Semua metrik kustom acara antarmuka pengguna tidak digunakan lagi dan digantikan oleh Adapter kelas dan MediationAdLoadCallback dalam antarmuka berbasis web yang sederhana.

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

Antarmuka v20.0.0	Kelas/ Antarmuka v21.0.0
CustomEvent	Adaptor
CustomEventBanner
CustomEventInterstitial
CustomEventNative
CustomEventBannerListener	Adaptor, MediationAdLoadCallback
CustomEventInterstitialListener
CustomEventListener
CustomEventNativeListener

Bermigrasi dari v19 ke v20

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

Update API format layar penuh

Mulai versi 20.0.0, interstisial, reward, interstisial reward, dan Format iklan di Layar Pembuka Aplikasi distandarkan 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 FullScreenContentCallback class untuk callback presentasi

Penghapusan RewardVideoAd API lama

Lebih baru RewardedAd API pertama kali diperkenalkan pada Maret 2019 dan lebih disukai selama lebih dari 18 bulan. Memiliki lebih banyak peningkatan dibandingkan dengan versi sebelumnya RewardedVideoAd API, termasuk kemampuan untuk memuat lebih dari satu iklan reward pada 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 menggantinya dengan banner adaptif iklan. Banner adaptif memberikan performa yang unggul dan yang lebih fleksibel dalam menetapkan lebar iklan. Jika Anda memilih untuk terus menggunakan banner lebar penuh, Anda dapat tetap dilakukan menggunakan banner adaptif, seperti yang ditunjukkan dalam cuplikan kode berikut:

Java

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

Kotlin

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 pengguna ProcessLifecycleOwner. Menggunakan API level OS akan memberi tahu Anda setiap kali pengguna meninggalkan aplikasi, terlepas dari apakah itu disebabkan oleh interaksi iklan atau tidak.

Perhatikan bahwa callback onAdLeftApplication tidak pernah dimaksudkan sebagai iklan klik, 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 kelas

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

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

19.5.0 Class	Class 20.0.0
com.google.android.gms.ads.	com.google.android.gms.ads.
reward.RewardedVideoAd	rewarded.RewardedAd
reward.RewardedVideoAdListener	reward.RewardAdLoadCallback dan FullScreenContentCallback
reward.RewardItem	rewarded.RewardItem
rewarded.RewardedAdCallback	OnUserEarnedRewardListener
formats.UnifiedNativeAdView	nativead.NativeAdView
formats.UnifiedNativeAd	nativead.NativeAd
formats.UnifiedNativeAdAssetNames	nativead.NativeAdAssetNames
formats.UnifiedNativeAd.OnUnifiedNativeAdLoadedListener	nativead.NativeAd.OnNativeAdLoadedListener
formats.AdChoicesView	nativead.AdChoicesView
formats.NativeAd.AdChoicesInfo	nativead.NativeAd.AdChoicesInfo
formats.MediaView	nativead.MediaView
formats.NativeAdViewHolder	nativead.NativeAdViewHolder
formats.NativeAdOptions	nativead.NativeAdOptions
formats.NativeCustomTemplateAd	nativead.NativeCustomFormatAd
formats.NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener	nativead.NativeCustomFormatAd.OnCustomFormatAdLoadedListener
MobileAds.Settings	Dihapus
doubleclick.PublisherAdRequest	admanager.AdManagerAdRequest
doubleclick.PublisherAdView	admanager.AdManagerAdView
formats.PublisherAdViewOptions	formats.AdManagerAdViewOptions
doubleclick.PublisherInterstitialAd	admanager.AdManagerInterstitialAd
InterstitialAd	interstitial.InterstitialAd
NativeExpressAdView	Dihapus
instream.InstreamAd	Dihapus
mediation.admob.AdMobExtras	Dihapus
Correlator	Dihapus
search.SearchAdRequest	Dihapus
Antarmuka AdRequest.TagForUnderAgeOfConsent	Dihapus
Antarmuka AdRequest.MaxAdContentRating	Dihapus
formats.NativeAppInstallAd	native.NativeAd
formats.NativeAppInstallAdView	native.NativeAdView
mediation.NativeAppInstallAdMapper	mediation.UnifiedNativeAdMapper
formats.NativeContentAd	native.NativeAd
formats.NativeContentAdView	native.NativeAdView
mediation.NativeContentAdMapper	mediation.UnifiedNativeAdMapper

Metode dihapus/diganti

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

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.

Kelas	API v19.5.0	API v20.0.0	Catatan
AdSize	getPortraitBannerAdSizeWithWidth()	getPortraitAnchoredAdaptiveBannerAdSize()
	getLandscapeBannerAdSizeWithWidth()	getLandscapeAnchoredAdaptiveBannerAdSize()
	getCurrentOrientationBannerAdSizeWithWidth()	getCurrentOrientationAnchoredAdaptiveBannerAdSize()
MobileAds	inisialisasi(Konteks, String)	MobileAds.Initialize(Context, OnInitializationCompletePemroses)	ID aplikasi sekarang ditetapkan di AndroidManifest.xml.
	inisialisasi(Konteks, String, MobileAds.Settings)	inisialisasi(Context, OnInitializationCompletePemroses)	Class Settings sudah tidak digunakan lagi.
	getRewardedVideoAdInstance()	Dihapus	Sebagai gantinya, gunakan RewardAd API.
AdListener	onAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
AdListener	onAdLeftApplication()	Dihapus	Format iklan layar penuh menggunakan FullscreenContentCallback sebagai pengganti AdListener, dan tidak ada metode yang setara di FullscreenContentCallback. Tujuan telah dihapus dari AdListener.
VideoController	getAspectRatio()	MediaContent.getAspectRatio()
AdRequest	getGender()	Dihapus
	getBirthday()	Dihapus
	getNetworkExtras()	Dihapus
	setManualImpressionsEnabled()	Dihapus
	updateCorrelator()	Dihapus	Lihat Pemfilteran konten iklan.
AdRequest.Builder	setBirthday()	Dihapus
	setGender()	Dihapus
	setIsDesignedForFamilies()	Dihapus	Lihat panduan.
	addTestDevice()	RequestConfiguration.Builder.setTestDeviceIds()	Lihat Mengaktifkan iklan percobaan.
	tagForChildDirectedTreatment()	RequestConfiguration.Builder.setTagForChildDirectedTreatment()	Lihat Pemfilteran konten iklan.
	setTagForUnderAgeOfConsent()	RequestConfiguration.Builder.setTagForUnderAgeOfConsent()
	setMaxAdContentRating()	RequestConfiguration.Builder.setMaxAdContentRating()
AdView	getMediationAdapterClassName()	ResponseInfo.getMediationAdapterClassName()	Objek ResponseInfo kini tersedia melalui metode AdView getResponseInfo().
NativeAdOptions	setImageOrientation()	setMediaAspectRatio()
NativeAdOptions	getImageOrientation	getMediaAspectRatio()
RewardedAd	loadAd(AdRequest, RewardedAdLoadCallback)	RewardAd.load(Konteks, String, AdRequest, RewardedAdLoadCallback)	RewardAd kini menggunakan pendekatan pemuatan statis yang sama dengan format layar penuh.
	loadAd(PublisherAdRequest, RewardedAdLoadCallback)	RewardAd.load(Konteks, String, AdManagerAdRequest, RewardedAdLoadCallback)
	isLoaded()	Dihapus	Callback dari metode pemuatan statis menyediakan iklan yang sudah dimuat.
	show(Aktivitas, RewardAdCallback)	show(Aktivitas, OnUserEarnedRewardListener)	Metode acara ini mematuhi pendekatan format layar penuh yang lebih luas.
RewardedAdLoadCallback	onRewardedAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedAdLoaded()	onAdLoaded(RewardedAd)
AppOpenAdLoadCallback	onAppOpenAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onAppOpenAdLoaded(AppOpenAd)	onAdLoaded(AppOpenAd)
RewardedInterstitialAdLoadCallback	onRewardedInterstitialAdFailedToLoad(int)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdFailedToLoad(LoadAdError)	onAdFailedToLoad(LoadAdError)
	onRewardedInterstitialAdLoaded(RewardedInterstitialAd)	onAdLoaded(RewardedInterstitialAd)
InterstitialAd	new InterstitialAd()	InterstitialAd.load(Konteks, String, AdRequest, InterstitialAdLoadCallback)	InterstitialAd sekarang menggunakan pendekatan pemuatan statis yang sama dengan format layar penuh lainnya.
InterstitialAd	setAdListener()
DynamicHeightSearchAdRequest	getNetworkExtras()	Dihapus	Class NetworkExtras tidak digunakan lagi.
AdLoader	forContentAd()	Dihapus
	forAppInstallAd()	Dihapus
	withCorrelator()	Dihapus
	getMediationAdapterClassName()	Dihapus