บันทึกประจำรุ่น

เวอร์ชัน	วันที่เผยแพร่	หมายเหตุ
25.5.0	2026‑09‑17	เพิ่มระดับ API ขั้นต่ำของ Android เป็น 24 เพิ่ม onInitializationFailed() ไปยัง InitializationCompleteCallback แล้ว ตอนนี้อะแดปเตอร์สื่อกลางจะรายงานข้อผิดพลาดในการเริ่มต้น SDK ของบุคคลที่สามไปยัง Google Mobile Ads SDK พร้อมรหัสข้อผิดพลาด โดเมนข้อผิดพลาด และข้อความแสดงข้อผิดพลาด เมื่อใช้สื่อกลางกับแหล่งที่มาของโฆษณาเหตุการณ์ที่กำหนดเอง ResponseInfo.getAdapterClassName() จะแสดงชื่อคลาสของเหตุการณ์ที่กำหนดเองแทน com.google.ads.mediation.customevent.CustomEventAdapter
25.4.0	2026‑06‑17	แก้ไขข้อบกพร่องและปรับปรุงประสิทธิภาพ
25.3.0	2026‑05‑21	เพิ่มเมธอด setAgeRestrictedTreatment() ใน RequestConfiguration.Builder และเลิกใช้ setTagForChildDirectedTreatment() กับ setTagForUnderAgeOfConsent() ใช้วิธีการใหม่เพื่อกำหนดค่าการดูแลตามอายุสำหรับผู้ใช้ที่เป็นเด็กและวัยรุ่น
25.2.0	2026‑04‑13	แก้ไขข้อบกพร่องและปรับปรุงประสิทธิภาพ
25.1.0	2026‑03‑16	แก้ไขข้อบกพร่องในเครื่องมือตรวจสอบโฆษณาที่อาจทำให้เกิดข้อผิดพลาดเมื่อขอโฆษณาทดสอบที่อยู่นอกบริบทโดยมี URL เนื้อหาว่างเปล่า
25.0.0	2026‑02‑17	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v25 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ นำคลาส VersionInfo ออกจากแพ็กเกจ com.google.android.gms.ads.mediation นำเมธอด getConfiguration() ที่เลิกใช้งานแล้วในคลาส RtbSignalData ออก นำเมธอดที่เลิกใช้งานแล้ว onFailure(String) และ onAdFailedToShow(String) ในคลาสต่อไปนี้ออก SignalCallbacks MediationAdLoadCallback MediationInterstitialAdCallback MediationRewardedAdCallback นำชั้นเรียน NativeAdViewHolder ออกจากแพ็กเกจ com.google.android.gms.ads.nativead นำ MIN_WIDTH_RATIO และ MIN_HEIGHT_RATIO ออกจาก MediationUtils เพื่อรองรับเกณฑ์การจับคู่ขนาดโฆษณาที่ยืดหยุ่นมากขึ้นสำหรับการไกล่เกลี่ย ขนาดโฆษณา อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 4.0.0 เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่ แบนเนอร์แบบปรับขนาดได้ที่ตรึงไว้ขนาดใหญ่ ได้รับการออกแบบมาเพื่อเพิ่มการมีส่วนร่วมและรายได้ ขอแบนเนอร์แบบปรับขนาดได้ที่ยึดตำแหน่งไว้ขนาดใหญ่โดยใช้วิธีต่อไปนี้ในคลาส AdSize getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() เมธอดต่อไปนี้ในคลาส AdSize ได้เลิกใช้งานแล้ว getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) getPortraitAnchoredAdaptiveBannerAdSize(Context, int)
24.9.0	2025‑12‑11	แก้ไขข้อบกพร่องและปรับปรุงประสิทธิภาพ
24.8.0	2025‑11‑20	แก้ไขการแปลทรัพยากร SDK ที่ขาดหายไปในเวอร์ชัน 24.6.0 และ 24.7.0 เลิกใช้งาน NativeAdViewHolder แล้ว โปรดใช้ NativeAdView เพื่อแสดงโฆษณาเนทีฟแทน เลิกใช้งานเมธอด AdPreloader.getConfigurations() และ AdPreloader.getConfiguration(preloadId) แล้ว โดยจะไม่มีการแทนที่วิธีการเหล่านี้
24.7.0	2025‑10‑09	แก้ไขคำอธิบายประกอบที่ขาดหายไปซึ่งอนุญาตให้เป็น Null ในประเภทการแสดงผลสำหรับ NativeCustomFormatAd.getDisplayOpenMeasurement() ฟังก์ชันการทำงานไม่เปลี่ยนแปลง เนื่องจากคาดการณ์ไว้แล้วว่าเมธอดจะแสดงผลเป็น Null ได้ อยู่แล้ว ลดเวอร์ชันandroidx.webkit:webkitทรัพยากร Dependency จาก 1.14.0 เป็น 1.12.1 เพื่อรักษาความเข้ากันได้กับปลั๊กอิน Android Gradle 7.3.1
24.6.0	2025‑09‑08	ตอนนี้อแดปเตอร์สื่อกลางเนทีฟสามารถใช้ NativeAdMapper.destroy() เพื่อรับการแจ้งเตือนเมื่อระบบทำลายโฆษณาเนทีฟแล้ว
24.5.0	2025‑07‑24	ตอนนี้ผู้เผยแพร่โฆษณาที่มีสิทธิ์เข้าถึงฟีเจอร์นี้จะได้รับการสนับสนุนรหัสตำแหน่ง สำหรับโฆษณาทุกรูปแบบ แก้ไขข้อขัดข้องที่มีข้อความแสดงข้อผิดพลาด Fatal Exception: java.util.ConcurrentModificationException
24.4.0	2025‑06‑09	เพิ่ม API ใหม่หลายรายการสำหรับการโหลดโฆษณาล่วงหน้าและเลิกใช้งาน API ที่มีอยู่ การโหลดโฆษณาล่วงหน้ายังคงเป็นฟีเจอร์อัลฟ่าแบบจำกัด
24.3.0	2025‑05‑19	อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 3.2.0
24.2.0	2025‑04‑07	แก้ไขข้อบกพร่องและปรับปรุงประสิทธิภาพ
24.1.0	2025‑03‑12	ตอนนี้เวอร์ชัน Kotlin ขั้นต่ำคือ 2.1.0 แก้ไขข้อบกพร่องและปรับปรุงประสิทธิภาพ play-services-ads-lite จะเปลี่ยนไปใช้ความถี่ในการเผยแพร่ที่ลดลง และจะไม่มีการเผยแพร่พร้อมกับรุ่นนี้ ดูข้อมูลเพิ่มเติมได้ใน เอกสารประกอบของ Lite SDK
24.0.0	2025‑02‑24	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v24 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ เพิ่มระดับ API ขั้นต่ำของ Android เป็น 23 SDK จะไม่ส่งต่อพารามิเตอร์เพิ่มเติมที่ส่งผ่าน addNetworkExtrasBundle() ไปยัง Ad Manager เป็นพารามิเตอร์การกำหนดเป้าหมายเองอีกต่อไป หากต้องการตั้งค่าการกำหนดเป้าหมายเอง ให้ใช้ addCustomTargeting() แทน ดูข้อมูลเพิ่มเติมได้ที่การกำหนดเป้าหมายเอง นำ API ทั้งหมดที่เกี่ยวข้องกับรูปแบบโฆษณาคั่นระหว่างหน้าออก นำ AppOpenAd API การวางแนวที่เลิกใช้งานแล้วออก นำชั้นเรียน SearchAdView และ DynamicHeightSearchAdRequest ออกแล้ว อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 3.1.0 การเพิ่มประสิทธิภาพการเริ่มต้น และการโหลดโฆษณาพร้อมให้บริการในเวอร์ชันสำหรับผู้ใช้ทั่วไปแล้ว และระบบจะเปิดใช้โดย ค่าเริ่มต้น เพิ่ม MediationRewardedAdCallback.onUserEarnedReward() และเลิกใช้งาน MediationRewardedAdCallback.onUserEarnedReward(RewardItem) แล้ว อแดปเตอร์สื่อกลางควรได้รับการอัปเดตเพื่อใช้วิธีการใหม่ นำแท็กพร็อพเพอร์ตี้ android.adservices.AD_SERVICES_CONFIG ออกจากไฟล์ Manifest ของ SDK เพื่อป้องกันความขัดแย้งในการผสานสำหรับ แอปที่ กำหนดค่าบริการโฆษณาเฉพาะ API
23.6.0	2024‑12‑03	เลิกใช้งาน API ทั้งหมดที่เกี่ยวข้องกับรูปแบบโฆษณา Interscroller เช่น AdSize.getCurrentOrientationInterscrollerAdSize()
23.5.0	29-10-2024	อัปเดตข้อความ Logcat ที่ระบุว่าโหลดโฆษณาไม่สำเร็จซึ่งเปิดตัวในการเผยแพร่เวอร์ชัน 23.4.0 จากระดับข้อผิดพลาดเป็นระดับข้อมูล การสร้างรายได้จากโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ในแท็บที่กำหนดเองสำหรับ WebView API สำหรับโฆษณาที่ดียิ่งขึ้น
23.4.0	2024‑09‑30	ตอนนี้ความล้มเหลวในการโหลดโฆษณาจะเรียกใช้ข้อความ Logcat ที่ระบุว่า ad failed to load ในสแต็กเทรซของความล้มเหลว สแต็กเทรซจะบันทึกข้อความนี้เป็นข้อผิดพลาด แต่ไม่ได้หมายความว่าแอปขัดข้อง โปรดดูแก้ไขข้อความบันทึกข้อผิดพลาดที่พบบ่อย เพื่อตีความการโหลดโฆษณาที่ไม่สำเร็จที่พบบ่อย หากเห็นข้อผิดพลาดที่เกิดขึ้นซ้ำๆ ที่เกี่ยวข้องกับการแสดงโฆษณาซึ่งไม่มีในเอกสาร โปรดแชร์สแต็กเทรซกับทีม Google Mobile Ads SDK (Legacy)สนับสนุน เพิ่มวิธีการ addCustomTargeting() ไปยัง AdRequest แล้ว
23.3.0	12-08-2024	อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 3.0.0
23.2.0	2024‑06‑27	เพิ่ม AdView.isCollapsible() เพื่อระบุว่าแบนเนอร์ที่โหลดล่าสุดเป็นแบบย่อได้หรือไม่
23.1.0	2024‑05‑09	ต้องมีคะแนนขั้นต่ำ compileSdkVersion ที่ 34 อแดปเตอร์สื่อกลางเนทีฟ: เลิกใช้งาน loadNativeAd และ loadRtbNativeAd() แล้วเพื่อใช้ loadNativeAdMapper() และ loadRtbNativeAdMapper() แทน อแดปเตอร์ควรย้ายข้อมูลไปใช้เมธอดการโหลดใหม่เหล่านี้และออบเจ็กต์ที่เกี่ยวข้อง
23.0.0	2024‑03‑07	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v23 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ เพิ่มระดับ API ขั้นต่ำของ Android เป็น 21 หากต้องการเก็บรวบรวมเมตริกผู้ใช้ใน AdMob ต่อไป ให้ลิงก์แอป AdMob กับ Firebase และผสานรวม SDK ของ Google Analytics สำหรับ Firebase เข้ากับแอป นำ MobileAds.enableSameAppKey() API ที่เลิกใช้งานแล้ว ออกและอัปเดตเมธอดทางเลือก MobileAds.putPublisherFirstPartyIdEnabled() เพื่อแสดงผลบูลีนเกี่ยวกับว่าการคงการควบคุมสำเร็จหรือไม่ Native Ads: นำ AdLoader.forUnifiedNativeAd() ออกแล้ว โปรดใช้ AdLoader.forNativeAd() แทน นำ AdLoader.forCustomTemplateAd() ออกแล้ว โปรดใช้ AdLoader.forCustomFormatAd() แทน นำ AdFormat.UNKNOWN ออกโดยไม่มีการแทนที่ แอปที่ใช้ QueryInfo.generate() ต้องส่งรูปแบบโฆษณา ตอนนี้คุณสามารถเชื่อมโยงเมธอด AdManagerAdRequest.Builder ที่รับค่ามาจาก ออบเจ็กต์หลักเข้าด้วยกันเพื่อสร้างออบเจ็กต์จากการเรียกครั้งเดียวได้แล้ว การดำเนินการนี้จำเป็นต้องมีการเปลี่ยนแปลงโครงสร้างการรับค่าเพื่อให้ AdManagerAdRequest.Builder ไม่รับค่าจาก AdRequest.Builder อีกต่อไป เพิ่ม MobileAds.registerCustomTabsSession() เพื่อปรับปรุงการสร้างรายได้สำหรับโฆษณาในแท็บที่กำหนดเอง ดูข้อมูลเพิ่มเติมได้ที่เพิ่มประสิทธิภาพแท็บที่กำหนดเอง อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 2.2.0
22.6.0	2023‑12‑06	เลิกใช้งาน MobileAds.setSameAppKeyEnabled() และเปลี่ยนชื่อ เมธอดเป็น MobileAds.putPublisherFirstPartyIdEnabled() เลิกใช้งาน AdFormat.UNKNOWN โดยไม่มีการแทนที่ แอป ที่ใช้ QueryInfo.generate() ต้องส่งรูปแบบโฆษณา
22.5.0	2023‑10‑30	อัปเดตทรัพยากร Dependency ของ SDK สำหรับ User Messaging Platform เป็นเวอร์ชัน 2.1.0 เพิ่มเมธอด setPublisherPrivacyPersonalizationState() สำหรับ Publisher Privacy Treatment API (เบต้า)
22.4.0	2023‑09‑13	ต้องมีcompileSdkVersionอย่างน้อย 33 เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สำหรับการขอและแสดงโฆษณา ที่ขอผ่าน UI ของเครื่องมือตรวจสอบโฆษณา เพิ่มเมธอด QueryInfo.generate() ใหม่ที่ใช้รหัสหน่วยโฆษณา เปิดใช้การทดสอบเบต้าของ Attribution Reporting และเบต้าของ Topics API การรักษาความเป็นส่วนตัวระยะแรก ดูข้อมูลเพิ่มเติมได้ในคู่มือ Privacy Sandbox ใน Android ของ Ad Manager
22.3.0	2023‑08‑22	เพิ่มการรองรับการสร้างขนาดแบบปรับได้โดยใช้ AdSize.FULL_WIDTH เป็นความกว้าง ก่อนหน้านี้ ระบบจะถือว่าขนาดโฆษณาที่สร้างโดยใช้ AdSize.FULL_WIDTH เป็น AdSize.SMART_BANNER
22.2.0	2023‑07‑05	เหตุการณ์ที่กำหนดเอง: เลิกใช้งานแล้ว AdRequest.Builder.addCustomEventExtrasBundle() ขยาย Adapter และโต้ตอบกับพารามิเตอร์เพิ่มเติมผ่าน AdRequest.Builder.addNetworkExtrasBundle() แทน เลิกใช้งาน AdRequest.getCustomEventExtrasBundle() แล้ว ขยาย Adapter และโต้ตอบกับพารามิเตอร์เพิ่มเติมผ่าน AdRequest.getNetworkExtrasBundle() แทน
22.1.0	2023‑05‑18	เครื่องมือตรวจสอบโฆษณา: เปิดใช้ความสามารถในการทริกเกอร์คำขอโฆษณาจาก UI ของเครื่องมือตรวจสอบโฆษณาในอุปกรณ์ที่ไม่มีบริการ Google Play
22.0.0	2023‑03‑29	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ที่ย้ายข้อมูลไปยัง SDK v22 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ นำ NativeCustomFormatAd.getVideoController() และ NativeCustomFormatAd.getVideoMediaView() ออกเพื่อ NativeCustomFormatAd.getMediaContent() นำ MobileAds.getVersionString() ออกแล้วเพื่อ MobileAds.getVersion() นำ AdRequest.Builder.setAdInfo() ออกแล้วเพื่อ AdRequest.Builder.setAdString() ตอนนี้ AdManager.Builder.setAdString() จะแสดงผลประเภท AdRequest.Builder นำ MediationRewardedVideoAdAdapter และ API ที่เกี่ยวข้องออกเพื่อใช้ Adapter แทน เพิ่ม AdRequest.getRequestAgent() แล้ว สื่อกลาง: ค่าที่ส่งคืนสำหรับ Adapter.getVersionInfo() และ Adapter.getSDKVersionInfo() เปลี่ยนจากประเภท com.google.android.gms.ads.mediation.VersionInfo เป็น com.google.android.gms.ads.VersionInfo เราขอแนะนำให้ อแดปเตอร์ส่งคืนประเภทใหม่เนื่องจาก com.google.android.gms.ads.mediation.VersionInfo เลิกใช้งานแล้ว
21.5.0	2023‑01‑31	โฆษณาที่เปิดแอป: เลิกใช้งานเมธอด AppOpenAd.load() ที่ยอมรับพารามิเตอร์อินพุตการวางแนว และเพิ่มเมธอดใหม่ ที่ไม่ใช้การวางแนวเป็นอินพุต วิธีการใหม่จะกำหนด การวางแนวในเวลาที่ส่งคำขอ ซึ่งตรงกับลักษณะการทำงานของรูปแบบ เต็มหน้าจออื่นๆ สื่อกลาง: เพิ่มการรองรับสื่อกลางสำหรับโฆษณาเปิดแอป นำสิทธิ์ RECEIVE_BOOT_COMPLETED ออกจาก การอ้างอิง androidx.work:work-runtime หากคุณใช้ Gradle เวอร์ชันเก่ากว่า 7.2.0 และต้องใช้สิทธิ์สำหรับแอป คุณอาจต้องประกาศสิทธิ์อย่างชัดแจ้งในไฟล์ Manifest ของ Android
21.4.0	2022‑12‑14	ตอนนี้แอป Ad Manager ทั้งหมดต้องใช้รหัสแอป Ad Manager และต้องใช้รูปแบบ ca-app-pub-################~########## ดูรายละเอียดเพิ่มเติมได้ที่กําหนดค่าแอป เครื่องมือตรวจสอบโฆษณา: ขยายการรองรับ SDK สำหรับการแสดงโฆษณาแบนเนอร์และ โฆษณาเนทีฟที่ขอผ่าน UI ของเครื่องมือตรวจสอบโฆษณา เพิ่มการรองรับตัวระบุของบุคคลที่หนึ่งของผู้เผยแพร่โฆษณา (เดิมเรียกว่าคีย์แอปเดียวกัน) เพื่อช่วยให้คุณแสดงโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ได้และเกี่ยวข้องมากขึ้นโดยการใช้ข้อมูลที่รวบรวมจากแอปของคุณ เวอร์ชันที่เผยแพร่อย่างเป็นทางการสำหรับ QueryInfo รุ่นที่
21.3.0	2022‑10‑10	เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สำหรับการขอและแสดงโฆษณา ที่ขอผ่าน UI ของเครื่องมือตรวจสอบโฆษณา โฆษณาเนทีฟ: เพิ่ม getMediaContent() ไปยัง MediaView แล้ว โฆษณาเนทีฟที่กำหนดเอง: เพิ่ม getMediaContent() ไปยัง NativeCustomFormatAd แล้ว เลิกใช้งาน getVideoMediaView() แล้ว สร้าง MediaView ของคุณเอง และใช้ NativeCustomFormatAd.getMediaContent() แทน เลิกใช้งาน getVideoController() แล้ว โปรดใช้ NativeCustomFormatAd.getMediaContent().getVideoController() แทน
21.2.0	2022‑09‑06	เครื่องมือตรวจสอบโฆษณา: เพิ่มการรองรับ SDK สำหรับการส่งออกบันทึกคำขอโฆษณาผ่าน Android Sharesheet
21.1.0	2022‑07‑14	เพิ่มการรองรับการสร้างรายได้จากโฆษณาภายใน WebView ดูรายละเอียดเพิ่มเติมได้ที่ ผสานรวม WebView API สำหรับโฆษณา เพิ่ม getResponseExtras() ไปยัง ResponseInfo ซึ่งอาจแสดงข้อมูลเพิ่มเติมเกี่ยวกับการตอบกลับของโฆษณา เบต้า: getResponseExtras() API อยู่ในเวอร์ชันเบต้า ค่าที่ส่งคืนอาจเปลี่ยนแปลงได้โดยไม่ต้องเผยแพร่ SDK
21.0.0	2022‑05‑25	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ในคำแนะนำย้ายข้อมูลไปยัง SDK v21 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ Google Mobile Ads SDK (Legacy) กำหนดให้แอปทั้งหมดต้องมี Android API ระดับ API 19 เป็นอย่างน้อยจึงจะเรียกใช้ได้ เพิ่มคำอธิบายประกอบ @NonNull ในทุกเมธอดที่ก่อนหน้านี้ไม่ได้กำหนดค่า Nullability อย่างชัดเจน นำเมธอด AdRequest.Builder.addNetworkExtras() ออกแล้ว โปรดใช้ AdRequest.Builder.addNetworkExtrasBundle() แทน นำวิธีการระบุตำแหน่งต่อไปนี้ออก setLocation() ใน AdRequest.Builder getLocation() ใน AdRequest getLocation() ใน MediationAdConfiguration เพิ่มค่าสถานะของไฟล์ Manifest เพื่อเพิ่มประสิทธิภาพการเริ่มต้นและการโหลดโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่ คู่มือการเพิ่มประสิทธิภาพการเริ่มต้นและการโหลดโฆษณา เลิกใช้งาน MobileAds.getVersionString() แล้ว โปรดใช้ MobileAds.getVersion() แทน เพิ่มเมธอด getLoadedAdapterResponseInfo() ใน ResponseInfo เพิ่มวิธีการต่อไปนี้ใน AdapterResponseInfo: getAdSourceName() getAdSourceId() getAdSourceInstanceName() getAdSourceInstanceId() เบต้า: API เหล่านี้อยู่ในเวอร์ชันเบต้า ค่าที่ส่งคืน อาจเปลี่ยนแปลงได้โดยไม่ต้องเผยแพร่ SDK เพิ่มการรองรับเหตุการณ์ที่กําหนดเองในเครื่องมือตรวจสอบโฆษณา
20.6.0	2022‑02‑22	เลิกใช้งาน อินเทอร์เฟซเหตุการณ์ที่กําหนดเองทั้งหมด โปรดใช้คลาส Adapter และอินเทอร์เฟซ MediationAdLoadCallback แทน เพิ่มการรองรับ SharedPreferences gad_has_consent_for_cookies Google Mobile Ads SDK (Legacy) จะเปิดใช้ โฆษณาแบบจำกัด (LTD) เมื่อตั้งค่า gad_has_consent_for_cookies เป็น 0 ดูรายละเอียดเพิ่มเติมได้ที่ การตั้งค่าความยินยอมสำหรับคุกกี้ Google Mobile Ads SDK (Legacy) จะปิดใช้การส่งตัวระบุโฆษณา Android (AAID) เมื่อมีการเรียกใช้ RequestConfiguration.Builder.setTagForChildDirectedTreatment() ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (ดู การตั้งค่าที่กำหนดเป้าหมายเป็นเด็ก) หรือ RequestConfiguration.Builder.setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (ดู การตั้งค่าผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้)
20.5.0	2021‑11‑18	เพิ่มการรองรับอุปกรณ์ Android 12 สำหรับแอปที่กำหนดเป้าหมายเป็น API 31 เพิ่มการรองรับ รหัสชุดแอป สำหรับกรณีการใช้งาน เช่น การรายงานและการป้องกันการประพฤติมิชอบ
20.4.0	2021‑09‑22	การเปิดตัวนี้และเวอร์ชันก่อนหน้าทั้งหมดต้องมีทรัพยากร Dependency ที่ชัดเจน ใน androidx.work:work-runtime:2.7.0 เพื่อแก้ไขข้อบกพร่องที่ทำให้แอป ขัดข้องใน Android S โดยมีสแต็กเทรซดังนี้ Fatal Exception: java.lang.IllegalArgumentException: com.mycompany.myapp: Targeting S+ (version 10000 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent. Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles. at android.app.PendingIntent.checkFlags(PendingIntent.java:386) at android.app.PendingIntent.getBroadcastAsUser(PendingIntent.java:657) at android.app.PendingIntent.getBroadcast(PendingIntent.java:644) at androidx.work.impl.utils.ForceStopRunnable.getPendingIntent(ForceStopRunnable.java:174) at androidx.work.impl.utils.ForceStopRunnable.isForceStopped(ForceStopRunnable.java:108) at androidx.work.impl.utils.ForceStopRunnable.run(ForceStopRunnable.java:86) at androidx.work.impl.utils.SerialExecutor$Task.run(SerialExecutor.java:75) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1167) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:641) at java.lang.Thread.run(Thread.java:920) หากต้องการแก้ไขข้อบกพร่องนี้ ให้เพิ่มทรัพยากร Dependency ต่อไปนี้สำหรับ Google Mobile Ads SDK (Legacy) ลงในไฟล์ Gradle ระดับแอปของโมดูล dependencies { implementation 'com.google.android.gms:play-services-ads:20.4.0' // For apps targeting Android 12, add WorkManager dependency. constraints { implementation('androidx.work:work-runtime:2.7.0') { because '''androidx.work:work-runtime:2.1.0 pulled from play-services-ads has a bug using PendingIntent without FLAG_IMMUTABLE or FLAG_MUTABLE and will fail in Apps targeting S+.''' } } } ตั้งแต่เวอร์ชัน 20.4.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) จะรวม com.google.android.gms.permission.AD_ID ไว้ใน ไฟล์ Manifest ของ SDK ซึ่งเครื่องมือสร้างของ Android จะนำไปผสานกับไฟล์ Manifest ของแอปโดยอัตโนมัติ ดูข้อมูลเพิ่มเติมเกี่ยวกับAD_ID การประกาศสิทธิ์ รวมถึงวิธีปิดใช้สิทธิ์ดังกล่าวได้ที่ บทความนี้ในศูนย์ช่วยเหลือของ Play Console เพิ่ม onAdClicked() Callback ไปยัง FullScreenContentCallback เปิดใช้ onAdClicked() ในคลาส AdListener สำหรับรูปแบบโฆษณาเนทีฟ
20.3.0	2021‑08‑23	เลิกใช้งานเมธอด AdRequest.Builder.addNetworkExtras() ใช้ AdRequest.Builder.addNetworkExtrasBundle() แทน โฆษณาเนทีฟ AdLoader.Builder.forCustomFormatAd() ตอนนี้ยอมรับ OnCustomClickListener ที่เป็น Null ได้แล้ว Ad Mediation: แก้ไขคำอธิบายประกอบการยอมรับค่า Null สำหรับพารามิเตอร์ mediationExtras ในการเรียกโหลด Ad Mediation ทั้งหมด
20.2.0	2021‑06‑08	เพิ่มการรองรับเครื่องมือตรวจสอบโฆษณา (เบต้า) สำหรับผู้เผยแพร่โฆษณา Google Ad Manager
20.1.0	2021‑04‑29	แบนเนอร์แบบปรับขนาดได้: เพิ่ม AdSize.getInlineAdaptiveBannerAdSize() เพื่อขอโฆษณาแบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัดที่มีความสูงสูงสุด เพิ่ม AdError.toString() เพื่อให้บันทึกได้ง่ายขึ้น
20.0.0	2021‑04‑05	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักที่มี การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องหลายอย่าง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีย้ายข้อมูลได้ในคู่มือเตรียมพร้อมสำหรับ SDK v20 การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ นำ API Interstitial เดิมออกแล้ว นำ API RewardedVideoAd เดิมออกแล้ว ชั้นเรียนที่นำออกซึ่งมีคำนำหน้าเป็น Publisher (เช่น PublisherAdView) นำ CustomRenderedAd ออกแล้ว นำ InstreamAd ออกแล้ว นำ SearchAdRequest ออกแล้ว นำ AdListener.onAdLeftApplication() ออกแล้ว นำ NativeAppInstallAd NativeContentAd และ UnifiedNativeAd ออกแล้ว ตอนนี้มีรูปแบบโฆษณาเนทีฟ 1 รูปแบบชื่อ NativeAd RewardedAd ตอนนี้เป็นคลาส Abstract แล้ว ใช้เมธอดแบบคงที่ RewardedAd.load() เพื่อโหลดโฆษณาที่มีการให้รางวัล เลิกใช้งาน AdSize.SMART_BANNER เพื่อ โฆษณา แบนเนอร์แบบปรับขนาดได้ เพิ่มคำอธิบายประกอบการยอมรับค่า Null อย่างชัดเจนใน API สาธารณะทั้งหมด
19.8.0	2021‑03‑15	เพิ่มการอ้างอิงใน SDK สำหรับ User Messaging Platform เพิ่ม onAdImpression() Callback ไปยัง FullScreenContentCallback เลิกใช้งานรูปแบบ InstreamAd Ad Mediation Adapters: เลิกใช้งาน MediationBannerAdapter, MediationInterstitialAdapter และ MediationNativeAdapter อแดปเตอร์ใหม่ควรใช้คลาส Adapter เพื่อ โหลดรูปแบบเหล่านี้ หมายเหตุ: เราจะไม่นำคลาสของอแดปเตอร์สื่อกลางที่เลิกใช้งานแล้วเหล่านี้ ออกในเวอร์ชัน 20.0.0 เพื่อให้เวลาแก่อแดปเตอร์สื่อกลางในการเปลี่ยนไปใช้ API ใหม่ ตอนนี้ Bidding Adapter สามารถใช้เมธอดการโหลดที่แตกต่างกันในคลาส Adapter สำหรับ รูปแบบที่เฉพาะเจาะจงของ RTB ได้แล้ว
19.7.0	2021‑01‑20	การเปลี่ยนแปลงที่สำคัญในส่วนต่อไปนี้ InterstitialAd RewardedAd NativeAd AppOpenAd เลิกใช้งาน CustomRenderedAd แล้ว คลาสและแพ็กเกจที่มีคำนำหน้า Publisher ถูกเลิกใช้งานแล้วและแทนที่ด้วยคำนำหน้า AdManager รุ่นย่อยสุดท้ายก่อนเวอร์ชัน 20.0.0 API ทั้งหมดที่ทำเครื่องหมายว่าเลิกใช้งานแล้ว ในรุ่นนี้และรุ่นก่อนหน้าจะถูกนำออกในเวอร์ชัน 20.0.0 ดูรายละเอียดเพิ่มเติมได้ที่คำแนะนำในการย้ายข้อมูลเวอร์ชัน 20.0.0
19.6.0	2020‑12‑04	เลิกใช้งานเมธอด onAdLeftApplication() AdListener แก้ไขข้อบกพร่องที่ระบบขอให้ผู้ใช้ในอุปกรณ์ Android 11 เลือกเบราว์เซอร์เมื่อคลิกโฆษณา
19.5.0	2020‑10‑20	โฆษณาแบนเนอร์: ตอนนี้ระบบจะเรียกใช้เมธอด onAdImpression() AdListener สำหรับโฆษณาแบนเนอร์ เพิ่มเมธอด setHttpTimeoutMillis() เพื่อปรับแต่งการหมดเวลาสำหรับการเรียก HTTPS ที่ทำโดย Google Mobile Ads SDK เพิ่ม setNeighboringContentUrls() และ getNeighboringContentUrls() ไปยัง PublisherAdRequest แล้ว
19.4.0	2020‑09‑10	เพิ่มการรองรับอุปกรณ์ Android 11 สำหรับแอปที่กำหนดเป้าหมายเป็น API 30 โฆษณาเปิดแอป: เปลี่ยนAppOpenAdรูปแบบเพื่อให้ทำงานได้ เหมือนรูปแบบเต็มหน้าจอมากกว่ามุมมองแบนเนอร์ เพิ่มเมธอด getResponseInfo() และ show() ลงใน AppOpenAd เลิกใช้งานคลาส AppOpenAdView และ AppOpenAdPresentationCallback สื่อกลาง: การรายงานสถานะสื่อกลางพร้อมใช้งานแล้ว ใช้ ResponseInfo.getAdapterResponses() เพื่อรับข้อมูลการตอบกลับสำหรับเครือข่ายโฆษณาแต่ละเครือข่ายที่เข้าร่วมในคำขอ โฆษณา โฆษณาที่มีการให้รางวัลเดิม: เลิกใช้งานแล้วRewardedVideoAd เพิ่มรูปแบบ RewardedInterstitialAd ใน เวอร์ชันเบต้าส่วนตัว แก้ไขข้อบกพร่องที่ทำให้ MobileAds.initialize() เรียกใช้ตัวแฮนเดิลการดำเนินการให้เสร็จสมบูรณ์เพียงครั้งเดียว การโทรทุกครั้งไปยัง MobileAds.initialize() จะเรียกใช้การเรียกกลับการดำเนินการให้เสร็จสมบูรณ์
19.3.0	2020‑07‑20	ข้อควรระวัง: SDK เวอร์ชัน 19.3.0 และต่ำกว่าไม่รองรับ Android 11 (API 30) เราขอแนะนำให้ใช้ SDK เวอร์ชัน 19.4.0 ขึ้นไป หากคุณวางแผนที่จะตั้งค่า targetSdkVersion เป็น API 30 เพิ่มเมธอด getDomain() และ getCause() ไปยัง AdError เพิ่ม Callback ใหม่สำหรับการโหลดไม่สำเร็จไปยังโฆษณาทุกรูปแบบที่แสดงผลเป็น LoadAdError เช่น onAdFailedToLoad(LoadAdError). เลิกใช้งาน Callback ของการโหลดไม่สำเร็จที่แสดงผล int เช่น onAdFailedToLoad(int) โฆษณาที่มีการให้รางวัล: เพิ่ม onRewardedAdFailedToShow(AdError) และเลิกใช้งาน onRewardedAdFailedToShow(int) สื่อกลางแบบมีรางวัล: เพิ่มMEDIATION_SHOW_ERROR รหัสข้อผิดพลาดในการนำเสนอ ข้อผิดพลาดในการนำเสนอทั้งหมดที่เกี่ยวข้องกับโฆษณาที่ไกล่เกลี่ยจะ แสดงผล MEDIATION_SHOW_ERROR สำหรับ AdError.getCode() และ AdError.getCause() ที่ไม่ใช่ Null ซึ่งแสดงถึงข้อผิดพลาดในการไกล่เกลี่ยพื้นฐาน
19.2.0	2020‑06‑18	โฆษณาเนทีฟ: เพิ่ม UI ของเครื่องมือตรวจสอบโฆษณาเนทีฟในคำขอทดสอบ เพื่อช่วยคุณตรวจหาและแก้ไขการละเมิดนโยบายโฆษณาเนทีฟ เพิ่มเมธอด MobileAds.disableMediationAdapterInitialization() เรียกใช้เมธอดนี้ก่อนเริ่มต้น Google Mobile Ads SDK (Legacy) เพื่อ ปิดใช้การเริ่มต้นของตัวกลางสื่อกลาง คำเตือน: การเรียกใช้วิธีนี้อาจส่งผลเสียต่อ ประสิทธิภาพสื่อกลางของ Google ควรเรียกใช้เมธอดนี้เฉพาะในกรณีที่คุณรวม AdMob Mediation Adapter ไว้ในแอป แต่ไม่ได้ใช้สื่อกลางผ่าน Google ในเซสชันแอปหนึ่งๆ (เช่น คุณกำลังทำการทดสอบสื่อกลางแบบ A/B)
19.1.0	2020‑04‑16	เลิกใช้งาน MobileAds.initialize(Context, String) แล้วหันมาใช้ MobileAds.initialize(Context, OnInitializationCompleteListener) แทน AdRequest.isTestDevice() ตอนนี้จะแสดงผล true สำหรับอุปกรณ์ทดสอบที่ตั้งค่าผ่าน MobileAds.setRequestConfiguration() แก้ไขข้อขัดข้อง NullPointerException ใน MobileAds.initialize() ที่เกิดขึ้นในอุปกรณ์บางรุ่นในแอปที่ใช้ Lite SDK
19.0.1	2020‑03‑18	โฆษณาเนทีฟ: แก้ไขปัญหาหน่วยความจำรั่วที่เกิดขึ้นเมื่อใช้ NativeCustomTemplateAd
19.0.0	2020‑03‑02	การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันที่สำคัญ ซึ่งมีการเปลี่ยนแปลงที่ทำให้เกิดข้อผิดพลาดต่อไปนี้ อัปเดตเวอร์ชัน Android SDK ขั้นต่ำเป็น API 16 เพื่อให้สอดคล้องกับ นโยบายการจัดจำหน่ายบริการ Google Play โฆษณาเนทีฟ: ย้าย MediaContent ไปยัง แพ็กเกจ com.google.android.gms.ads เพิ่มการรองรับการอ่านพารามิเตอร์ความยินยอมจาก TCF เวอร์ชัน 2.0 ของ IAB และสตริง us_privacy ของ IAB เพิ่ม setNeighboringContentUrls() และ getNeighboringContentUrls() ไปยัง AdRequest แล้ว เพิ่มResponseInfo class ซึ่งให้ข้อมูล เกี่ยวกับโฆษณาที่โหลด สำหรับโฆษณาทุกรูปแบบ เราได้เลิกใช้งาน getMediationAdapterClassName() และหันมาใช้ getResponseInfo() แทน โฆษณาเนทีฟ: เพิ่มเมธอด getDuration() และ getCurrentTime() ลงใน MediaContent สื่อกลางแบบเนทีฟ: เพิ่มเมธอด getDuration() และ getCurrentTime() ลงใน UnifiedNativeAdMapper เพื่อให้ตัวกลางนำไปใช้ เลิกใช้งานแล้ว AdRequest.Builder.addTestDevice() ใช้ RequestConfiguration.Builder.setTestDeviceIds() แทน
18.3.0	2019‑11‑05	เพิ่ม API สำหรับรูปแบบโฆษณา InstreamAd ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้าแบบส่วนตัว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง แบนเนอร์แบบปรับขนาดได้: เปลี่ยนวิธีการสร้างแบนเนอร์แบบปรับขนาดได้ใน AdSize คลาส เช่น เปลี่ยนชื่อ AdSize.getCurrentOrientationBannerAdSizeWithWidth() เป็น AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize() สื่อกลาง: Google Mobile Ads SDK (Legacy) จะตรวจหาข้อยกเว้น ที่อะแดปเตอร์สื่อกลางส่งมา สื่อกลางแบบมีรางวัล: แก้ไขข้อบกพร่องที่ว่าหากแคชโฆษณาที่มีการให้รางวัลซึ่งใช้สื่อกลางหลายรายการ จะมีเพียงโฆษณาเดียวเท่านั้นที่แสดง เพิ่มเมธอด setTestDeviceIds() เพื่อเปิดใช้การตั้งค่า อุปกรณ์ทดสอบครั้งเดียวสำหรับคำขอโฆษณาทั้งหมด
18.2.0	2019‑08‑29	เพิ่ม API สำหรับรูปแบบ AppOpenAd ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้าแบบส่วนตัว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
18.1.1	2019‑07‑23	สื่อกลาง: ตอนนี้ระบบจะเริ่มต้นใช้งานอแดปเตอร์เมื่อแอปเรียกใช้ MobileAds.initialize(Context, OnInitializationCompleteListener) สื่อกลาง: ตอนนี้ Google Mobile Ads SDK (Legacy) จะจับและจัดการข้อยกเว้นของอแดปเตอร์ที่มีสแต็กเทรซซึ่งมี Google Mobile Ads SDK (Legacy)
18.1.0	2019‑07‑09	การเปิดตัวอย่างเป็นทางการสำหรับการรองรับการวัดผลแอป เพิ่มวิธีการเริ่มต้นใหม่ MobileAds.initialize(Context, OnInitializationCompleteListener) ซึ่งจะแจ้งให้คุณทราบเมื่อ Google Mobile Ads SDK (Legacy) และตัวกลาง การไกล่เกลี่ยที่กำหนดค่าทั้งหมดเริ่มต้นเสร็จสมบูรณ์ เพิ่ม MobileAds.getInitializationStatus() เพื่อแสดงสถานะการเริ่มต้นของเครือข่ายโฆษณาทั้งหมดที่กำหนดค่าไว้สำหรับแอป เพิ่ม MobileAds.getRequestConfiguration() แล้ว พารามิเตอร์การกำหนดเป้าหมายที่ตั้งค่าไว้ในออบเจ็กต์การกำหนดค่านี้จะใช้กับคำขอโฆษณาทั้งหมด โฆษณาเนทีฟ: เพิ่มเมธอด NativeAdOptions.Builder.setMediaAspectRatio() เพื่อขอสัดส่วนภาพที่เฉพาะเจาะจงสำหรับชิ้นงานสื่อของโฆษณาเนทีฟ ตัวเลือกนี้มีความสำคัญเหนือกว่าวิธี setImageOrientation() ที่เลิกใช้งานแล้วในขณะนี้ โฆษณาเนทีฟ: สำหรับโฆษณาที่ไม่ใช่วิดีโอ ตอนนี้คุณสามารถตั้งค่าประเภทการปรับขนาดรูปภาพของ MediaView ได้โดยใช้ MediaView.setImageScaleType() โฆษณาเนทีฟ: เพิ่ม UnifiedNativeAd.getMediaContent() ตอนนี้ผู้เผยแพร่โฆษณาที่โหลดรูปภาพโดยใช้ URL เท่านั้นจะรับเนื้อหาสื่อของโฆษณา ระบุรูปภาพ และเรียกใช้ MediaView.setMediaContent() เพื่อป้อนข้อมูลรูปภาพ ผ่าน MediaView สำหรับโฆษณาที่ไม่ใช่วิดีโอได้แล้ว โฆษณาเนทีฟ: เพิ่ม API เพื่อเปิดใช้การรองรับ Open Measurement สำหรับ รูปแบบโฆษณาเนทีฟที่กำหนดเองที่ไม่ใช่วิดีโอ สื่อกลางโฆษณาเนทีฟ: ตอนนี้อแดปเตอร์สามารถระบุสัดส่วนภาพได้โดยใช้ UnifiedNativeAdMapper.setMediaContentAspectRatio() นำคลาส Correlator และ API ที่เกี่ยวข้องออก ก่อนหน้านี้ฟีเจอร์นี้ใช้งานไม่ได้ เพิ่มการขึ้นต่อกันใน play-services-measurement และ play-services-measurement-sdk แอปไม่จำเป็นต้องเพิ่มการอ้างอิงเหล่านี้อย่างชัดเจนอีกต่อไป
18.0.0	2019‑06‑17	การย้ายข้อมูลจากไลบรารีการสนับสนุน Android ไปยังไลบรารี Jetpack (AndroidX) ดูข้อมูลเพิ่มเติมได้ที่ บันทึกประจำรุ่นของบริการ Google Play เพื่อหลีกเลี่ยงข้อขัดข้องที่เกิดขึ้นเมื่อเปิดตัวครั้งแรกหลังจากติดตั้งแอปจาก Play Store การเปิดตัวนี้กำหนดให้ผู้เผยแพร่โฆษณาต้องประกาศการอ้างอิงเพิ่มเติมใน build.gradle ดังนี้ com.google.android.gms:play-services-measurement:17.0.0 com.google.android.gms:play-services-measurement-sdk:17.0.0 หมายเหตุ: การเปิดตัวนี้เป็นการอัปเดตเวอร์ชันหลักและมีการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง
17.2.1	2019‑05‑21	แก้ไข ANR ที่เกิดจาก android.media.AudioManager.getStreamVolume
17.2.0	2019‑03‑11	วิดีโอที่มีการให้รางวัล: เพิ่มชุด API ที่มีการให้รางวัลใหม่ (ดูแพ็กเกจ rewarded ) ซึ่งช่วยให้คุณโหลดโฆษณาที่มีการให้รางวัลหลายรายการพร้อมกันได้ สื่อกลาง: เพิ่มชุด API ของอแดปเตอร์สื่อกลางใหม่ที่รองรับ การเริ่มต้น อแดปเตอร์ที่ใช้ API ใหม่จะใช้คลาส Adapter ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics ร่วมกับเวอร์ชัน 17.2.0 ของคลังโฆษณาใดก็ได้ (เช่น com.google.android.gms:play-services-ads:17.2.0) ต้องใช้ com.google.firebase:firebase-analytics:16.3.0
17.1.3	2019‑01‑31	ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics ร่วมกับเวอร์ชัน 17.1.3 ของคลังโฆษณาใดก็ได้ (เช่น com.google.android.gms:play-services-ads:17.1.3) ต้องใช้ com.google.firebase:firebase-analytics:16.3.0
17.1.2	2018‑12‑03	ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics ร่วมกับเวอร์ชัน 17.1.2 ของคลังโฆษณาใดก็ได้ (เช่น com.google.android.gms:play-services-ads:17.1.2) ต้องใช้ com.google.firebase:firebase-analytics:16.0.6
17.1.1	2018‑11‑12	แก้ไขข้อบกพร่องที่การผสมกันของ play-services-ads และ firebase-analytics บางอย่าง (เช่น ads:17.1.0 และ analytics:16.0.5) ทำให้เกิดข้อผิดพลาดของคอมไพเลอร์ duplicate entry ผู้เผยแพร่โฆษณาที่ใช้ firebase-analytics ร่วมกับเวอร์ชัน 17.1.1 ของคลังโฆษณาใดก็ได้ (เช่น com.google.android.gms:play-services-ads:17.1.1) ต้องใช้ com.google.firebase:firebase-analytics:16.0.5
17.1.0	2018‑11‑02	เพิ่มเมธอด setMaxAdContentRating() และ setTagForUnderAgeOfConsent() ลงใน AdRequest.Builder เพิ่มค่าคงที่ต่อไปนี้เพื่อใช้กับ AdRequest.Builder.setMaxAdContentRating() และ AdRequest.Builder.setTagForUnderAgeOfConsent() MAX_AD_CONTENT_RATING_G MAX_AD_CONTENT_RATING_PG MAX_AD_CONTENT_RATING_T MAX_AD_CONTENT_RATING_MA TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
17.0.0	2018‑10‑05	ผู้เผยแพร่โฆษณา Google Ad Manager ต้องระบุแท็ก <meta-data> ที่มีคีย์ com.google.android.gms.ads.AD_MANAGER_APP ใน AndroidManifest.xml ดูรายละเอียดเพิ่มเติมได้ใน คู่มือการเริ่มต้นใช้งาน โฆษณาเนทีฟ: NativeAppInstallAd, NativeContentAd, และ API ที่เกี่ยวข้องจะเลิกใช้งานเพื่อสนับสนุน UnifiedNativeAd ดูวิธีการเพิ่มเติมเกี่ยวกับการใช้ API ใหม่ได้ที่โฆษณาเนทีฟ ขั้นสูงแบบรวม โฆษณาเนทีฟ: เพิ่มฟีเจอร์ "ซ่อนโฆษณานี้" โฆษณาเนทีฟ: ระบบได้นำบันทึกคำเตือนที่ไม่มีอันตราย "UnconfirmedClickListener ต้อง ไม่เป็น Null ขณะตั้งค่า ClickConfirmingView" ออกแล้ว โฆษณาที่มีการให้รางวัล: เพิ่มเมธอด setAdMetadataListener ใน RewardedVideoAd เพื่อรอรับการเปลี่ยนแปลงข้อมูลเมตาของโฆษณา โฆษณาที่มีการให้รางวัล: การเรียก destroy() จะทำให้ Listener เป็น Null เลิกใช้งานเมธอดต่อไปนี้ใน AdRequest.Builder setGender() setBirthday() setIsDesignedForFamiles() แก้ไขข้อบกพร่องที่ทำให้ onRewardedVideoCompleted() ไม่ทำงานใน โปรแกรมจำลอง
16.0.0	2018‑10‑02	ไม่มีการเปลี่ยนแปลงโฆษณา ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นของบริการ Google Play
15.0.0	2018‑04‑12	เวอร์ชันเบต้าของ MRAID v3 โฆษณาเนทีฟ: เพิ่ม Unified Native Ad API ซึ่งรวม NativeAppInstallAds และ NativeContentAds เข้าด้วยกันเป็น ประเภทใหม่ UnifiedNativeAd หมายเหตุ: เมื่อใช้โฆษณาเนทีฟ จะมีคำเตือนที่ไม่เป็นอันตรายซึ่ง แสดงในบันทึกเมื่อมีการคลิกโฆษณาเนทีฟ "UnconfirmedClickListener ต้องไม่เป็น Null ขณะตั้งค่า ClickConfirmingView" คุณสามารถเพิกเฉยต่อคำเตือนนี้ได้ และเราจะนำคำเตือนนี้ออกในการเปิดตัวครั้งถัดไป
12.0.1	2018‑03‑28	ไม่มีการเปลี่ยนแปลงโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่บันทึกประจำรุ่น ของบริการ Google Play
12.0.0	2018‑03‑20	วิดีโอที่มีการให้รางวัล: เพิ่มonRewardedVideoCompleted() เมธอด Callback ลงใน RewardedVideoAdListener หากต้องการหลีกเลี่ยงข้อผิดพลาดในการคอมไพล์เมื่ออัปเดตเป็นเวอร์ชัน 12.0.0 แอปจะต้อง ลบล้างการเรียกกลับนี้ในการติดตั้งใช้งาน RewardedVideoAdListener สื่อกลางเนทีฟ: เพิ่มเมธอด trackViews() ลงใน NativeAdMapper เพื่อให้ตัวกลางเข้าถึงออบเจ็กต์ View ที่สอดคล้องกับชิ้นงานโฆษณาเนทีฟแต่ละรายการได้ เลิกใช้งาน trackView() แล้วหันมาใช้ trackViews() แทน
11.8.0	2017‑12‑18	แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
11.6.0	2017‑11‑07	เพิ่มคลาส NativeAdViewHolder และเมธอดที่เกี่ยวข้องใน NativeAppInstallAd และ NativeContentAd เลิกใช้งาน AdLoader.getMediationAdapterClassName (ผู้เผยแพร่โฆษณา ควรใช้วิธีการที่มีชื่อเดียวกันใน NativeAppInstallAd และ NativeContentAd แทน) ตอนนี้โฆษณาทดสอบจะแสดงป้ายกำกับที่ด้านบนของโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่ คำแนะนำในการทดสอบ
11.4.0	2017‑09‑19	เพิ่มเมธอด getMediationAdapterClassName() ลงในคลาส NativeAppInstallAd และ NativeContentAd ระบบจะเลิกใช้งาน เมธอดที่มีชื่อเดียวกันใน AdLoader เพิ่มเมธอด onVideoEnd() ลงในคลาส MediationNativeListener เมธอด hasVideoContent(), setHasVideoContent() และ setMediaView() ลงในคลาส NativeAdMapper และเมธอด getAdVolume() และ isAdMuted() ลงในคลาส NativeMediationAdRequest เพื่อรองรับสื่อกลางวิดีโอเนทีฟ นำชั้นเรียน SearchAdRequest ออกแล้ว
11.2.2	2017‑09‑05	เพิ่มเมธอด loadAd() ใหม่ที่รับออบเจ็กต์ PublisherAdRequest ไปยังคลาส RewardedVideoAd
11.2.0	2017‑08‑14	เพิ่มเมธอด loadAds() ลงในคลาส AdLoader ซึ่งช่วยให้แอปโหลดโฆษณาที่ไม่ซ้ำกันหลายรายการในคำขอเดียวได้ เมื่ออัปเกรดแอปเป็น Google Mobile Ads SDK เวอร์ชัน 11.2.0 ขึ้นไป คุณต้องอัปเดต build.gradle ของแอปด้วยเพื่อระบุ compileSdkVersion เป็นอย่างน้อย 26 (Android O) การดำเนินการนี้ จะไม่เปลี่ยนวิธีที่แอปของคุณทำงาน คุณไม่จำเป็นต้องอัปเดต targetSdkVersion ตั้งแต่เวอร์ชัน 11.2.0 เป็นต้นไป Google Mobile Ads SDK (Legacy) จะพร้อมให้บริการผ่านที่เก็บ Maven ของ Google ดูข้อมูลเพิ่มเติมได้ที่หมายเหตุประจำรุ่นของบริการ Google Play
11.0.0	2017‑06‑07	เพิ่มเมธอด onAdClicked() และ onAdImpression() ลงในคลาส AdListener ระบบจะเรียกใช้เมธอดเหล่านี้สำหรับโฆษณาเนทีฟเพื่อการติดตั้งแอปที่มาพร้อมเครื่องและโฆษณาเนทีฟแบบคอนเทนต์เท่านั้น นำเมธอด getInAppPurchaseListener() และ setInAppPurchaseListener() ออกจากคลาส AdView, InterstitialAd และ NativeExpressAdView และนำคลาสการซื้อในแอปที่เกี่ยวข้องออกด้วย เพิ่มเมธอด OnVideoMute() OnVideoPause() OnVideoPlay() และ OnVideoStart() ลงในคลาส VideoController.VideoLifecycleCallbacks เพิ่มความสามารถในการเปิดใช้โหมดใหญ่พิเศษในโฆษณาแบบเต็มหน้าจอโดยการเพิ่มเมธอด setImmersiveMode() ลงในคลาส PublisherInterstitialAd และ RewardedVideoAd เพิ่มอินเทอร์เฟซ OnPublisherAdViewLoadedListener คลาส PublisherAdViewOptions และคลาส PublisherAdViewOptions.Builder เพื่อใช้กับ AdLoader สำหรับคำขอโฆษณาเนทีฟพลัสแบนเนอร์ เพิ่มอินเทอร์เฟซ OnImmersiveModeUpdatedListener ที่ไม่บังคับซึ่งอแดปเตอร์สื่อกลางสามารถใช้เพื่อรับทราบข้อมูลอัปเดตเกี่ยวกับโหมดสมจริง ได้ เพิ่มเมธอด getMediationAdapterClassName() ลงในคลาส RewardedVideoAd เพิ่มkeepกฎเพื่อเก็บชื่อคลาสของอแดปเตอร์สื่อกลางไว้โดยอัตโนมัติเมื่อใช้ ProGuard
10.2.0	2017‑2‑15	บริการ Google Play 10.2.x เป็นรุ่นแรกที่ ไม่รองรับ Android เวอร์ชัน 2.3.x (Gingerbread) อย่างเต็มรูปแบบอีกต่อไป แอปที่พัฒนาโดยใช้ SDK รุ่น 10.2.x ขึ้นไปกำหนดให้มี ระดับ API ขั้นต่ำของ Android เป็น 14 และติดตั้งในอุปกรณ์ที่ใช้ ระดับ API ต่ำกว่า 14 ไม่ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกของคุณ รวมถึงการสร้าง APK หลายรายการเพื่อขยายการรองรับ Android Gingerbread ในแอปได้ที่ บล็อกของนักพัฒนาแอป Android เพิ่มการรองรับชิ้นงานวิดีโอสำหรับเนื้อหาเนทีฟขั้นสูง และโฆษณาเทมเพลตที่กำหนดเอง เพิ่มเมธอด getVideoController(), setVideoOptions() และ getVideoOptions() ลงในคลาส PublisherAdView เพิ่มคลาส AdChoicesView แล้ว เพิ่มเมธอด getAdChoicesContent() และ setAdChoicesContent() ลงในคลาส NativeAdMapper เพิ่มInitializableMediationRewardedVideoAdAdapter อินเทอร์เฟซสําหรับอะแดปเตอร์สื่อกลางวิดีโอที่มีการให้รางวัลที่ต้องการ เลือกใช้การเริ่มต้นก่อนเวลาอันควรก่อนที่จะส่งคําขอโฆษณา เพิ่มการรองรับการแสดงตัวอย่างในแอปและการแก้ปัญหาใน Google Ad Manager
10.0.1	2016‑11‑21	แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
9.8.0	2016‑10‑24	MobileAds.Initialize(Context) เลิกเลิกใช้งานแล้ว ผู้เผยแพร่โฆษณา Google Ad Manager ควรเรียกใช้เมธอดนี้เมื่อเริ่มต้น แอป ผู้เผยแพร่โฆษณา AdMob ยังคงต้องใช้ MobileAds.Initialize(Context, String) และส่ง โค้ดของแอปพลิเคชัน
9.6.0	2016‑09‑22	เพิ่มคลาส MediaView สำหรับโฆษณาวิดีโอขั้นสูงของโฆษณาเนทีฟ เพิ่มเมธอด openDebugMenu() ลงในคลาส MobileAds เพื่อแสดงตัวอย่างครีเอทีฟโฆษณาและ แก้ปัญหาหน่วยโฆษณา Ad Manager เพิ่มการรองรับเหตุการณ์ที่กำหนดเองของวิดีโอที่มีการให้รางวัล
9.4.0	2016‑08‑01	แก้ไขข้อบกพร่องและปรับปรุงทั่วไป
9.2.0	2016‑06‑27	เพิ่มเมธอด setAdChoicesPlacement() ลงในคลาส NativeAdOptions.Builder ซึ่งตอนนี้ผู้เผยแพร่แอปสามารถใช้เพื่อระบุตำแหน่ง ของ AdChoices ในโฆษณาเนทีฟได้แล้ว การเล่นโฆษณาวิดีโอได้รับการปรับปรุงด้วยการแก้ไขข้อบกพร่องหลายอย่าง
9.0.1	2016‑05‑26	แก้ไขปัญหา ProGuard ที่เกิดขึ้นในเวอร์ชัน 9.0.0 ผู้เผยแพร่โฆษณาไม่จำเป็นต้องมีตัวเลือก keep สำหรับ com.google.android.gms.common.util.DynamiteApi อีกต่อไป
9.0.0	2016‑05‑18	เพิ่มการป้อนข้อมูลตำแหน่งอัตโนมัติ สำหรับแอปที่ให้สิทธิ์เข้าถึงตำแหน่งอย่างชัดเจน เพิ่มการรองรับเหตุการณ์ที่กำหนดเองของสื่อกลางวิดีโอที่มีการให้รางวัล เพิ่มตัวเลือกวิดีโอสำหรับโฆษณา Native Express อัปเดต Custom Search Ads API เพิ่มวิธีการ setAppMuted() แล้ว เลิกใช้เมธอด MobileAds.initialize(android.content.Context, java.lang.String) แล้ว ตอนนี้เราเลิกใช้งานเมธอด MobileAds.initialize(android.content.Context) แล้ว เพิ่มเมธอด MediationNativeListener.onAdImpression() สําหรับการรายงานการแสดงผลในอแดปเตอร์สื่อกลาง สำหรับการเผยแพร่นี้เท่านั้น แอปที่ใช้ ProGuard เพื่อประมวลผลแอปพลิเคชันภายหลัง ต้องเพิ่มตัวเลือก keep ต่อไปนี้ลงในไฟล์กำหนดค่า ProGuard -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0	2015‑12‑18	เพิ่มเมธอดสาธารณะ MobileAds.setAppVolume() เพื่อแจ้งให้ Google Mobile Ads SDK (Legacy) ทราบระดับเสียงปัจจุบันของแอป แก้ไขข้อบกพร่องและปรับปรุงด้านต่างๆ
8.3.0	2015‑11‑6	เพิ่มการรองรับโฆษณาวิดีโอที่มีการให้รางวัล เพิ่มเมธอด isLoading() ไปยัง PublisherAdView และ PublisherInterstitialAd เพื่อตรวจสอบว่าคำขอโฆษณากำลัง ดำเนินการอยู่หรือไม่ เพิ่มวิธีการ setIsDesignedForFamilies() ไปยัง AdRequest.Builder และ PublisherAdRequest.Builder เพิ่มวิธีการ destroy() ไปยัง NativeAdView แล้ว
8.1.0	2015‑09‑24	แก้ไขข้อบกพร่องหลายรายการ
7.8.0	2015‑08‑13	MRAID v2 เวอร์ชันที่เผยแพร่ เพิ่มเมธอด isLoading() ไปยัง AdLoader AdView และ InterstitialAd เพื่อตรวจสอบว่าคำขอโฆษณากำลังดำเนินการอยู่หรือไม่ เลิกใช้งาน PublisherAdRequest.Builder#setManualImpressionsEnabled() แล้ว โปรดใช้ PublisherAdView#setManualImpressionsEnabled() แทน
7.5.0	2015‑05‑28	เพิ่มการรองรับรูปแบบโฆษณาเนทีฟเพื่อการติดตั้งแอปและโฆษณาเนทีฟแบบคอนเทนต์ใน AdMob และ Ad Manager เพิ่มการรองรับรูปแบบโฆษณาเนทีฟที่กำหนดเอง ซึ่งพร้อมใช้งานสำหรับการจองใน Ad Manager
7.3.0	2015‑04‑28	แก้ไขข้อบกพร่องหลายรายการ
7.0.0	2015‑03‑19	เพิ่มวิธีการ addCustomTargeting() และ addCategoryExclusion() ลงใน PublisherAdRequest.Builder แก้ไขปัญหาที่ทำให้ PublisherAdView.recordManualImpression() บันทึกการแสดงผลหลายรายการใน Ad Manager เมื่อใช้การนับการแสดงผลด้วยตนเอง แก้ไขปัญหาที่ทำให้โฆษณาแสดงผลไม่ถูกต้องเมื่อใช้แอตทริบิวต์ android:largestWidthLimitDp ในแท็ก <supports-screens> เพิ่มวิธีการ setRequestAgent() ลงใน AdRequest.Builder และ PublisherAdRequest.Builder ควรใช้วิธีนี้เพื่อระบุแหล่งที่มาของคำขอโฆษณาโดยบุคคลที่สามที่ทำหน้าที่เป็นสื่อกลางให้กับ Google Mobile Ads SDK (Legacy)
6.5.87	2014‑12‑08	เปิดตัวสถาปัตยกรรม JAR แบบแยกส่วน - ตอนนี้นักพัฒนา Android Studio สามารถรวมเฉพาะส่วนโฆษณาของบริการ Google Play ได้โดยขึ้นอยู่กับ com.google.android.gms:play‑services‑ads:6.+ หมายเหตุ: แอปที่สร้างโฆษณาแบนเนอร์ใน XML ยังคงต้องอ้างอิง ไลบรารีทั้งหมดcom.google.android.gms:play‑services:6.+ แก้ไขข้อบกพร่องหลายรายการ
6.1	2014‑10‑08	เพิ่มวิธีการ getLocation() ไปยัง com.google.android.gms.ads.MediationAdRequest แล้ว เพิ่มคำอธิบายเนื้อหาลงในปุ่มปิดโฆษณาคั่นระหว่างหน้าเพื่อความสามารถเข้าถึงได้ง่าย นำการบันทึก "ไม่พบทรัพยากร Google Play" ออกเมื่อลิงก์โปรเจ็กต์ไลบรารี อย่างถูกต้อง เพิ่ม getMediationAdapterClassName() ใน AdView เพื่อรับชื่อคลาสของอแดปเตอร์สื่อกลางเครือข่ายโฆษณาที่แสดงโฆษณา
17.0.0	2018‑10‑05	เพิ่ม API ใหม่เพื่อใช้เหตุการณ์ที่กําหนดเอง เพิ่มขั้นตอนการซื้อเริ่มต้นสำหรับการซื้อในแอปโดยใช้ Google Play Billing API
4.4	2014‑05‑07	เพิ่ม API ของสื่อกลางใหม่ เพิ่มLARGE_BANNERรูปแบบโฆษณาใหม่ขนาด 320x100 สำหรับทั้งโทรศัพท์ และแท็บเล็ต เพิ่มรูปแบบโฆษณาคั่นระหว่างหน้าใหม่สำหรับการซื้อในแอป ตั้งค่า InAppPurchaseListener ใน InterstitialAd เพื่อรอ เหตุการณ์การซื้อในแอป แก้ไขข้อบกพร่องสำหรับข้อขัดข้องของ SecurityException เนื่องจากการอ่าน gservices โดยไม่ได้รับอนุญาต
4.3	2014‑03‑17	ตอนนี้ InterstitialAd จะทำงานได้หากส่งบริบทของแอปพลิเคชัน เพิ่มวิธีการ setContentUrl() ลงใน PublisherAdRequest.Builder แก้ไขข้อยกเว้นเมื่อไม่ได้ลงทะเบียนบริการ
4.2	2014‑02‑03	แก้ไขข้อบกพร่องหลายรายการ
4.1	2014‑01‑16	เพิ่มการรองรับ Ad Manager และโฆษณา Search สำหรับแอปบนอุปกรณ์เคลื่อนที่ ตอนนี้ AdRequest.Builder มีวิธีการsetLocation()แล้ว แก้ไขข้อขัดข้องที่เกิดขึ้นหากมีการขอโฆษณาคั่นระหว่างหน้า แต่ AdActivityไม่ได้ระบุในไฟล์ Manifest
4.0	2013‑10‑31	ตอนนี้ Google Mobile Ads API เป็นส่วนหนึ่งของบริการ Google Play แล้ว ระบบจะพุชการอัปเดต API โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ในอนาคตไปยังอุปกรณ์โดยอัตโนมัติผ่านบริการ Google Play ยังไม่รองรับ Ad Manager และโฆษณา Search สำหรับแอปบนอุปกรณ์เคลื่อนที่