หน้านี้ครอบคลุมการย้ายข้อมูลสำหรับเวอร์ชันปัจจุบันและเวอร์ชันก่อนหน้า
ย้ายข้อมูลจาก v24 ไปยัง v25
ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 24 และ 25 ของ Google Mobile Ads SDK (Legacy)
ระดับ API ขั้นต่ำของ Android คือ 24
ตั้งแต่เวอร์ชัน 25.5.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องทำงานบน Android API ระดับ 24 เป็นอย่างน้อย หากต้องการปรับระดับ API ให้เปลี่ยนค่า minSdk ในไฟล์ build.gradle ระดับแอปเป็น 24 ขึ้นไป
นำ Callback ของโฆษณาที่เลิกใช้งานแล้วออก
ระบบนำ Callback โฆษณาที่เลิกใช้งานต่อไปนี้ออกจากคลาสต่อไปนี้
| ชั้นเรียน | นำ Callback ออกแล้ว | การแทนที่ |
|---|---|---|
| SignalCallbacks |
onFailure(String)onAdFailedToShow(String)
|
onFailure(AdError)onAdFailedToShow(AdError)
|
| MediationAdLoadCallback | ||
| MediationInterstitialAdCallback | ||
| MediationRewardedAdCallback |
การเปลี่ยนแปลง API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้
เวอร์ชัน 25.0.0 เลิกใช้งาน API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ที่มีอยู่ และเปิดตัว API ขนาดสำหรับโฆษณาแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่ Google Mobile Ads SDK (Legacy) สามารถแสดงดีมานด์วิดีโอในโฆษณาแบนเนอร์ได้โดยใช้ API ขนาดแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่ใหม่
ตารางต่อไปนี้แสดงรายละเอียด API การปรับขนาดที่เลิกใช้งานแล้วและ API ที่จะมาแทนที่
| v24 (เลิกใช้งานแล้ว) | v25 (การเปลี่ยนทดแทน) |
|---|---|
getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) |
getLargeAnchoredAdaptiveBannerAdSize(Context, int) |
getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) |
getLargeLandscapeAnchoredAdaptiveBannerAdSize(Context, int) |
getPortraitAnchoredAdaptiveBannerAdSize(Context context, int width) |
getLargePortraitAnchoredAdaptiveBannerAdSize(Context context, int width) |
การนำชั้นเรียน mediation.VersionInfo ออก
คลาส VersionInfo ในแพ็กเกจ com.google.android.gms.ads.mediation ถูกนำออกแล้ว ให้ใช้แพ็กเกจ com.google.android.gms.ads.VersionInfo แทน
การนำเมธอด getConfiguration() ออกในคลาส RtbSignalData
นำเมธอด getConfiguration() API ที่เลิกใช้งานแล้วใน RtbSignalData ออก
แต่ให้ใช้เมธอด
getConfigurations()
ซึ่งจะแสดงรายการ List<MediationConfiguration> แทน
ย้ายข้อมูลจาก v23 ไปยัง v24
ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่าง Google Mobile Ads SDK (Legacy) เวอร์ชันหลัก 23 และ 24
ระดับ API ขั้นต่ำของ Android คือ 23
ตั้งแต่เวอร์ชัน 24.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องทำงานบน Android API ระดับ 23 เป็นอย่างน้อย หากต้องการปรับระดับ API ให้เปลี่ยนค่า minSdk ในไฟล์ build.gradle ระดับแอปเป็น 23 ขึ้นไป
การเปลี่ยนแปลงการเริ่มต้นและการโหลดที่เพิ่มประสิทธิภาพ
โดยค่าเริ่มต้น แฟล็ก OPTIMIZE_INITIALIZATION และ OPTIMIZE_AD_LOADING จะตั้งค่าเป็น true ดูข้อมูลเพิ่มเติมเกี่ยวกับแฟล็กเหล่านี้ได้ที่เพิ่มประสิทธิภาพการเริ่มต้นและการโหลด
นำทรัพยากร Dependency ของ firebase-ads และ firebase-ads-lite ออกแล้ว
ตั้งแต่เวอร์ชัน 24.0.0 เป็นต้นไป SDK จะไม่เผยแพร่ทรัพยากร Dependency firebase-ads และ firebase-ads-lite อีกต่อไป ให้ใช้ทรัพยากร Dependency play-services-ads แทน
ตั้งค่าพารามิเตอร์การกำหนดเป้าหมายเอง
หากต้องการตั้งค่าการกำหนดเป้าหมายเองในคำขอโฆษณา ให้ใช้ addCustomTargeting()
นํา API การวางแนวที่เลิกใช้งานแล้วสําหรับโฆษณาเปิดแอปออก
- นำเมธอด
AppOpenAd.load()ที่ยอมรับพารามิเตอร์อินพุตการวางแนวออก ใช้เมธอดAppOpenAd.load()ที่ไม่ใช้การวางแนวแทน - นำ enum
AppOpenAdOrientationออกแล้ว
Simplified reward callback for mediation adapters
เวอร์ชัน 24.0.0 เพิ่ม Callback onUserEarnedReward() ใน MediationRewardedAdCallback และเลิกใช้งาน onUserEarnedReward(RewardItem)
อะแดปเตอร์สื่อกลางต้องเริ่มเรียก onUserEarnedReward() เมื่อผู้ใช้ได้รับรางวัล
เมื่อส่งต่อ Callback จากอะแดปเตอร์สื่อกลาง Google Mobile Ads SDK (Legacy) ทุกเวอร์ชันจะแสดงผลรางวัลที่กำหนดไว้ใน UI ของ Ad Manager ใน OnUserEarnedRewardListener
นำชั้นเรียนออกแล้ว
ระบบนำคลาสต่อไปนี้ออกโดยไม่มีการแทนที่
DynamicHeightSearchAdRequestSearchAdRequestSearchAdView
นำวิธีการออกแล้ว
ระบบได้นำเมธอดต่อไปนี้ออกโดยไม่มีการแทนที่
| ชั้นเรียน | วิธีการ |
|---|---|
| RewardedInterstitialAdLoadCallback | onRewardedInterstitialAdLoaded() |
onRewardedInterstitialAdFailedToLoad(int) |
|
onRewardedInterstitialAdFailedToLoad(LoadAdError) |
เลิกใช้งานเมธอดแล้ว
เราได้เลิกใช้งานเมธอดต่อไปนี้โดยไม่มีการแทนที่
| ชั้นเรียน | วิธีการ |
|---|---|
| อะแดปเตอร์ | loadInterscrollerAd() |
| RtbAdapter | loadRtbInterscrollerAd() |
ย้ายข้อมูลจาก v22 ไปยัง v23
ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 22 และ 23 ของ Google Mobile Ads SDK (Legacy)
ระดับ API ขั้นต่ำของ Android คือ 21
ตั้งแต่เวอร์ชัน 23.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องใช้ Android API ระดับ 21 เป็นอย่างต่ำจึงจะทำงานได้ หากต้องการปรับระดับ API ให้เปลี่ยนค่าของ minSdkVersion ในไฟล์ build.gradle ระดับแอปเป็น 21 ขึ้นไป
AdManagerAdRequest.Builder เมธอดที่รับค่ามาจากคลาสใหญ่สุดสามารถเชื่อมโยงกันได้
ในเวอร์ชัน 23.0.0 เมธอด AdManagerAdRequest.Builder ที่รับค่ามาจากเมธอดหลักสามารถเชื่อมโยงเข้าด้วยกันเพื่อสร้าง AdManagerAdRequest โดยใช้การเรียกใช้เพียงครั้งเดียว ดังนี้
Java
AdManagerAdRequest request = new AdManagerAdRequest.Builder() .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method. .setContentUrl("https://www.example.com") // Method inherited from parent. .build(); // Builds an AdManagerAdRequest.
Kotlin
var request = AdManagerAdRequest.Builder() .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method. .setContentUrl("https://www.example.com") // Method inherited from parent. .build() // Builds an AdManagerAdRequest.
นำวิธีการที่เลิกใช้งานออก/แทนที่
| v22.0.0 API | v23.0.0 API |
|---|---|
| AdRequest.Builder.addTestDevice() | RequestConfiguration.Builder.setTestDeviceIds() |
| AdRequest.Builder.tagForChildDirectedTreatment() | RequestConfiguration.Builder.setTagForChildDirectedTreatment() |
| AdRequest.Builder.setIsDesignedForFamilies() | RequestConfiguration.Builder.setMaxAdContentRating() |
| AdFormat.UNKNOWN | ไม่มีการเปลี่ยนทดแทน |
| 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() |
ย้ายข้อมูลจาก v21 ไปยัง v22
ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 21 และ 22 ของ Google Mobile Ads SDK (Legacy)
ใช้ MobileAds.getVersion() เพื่อรับเวอร์ชัน Google Mobile Ads SDK (Legacy)
เราจะนําเมธอด MobileAds.getVersionString() ออกในเวอร์ชัน 22.0.0 เพื่อใช้ MobileAds.getVersion() แทน
เมธอดใหม่จะแสดงผลหมายเลขเวอร์ชันภายนอกที่คาดไว้ เช่น 22.0.0 ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ที่ใช้เมธอด getVersion() ของ Google Mobile Ads SDK ใหม่
การนํา NativeCustomFormatAd.getVideoMediaView() ที่เลิกใช้งานแล้วออก
ในเวอร์ชัน 21 Google Mobile Ads SDK (Legacy) มีเมธอด NativeCustomFormatAd.getVideoMediaView() เพื่อรับชิ้นงานสื่อสำหรับรูปแบบโฆษณาเนทีฟที่กำหนดเอง
ตั้งแต่เวอร์ชัน 22 เป็นต้นไป คุณจะต้องสร้าง MediaView ของคุณเองและตั้งค่าเนื้อหาสื่อ แล้วใช้ MediaContent.getVideoController() เพื่อรับตัวควบคุมวิดีโอ
v22
// Called when a custom native ad loads. @Override public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) { // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder. FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder); MediaContent mediaContent = ad.getMediaContent(); if (mediaContent != null && mediaContent.hasVideoContent()) { // Create a MediaView and set its media content. MediaView mediaView = new MediaView(mediaPlaceholder.getContext()); mediaView.setMediaContent(mediaContent); mediaPlaceholder.addView(mediaView); } }
v21
// Called when a custom native ad loads. @Override public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) { // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder. FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder); VideoController videoController = ad.getVideoController(); if (videoController.hasVideoContent()) { // Add the media view provided by the native ad. mediaPlaceholder.addView(ad.getVideoMediaView()); } }
ดูข้อมูลเพิ่มเติมได้ที่คู่มือโฆษณาเนทีฟที่กำหนดเอง
วิธีการที่นำออกหรือแทนที่
ตารางต่อไปนี้แสดงการเปลี่ยนแปลงที่เฉพาะเจาะจงในเวอร์ชัน 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 | Adapter |
| 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 |
ย้ายข้อมูลจาก v20 ไปยัง v21
ส่วนย่อยต่อไปนี้อธิบายการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและความแตกต่างของลักษณะการทำงานระหว่างเวอร์ชันหลัก 20 และ 21 ของ Google Mobile Ads SDK (Legacy)
อัปเดต minSdkVersion เป็น 19 ขึ้นไป
ตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องใช้ Android ระดับ API 19 เป็นอย่างน้อยจึงจะทำงานได้ หากต้องการปรับระดับ API ให้เปลี่ยนค่าของ minSdkVersion ในไฟล์บิลด์ของแอปเป็น 19 ขึ้นไป
บังคับใช้ความสามารถในการเป็นค่า Null ที่เข้มงวด
ในการเตรียมพร้อมสำหรับการบังคับใช้ความสามารถในการเป็นค่า Null ที่เข้มงวด ระบบจะเพิ่มคำอธิบายประกอบ @NonNull ใน API ทั้งหมดที่ก่อนหน้านี้ไม่ได้กำหนดความสามารถในการเป็นค่า Null อย่างชัดเจน
การเปลี่ยนแปลงนี้อาจทำให้แอป Kotlin และแอปที่ใช้เฟรมเวิร์กการตรวจสอบค่า Null ของ Java เสียหายหากมีการละเมิดความปลอดภัยของค่า Null และก่อนหน้านี้ไม่ได้จัดการค่า null อย่างปลอดภัย (ดูเอกสารประกอบของ Kotlin เกี่ยวกับความปลอดภัยของค่า Null)
การนำเมธอด addNetworkExtras() ออก
เมธอด addNetworkExtras() ที่ส่งพารามิเตอร์เพิ่มเติมเป็นอินสแตนซ์ NetworkExtras ไปยังอะแดปเตอร์เครือข่ายโฆษณาที่เฉพาะเจาะจงเลิกใช้งานแล้วใน SDK เวอร์ชัน 20.3.0 และจะถูกนำออกในเวอร์ชัน 21.0.0 โปรดใช้เมธอด addNetworkExtrasBundle() จากคลาส AdRequest.Builder เดียวกันแทน
การนำวิธีการระบุตำแหน่งออก
ระบบจะนำเมธอดตำแหน่งต่อไปนี้ออกในเวอร์ชัน 21.0.0
- เมธอด
setLocation(Location location)ในคลาสAdRequest.Builderที่ตั้งค่าตำแหน่งของผู้ใช้เพื่อวัตถุประสงค์ในการกำหนดเป้าหมายสื่อกลาง - เมธอด
getLocation()ในคลาสAdRequestที่แสดงข้อมูลการกำหนดเป้าหมายตามสถานที่ของผู้ใช้ซึ่งส่งไปยังเมธอดsetLocation(Location location)ก่อนหน้านี้ - เมธอด
getLocation()ในคลาสMediationAdConfigurationที่แสดงผลตำแหน่งของผู้ใช้ หากกำหนดโดยAdRequest
Google ไม่ได้ใช้ข้อมูลตำแหน่งเพื่อกำหนดเป้าหมายโฆษณา คุณควรใช้ API ของบุคคลที่สามเพื่อส่งข้อมูลให้เครือข่ายโฆษณาบุคคลที่สามหากจำเป็น
การเลิกใช้งานอินเทอร์เฟซเหตุการณ์ที่กำหนดเอง
เหตุการณ์ที่กำหนดเองช่วยให้ผู้เผยแพร่โฆษณาที่ใช้สื่อกลางสามารถตั้งค่าแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้นซึ่งไม่ใช่แหล่งที่มาของโฆษณาที่ Ad Manager รองรับได้
อินเทอร์เฟซเหตุการณ์ที่กำหนดเองทั้งหมดเลิกใช้งานแล้วเพื่อสนับสนุนคลาส Adapter และอินเทอร์เฟซ MediationAdLoadCallback
ตารางต่อไปนี้แสดงคลาสหรืออินเทอร์เฟซที่เกี่ยวข้องซึ่งคุณต้องใช้สําหรับอินเทอร์เฟซเหตุการณ์ที่กําหนดเองแต่ละรายการตั้งแต่เวอร์ชัน 21.0.0 เป็นต้นไป
| อินเทอร์เฟซ v20.0.0 | คลาส/อินเทอร์เฟซ v21.0.0 |
|---|---|
| CustomEvent | Adapter |
| CustomEventBanner | |
| CustomEventInterstitial | |
| CustomEventNative | |
| CustomEventBannerListener |
Adapter,
|
| CustomEventInterstitialListener | |
| CustomEventListener | |
| CustomEventNativeListener |
ย้ายข้อมูลจาก v19 ไปยัง v20
มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบหลายรายการในเวอร์ชัน 20.0.0 เวอร์ชัน 19.7.0 เปิดตัว API ใหม่หลายรายการ และเลิกใช้งานหรือเปลี่ยนชื่อคลาสหลายคลาสเพื่อเตรียมพร้อมสําหรับเวอร์ชัน 20.0.0 คู่มือนี้จะไฮไลต์การเปลี่ยนแปลงที่สำคัญในเวอร์ชัน 20.0.0
การอัปเดต API รูปแบบเต็มหน้าจอ
ตั้งแต่เวอร์ชัน 20.0.0 เป็นต้นไป รูปแบบโฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล และโฆษณาเปิดแอปจะได้รับการปรับให้เป็นมาตรฐานตามการออกแบบ API ที่สอดคล้องกัน
API รูปแบบเต็มหน้าจอทั้งหมดใช้หลักการต่อไปนี้
- วิธีการโหลดแบบคงที่
- กลไก Callback หรือเครื่องมือจัดการการโหลดที่คล้ายกัน
- การใช้คลาส
FullScreenContentCallbackสำหรับ Callback ของการนำเสนอ
การนำ RewardedVideoAd API เดิมออก
API RewardedAd ที่ใหม่กว่าเปิดตัวครั้งแรกเมื่อเดือนมีนาคม 2019 และเป็น API ที่มีโฆษณาที่มีการให้รางวัลที่แนะนำมานานกว่า 18 เดือน ซึ่งได้รับการปรับปรุงมากกว่า API RewardedVideoAd เดิม รวมถึงความสามารถในการโหลดโฆษณาที่มีการให้รางวัลมากกว่า 1 รายการต่อครั้ง
ระบบจะนำ RewardedVideoAd API เดิมออกใน SDK เวอร์ชัน 20.0.0
การเลิกใช้งานแบนเนอร์อัจฉริยะเพื่อเปลี่ยนไปใช้แบนเนอร์แบบปรับขนาดได้
เราเลิกใช้งานโฆษณาแบนเนอร์อัจฉริยะแล้ว และเปลี่ยนไปใช้โฆษณาแบนเนอร์แบบปรับขนาดได้แทน แบนเนอร์แบบปรับขนาดได้ให้ประสิทธิภาพที่เหนือกว่าและมีความยืดหยุ่นมากขึ้นในการตั้งค่าความกว้างของโฆษณา หากต้องการใช้แบนเนอร์แบบเต็มความกว้างต่อไป คุณยังคงใช้แบนเนอร์แบบปรับขนาดได้ตามที่แสดงในข้อมูลโค้ดต่อไปนี้
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) } }
การนำ Callback ของแอปพลิเคชันที่ไม่ได้ใช้งานออก
ระบบได้นำ Callback onAdLeftApplication สำหรับรูปแบบโฆษณาทุกรูปแบบออกเพื่อใช้ ProcessLifecycleOwner แทน
การใช้ API ระดับระบบปฏิบัติการจะแจ้งให้คุณทราบเมื่อผู้ใช้ออกจากแอป ไม่ว่าจะเกิดจากการโต้ตอบกับโฆษณาหรือไม่ก็ตาม
โปรดทราบว่า Callback onAdLeftApplication ไม่ได้มีไว้เพื่อเป็นเครื่องมือจัดการการคลิกโฆษณา และการใช้ Callback นี้เพื่อรายงานการคลิกไม่ได้สร้างเมตริกที่ถูกต้อง ตัวอย่างเช่น การคลิกไอคอนตัวเลือกโฆษณาอื่นๆ ที่เปิดเบราว์เซอร์ภายนอกจะเรียกใช้ Callback แต่ไม่นับเป็นการคลิก
การเปลี่ยนชื่อชั้นเรียน
ตารางต่อไปนี้แสดงชื่อคลาสที่เฉพาะเจาะจงซึ่งมีการเปลี่ยนแปลงหรือถูกนำออก
- คลาสส่วนใหญ่ที่เกี่ยวข้องกับ
UnifiedNativeAdได้เปลี่ยนชื่อเป็นNativeAdแล้ว - นำคลาสและมุมมอง
MobileAds.Settings,NativeExpressAdView,NativeAppInstallAd,NativeContentAdและInstreamAdออกแล้ว - คลาสทั้งหมดที่มีคำนำหน้า
Publisherถูกแทนที่ด้วยคำนำหน้าAdManagerแล้ว - ชื่อแพ็กเกจ
InterstitialAdมีการเปลี่ยนแปลง
| คลาส 19.5.0 | คลาส 20.0.0 |
|---|---|
| com.google.android.gms.ads. | com.google.android.gms.ads. |
| reward.RewardedVideoAd | rewarded.RewardedAd |
| reward.RewardedVideoAdListener | rewarded.RewardedAdLoadCallback และ 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 | นำออกแล้ว |
| doubleclick.PublisherAdRequest | admanager.AdManagerAdRequest |
| doubleclick.PublisherAdView | admanager.AdManagerAdView |
| formats.PublisherAdViewOptions | formats.AdManagerAdViewOptions |
| doubleclick.PublisherInterstitialAd | admanager.AdManagerInterstitialAd |
| InterstitialAd | interstitial.InterstitialAd |
| NativeExpressAdView | นำออกแล้ว |
| instream.InstreamAd | นำออกแล้ว |
| mediation.admob.AdMobExtras | นำออกแล้ว |
| Correlator | นำออกแล้ว |
| search.SearchAdRequest | นำออกแล้ว |
| อินเทอร์เฟซ AdRequest.TagForUnderAgeOfConsent | นำออกแล้ว |
| อินเทอร์เฟซ AdRequest.MaxAdContentRating | นำออกแล้ว |
| formats.NativeAppInstallAd | native.NativeAd |
| formats.NativeAppInstallAdView | native.NativeAdView |
| mediation.NativeAppInstallAdMapper | mediation.UnifiedNativeAdMapper |
| formats.NativeContentAd | native.NativeAd |
| formats.NativeContentAdView | native.NativeAdView |
| mediation.NativeContentAdMapper | mediation.UnifiedNativeAdMapper |
นำวิธีการออก/แทนที่แล้ว
ตารางต่อไปนี้แสดงการเปลี่ยนแปลงที่เฉพาะเจาะจงในเวอร์ชัน 20.0.0
- เราได้นำวิธีการเริ่มต้นที่ล้าสมัยออกจากคลาส MobileAds แล้ว
- ระบบได้นำเมธอดบางรายการจากคลาส
AdRequest.Builder()ออกหรือย้ายไปยังคลาสRequestConfigurationแล้ว - เราได้อัปเดต RewardedAd API และ InterstitialAd API ให้สอดคล้องกับรูปแบบโฆษณาแบบเต็มหน้าจอทั้งหมด
- เราได้นำฟีเจอร์ Correlator ออกแล้ว
| ชั้นเรียน | v19.5.0 API | v20.0.0 API | หมายเหตุ |
|---|---|---|---|
| AdSize | getPortraitBanner |
getPortraitAnchored |
|
| getLandscapeBanner |
getLandscapeAnchored |
||
| getCurrentOrientation |
getCurrentOrientationAnchored |
||
| MobileAds | initialize(Context, String) | MobileAds.initialize(Context, OnInitializationComplete |
ตอนนี้รหัสแอปได้รับการตั้งค่าใน AndroidManifest.xml แล้ว |
| initialize(Context, String, MobileAds.Settings) | initialize(Context, OnInitializationComplete |
เลิกใช้งานคลาส Settings แล้ว | |
| getRewardedVideo |
นำออกแล้ว | โปรดใช้ RewardedAd API แทน | |
| AdListener | onAdFailedToLoad(int) | onAd |
|
| onAdLeftApplication() | นำออกแล้ว | รูปแบบโฆษณาแบบเต็มหน้าจอใช้ FullscreenContentCallback แทน AdListener และไม่มีเมธอดที่เทียบเท่าใน FullscreenContentCallback นําเมธอดออกจาก AdListener แล้ว | |
| VideoController | getAspectRatio() | MediaContent.getAspectRatio() | |
| PublisherAdRequest | getGender() | นำออกแล้ว | |
| getBirthday() | นำออกแล้ว | ||
| getNetworkExtras() | นำออกแล้ว | ||
| setManualImpressions |
นำออกแล้ว | ||
| updateCorrelator() | นำออกแล้ว | ดูการกรองเนื้อหาโฆษณา | |
| PublisherAdRequest.Builder | setBirthday() | นำออกแล้ว | |
| setGender() | นำออกแล้ว | ||
| setIsDesignedForFamilies() | นำออกแล้ว | ดูคำแนะนำ | |
| addTestDevice() | RequestConfiguration |
ดูเปิดใช้โฆษณาทดสอบ | |
| tagForChildDirectedTreatment() | RequestConfiguration |
ดูการกรองเนื้อหาโฆษณา | |
| setTagFor |
RequestConfiguration |
||
| setMaxAdContentRating() | RequestConfiguration |
||
| AdView | getMediationAdapter |
ResponseInfo |
ออบเจ็กต์ ResponseInfo พร้อมใช้งานโดยใช้เมธอด AdView, getResponseInfo()
|
| NativeAdOptions | setImageOrientation() | setMediaAspectRatio() | |
| getImageOrientation | getMediaAspectRatio() | ||
| RewardedAd | loadAd(AdRequest, RewardedAdLoadCallback) | RewardedAd.load(Context, String, AdRequest, RewardedAdLoadCallback) | ตอนนี้ RewardedAd ใช้วิธีการโหลดแบบคงที่เหมือนกับรูปแบบโฆษณาแบบเต็มหน้าจออื่นๆ |
| loadAd(PublisherAdRequest, RewardedAdLoadCallback) | RewardedAd.load(Context, String, AdManagerAdRequest, RewardedAdLoadCallback) | ||
| isLoaded() | นำออกแล้ว | Callback จากเมธอดการโหลดแบบคงที่จะแสดงโฆษณาที่โหลดแล้ว | |
| show(Activity, RewardedAdCallback) | show(Activity, OnUserEarnedRewardListener) | วิธีการแสดงนี้เป็นไปตามแนวทางรูปแบบเต็มหน้าจอที่กว้างขึ้น | |
| RewardedAdLoadCallback | onRewardedAd |
onAd |
|
| onRewardedAd |
onAd |
||
| onRewardedAdLoaded() | onAdLoaded(RewardedAd) | ||
| AppOpenAdLoadCallback | onAppOpenAd |
onAd |
|
| onAppOpenAd |
onAd |
||
| onAppOpenAd |
onAdLoaded(AppOpenAd) | ||
| RewardedInterstitialAdLoad |
onRewardedInterstitialAd |
onAd |
|
| onRewardedInterstitialAd |
onAd |
||
| onRewardedInterstitialAd |
onAd |
||
| PublisherInterstitialAd | new PublisherInterstitialAd() | InterstitialAd.load(Context, String, AdRequest, InterstitialAdLoadCallback) | ตอนนี้ InterstitialAd ใช้วิธีการโหลดแบบคงที่เหมือนกับรูปแบบโฆษณาแบบเต็มหน้าจออื่นๆ |
| setAdListener() | |||
| DynamicHeightSearchAd |
getNetworkExtras() | นำออกแล้ว | เลิกใช้งานคลาส NetworkExtras แล้ว |
| AdLoader | forContentAd() | นำออกแล้ว | |
| forAppInstallAd() | นำออกแล้ว | ||
| withCorrelator() | นำออกแล้ว | ||
| getMediationAdapter |
นำออกแล้ว |