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 diganti dengan
MobileAds.getVersion()
.
Metode baru akan menampilkan nomor versi eksternal yang diharapkan—misalnya,
22.0.0
. Untuk mengetahui 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.
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 | |
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 merusak aplikasi Kotlin dan aplikasi yang menggunakan framework pemeriksaan null
Java jika ada pelanggaran keamanan null dan sebelumnya tidak menangani
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 di versi 21.0.0:
- Metode
setLocation(Location location)
di classAdRequest.Builder
yang menetapkan lokasi pengguna untuk tujuan penargetan mediasi. - Metode
getLocation()
di classAdRequest
yang menampilkan informasi penargetan lokasi yang sebelumnya diteruskan ke metodesetLocation(Location location)
. - Metode
getLocation()
di classMediationAdConfiguration
yang menampilkan lokasi pengguna, jika ditentukan olehAdRequest
.
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 antarmuka peristiwa
kustom
tidak digunakan lagi dan digantikan dengan
class
Adapter
dan
antarmuka
MediationAdLoadCallback
.
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,
|
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 RewardedVideoAd API lama
API
RewardedAd
yang lebih baru pertama kali diperkenalkan pada Maret 2019 dan telah menjadi API reward
yang lebih disukai selama lebih dari 18 bulan. API ini memiliki lebih banyak peningkatan dibandingkan dengan
RewardedVideoAd
API lama, termasuk kemampuan untuk memuat lebih dari satu iklan reward
sekaligus.
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 pengendali
klik iklan, dan mengandalkan callback ini untuk melaporkan klik tidak menghasilkan
metrik yang akurat. Misalnya, klik pada ikon AdChoices yang meluncurkan browser
eksternal akan memanggil callback, tetapi tidak dihitung sebagai klik.
Penggantian nama class
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 menjadiNativeAd
. MobileAds.Settings
,NativeExpressAdView
,NativeAppInstallAd
, Class dan tampilanNativeContentAd
, danInstreamAd
telah dihapus.- Semua class dengan awalan
Publisher
telah diganti dengan AwalanAdManager
. - Nama paket
InterstitialAd
telah berubah.
Class 19.5.0 | 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 |
nativead.NativeCustomFormatAd |
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 classRequestConfiguration
. - 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 | getPortraitBanner |
getPortraitAnchored |
|
getLandscapeBanner |
getLandscapeAnchored |
||
getCurrentOrientation |
getCurrentOrientationAnchored |
||
MobileAds | initialize(Context, String) | MobileAds.Initialize(Context, OnInitializationComplete |
ID aplikasi sekarang ditetapkan di AndroidManifest.xml. |
initialize(Context, String, MobileAds.Settings) | inisialisasi(Context, OnInitializationComplete |
Class Settings sudah tidak digunakan lagi. | |
getRewardedVideo |
Dihapus | Sebagai gantinya, gunakan RewardAd API. | |
AdListener | onAdFailedToLoad(int) | onAd |
|
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 | ||
setManualImpressions |
Dihapus | ||
updateCorrelator() | Dihapus | Lihat Pemfilteran konten iklan. | |
AdRequest.Builder | setBirthday() | Dihapus | |
setGender() | Dihapus | ||
setIsDesignedForFamilies() | Dihapus | Lihat panduan. | |
addTestDevice() | RequestConfiguration |
Lihat Mengaktifkan iklan percobaan. | |
tagForChildDirectedTreatment() | RequestConfiguration |
Lihat Pemfilteran konten iklan. | |
setTagFor |
RequestConfiguration |
||
setMaxAdContentRating() | RequestConfiguration |
||
AdView | getMediationAdapter |
ResponseInfo |
Objek ResponseInfo kini tersedia melalui metode AdView getResponseInfo(). |
NativeAdOptions | setImageOrientation() | setMediaAspectRatio() | |
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(Activity, RewardedAdCallback) | show(Activity, OnUserEarnedRewardListener) | Metode tampilan ini mematuhi pendekatan format layar penuh yang lebih luas. | |
RewardedAdLoadCallback | onRewardedAd |
onAd |
|
onRewardedAd |
onAd |
||
onRewardedAdLoaded() | onAdLoaded(RewardedAd) | ||
AppOpenAdLoadCallback | onAppOpenAd |
onAd |
|
onAppOpenAd |
onAd |
||
onAppOpenAd |
onAdLoaded(AppOpenAd) | ||
RewardedInterstitialAdLoad |
onRewardedInterstitialAd |
onAd |
|
onRewardedInterstitialAd |
onAd |
||
onRewardedInterstitialAd |
onAd |
||
InterstitialAd | new InterstitialAd() | InterstitialAd.load(Konteks, String, AdRequest, InterstitialAdLoadCallback) | InterstitialAd sekarang menggunakan pendekatan pemuatan statis yang sama dengan format layar penuh lainnya. |
setAdListener() | |||
DynamicHeightSearchAd |
getNetworkExtras() | Dihapus | Class NetworkExtras tidak digunakan lagi. |
AdLoader | forContentAd() | Dihapus | |
forAppInstallAd() | Dihapus | ||
withCorrelator() | Dihapus | ||
getMediationAdapter |
Dihapus |