Ghi chú phát hành

Phiên bản	Ngày phát hành	Ghi chú
1.6.0	2026-10-22	Cập nhật trang chia sẻ của công cụ kiểm tra quảng cáo khi xuất yêu cầu quảng cáo và phản hồi quảng cáo để cung cấp bản xem trước văn bản, nút sao chép và đề xuất chia sẻ trực tiếp. Khắc phục lỗi trong quảng cáo có tặng thưởng và quảng cáo xen kẽ có tặng thưởng, trong đó phương thức OnUserEarnedRewardListener.onUserEarnedReward() có thể được gọi sau phương thức AdEventCallback.onAdDismissedFullScreenContent(). Cập nhật phần phụ thuộc com.google.android.play:hsdp lên phiên bản 2.2.0 để khắc phục sự cố java.lang.IllegalStateException. Cập nhật các quy tắc ProGuard của người dùng để ngăn chặn sự cố java.lang.RuntimeException trong lớp androidx.work.WorkManagerInitializer khi bật chế độ đầy đủ R8. Khắc phục lỗi không chuyển được bối cảnh Activity có sẵn đến SDK của bên thứ ba khi hiển thị quảng cáo toàn màn hình được dàn xếp.
1.5.0	2026-09-24	Thêm API tạo và kết xuất tín hiệu cho định dạng SwipeableInterstitialAd. Tính năng này đang trong giai đoạn thử nghiệm không công khai. Hãy liên hệ với người quản lý tài khoản của bạn để yêu cầu quyền truy cập. Thêm API excludedAppIds vào yêu cầu quảng cáo biểu tượng, cho phép nhà xuất bản tuỳ ý loại trừ danh sách mã ứng dụng khỏi phản hồi quảng cáo biểu tượng.
1.4.0	2026-08-20	Thêm tính năng hỗ trợ cho định dạng PictureInPictureAd. Quảng cáo trong chế độ hình trong hình đang trong giai đoạn thử nghiệm beta công khai. Thêm onInitializationFailed(AdError) và ngừng sử dụng onInitializationFailed(String) trong InitializationCompleteCallback. Giờ đây, bộ chuyển đổi dàn xếp có thể báo cáo lỗi khởi chạy SDK của bên thứ ba cho SDK kèm theo mã lỗi, miền lỗi và thông báo lỗi.
1.3.1	2026-07-29	Bản sửa lỗi và cải thiện hiệu suất cho một tính năng có quyền truy cập bị hạn chế.
1.3.0	2026-07-21	Thay đổi AdView.loadAd() để tạm dừng thử lại tự động cho các yêu cầu quảng cáo không thành công khi tính năng tự động làm mới bị tắt cho đơn vị quảng cáo. Khi một yêu cầu quảng cáo cho nhiều quảng cáo gốc hoặc quảng cáo biểu tượng không mang lại quảng cáo nào, SDK hiện sẽ trả về lỗi NO_FILL thay vì INTERNAL_ERROR. Thêm cờ tệp kê khai để tắt công cụ kiểm tra quảng cáo. Thêm phương thức Ad.getAdUnitId() để xác định mã đơn vị quảng cáo dùng để yêu cầu quảng cáo. Thêm phương thức InitializationConfig.Builder.disableSdkCrashReporting(), cung cấp lựa chọn không tham gia theo cách thủ công cho trình xử lý sự cố mặc định trong GMA Next-Gen SDK. Theo mặc định, SDK vẫn uỷ quyền xử lý sự cố cho các trình xử lý đã đăng ký khác (chẳng hạn như Crashlytics). Khi sử dụng tính năng dàn xếp với nguồn quảng cáo sự kiện tuỳ chỉnh, ResponseInfo.getAdapterClassName() hiện sẽ trả về tên lớp sự kiện tuỳ chỉnh thay vì com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1	2026-06-15	Đối với các ứng dụng sử dụng API WebView cho quảng cáo, chúng tôi đã khắc phục một vấn đề khiến SDK không thể cung cấp tín hiệu cho các thẻ quảng cáo được hỗ trợ (mã AdSense, Thẻ nhà xuất bản của Google, IMA cho HTML5). Vấn đề này là do các phương thức Webkit được gọi không chính xác trên một luồng trong nền.
1.2.0	2026-06-11	Khắc phục lỗi gây ra java.lang.NullPointerException trong androidx.webkit.internal.PrefetchOperationCallbackAdapter. Thêm định dạng SwipeableInterstitialAd. Tính năng này đang trong giai đoạn thử nghiệm không công khai. Hãy liên hệ với người quản lý tài khoản của bạn để yêu cầu quyền truy cập. Đối với các ứng dụng yêu cầu nhiều quảng cáo biểu tượng, đã thêm IconAd.load(IconAdRequest, int, IconAdLoadCallback) và ngừng sử dụng IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>). IconAdLoadCallback bao gồm một phương thức onAdLoadingCompleted() để báo hiệu khi tất cả quá trình tải quảng cáo kết thúc. Bộ chuyển đổi dàn xếp: Thêm phương thức RequestConfiguration.getAgeRestrictedTreatment() để cho phép bộ chuyển đổi đọc chế độ cài đặt xử lý theo độ tuổi. Thay đổi untrackView() để chấp nhận View thay vì View? nhằm duy trì khả năng tương thích với các bộ chuyển đổi được xây dựng dựa trên Google Mobile Ads SDK (Legacy).
1.1.1	2026-05-27	Khắc phục vấn đề khiến nhóm quảng cáo có tặng thưởng có thể bị treo trong quá trình chuyển đổi, khiến người dùng không thể đóng quảng cáo.
1.1.0	2026-05-18	Thêm RequestConfiguration.Builder.setAgeRestrictedTreatment() và ngừng sử dụng các phương thức sau: RequestConfiguration.Builder.setTagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForUnderAgeOfConsent() Thêm destroyAll() và peekAdResponseInfo() vào các lớp trình tải trước quảng cáo. Thêm các phương thức load() vào IconAd để hỗ trợ tải nhiều quảng cáo biểu tượng.
1.0.1	2026-04-30	Khắc phục vấn đề quảng cáo sử dụng window.open() hoặc đường liên kết có target="_blank" không mở được trang đích.
1.0.0	2026-04-14	Thay đổi có thể gây lỗi: Đã xóa phương thức AdPreloader.numAdsAvailable() không dùng nữa. Thay vào đó, hãy sử dụng AdPreloader.getNumAdsAvailable(). Cập nhật org.chromium.net:cronet-api lên phiên bản 143.7445.0 để ngăn chặn lỗi vi phạm không gian tên duy nhất. Khắc phục lỗi khiến MediaContent.currentTime và NativeAdMapper.getCurrentTime() luôn trả về 0.
0.25.0-beta01	2026-03-24	Khắc phục vấn đề trong đó Ad.getResponseInfo() không trả về siêu dữ liệu ResponseInfo đã cập nhật khi quảng cáo biểu ngữ được làm mới.
0.24.0-beta03	2026-03-07	Khắc phục vấn đề trong đó AdView.destroy() không dừng được các lần thử tải lại quảng cáo sau khi không tải được quảng cáo. Thêm hàm dựng không có đối số vào NativeAdMapper và UnifiedNativeAdMapper để cải thiện khả năng tương thích với Kotlin. Thêm thuộc tính packageName vào giao diện IconAd. Thêm một tuỳ chọn để buộc SDK sử dụng Cronet thay vì OkHttp cho các hoạt động mạng. Để giải quyết lỗi thời gian chạy trong các dự án sử dụng OkHttp 5, bạn nên buộc Cronet thực hiện các thao tác mạng. Để buộc Cronet, hãy đặt force_use_cronet thành true trong InitializationConfig.Builder khi gọi MobileAds.initialize(): val config = InitializationConfig.Builder() .setExtras(bundleOf("force_use_cronet" to true)) .build() MobileAds.initialize(this, config) Thêm tính năng hỗ trợ cho Java 11. Để sử dụng Java 11, hãy thêm mã sau vào khối android trong tệp build.gradle: android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } }
0.24.0-beta02	2026-03-03	Đã giải quyết vấn đề tải lớp phần phụ thuộc của bên thứ ba, ảnh hưởng đến việc tạo tín hiệu yêu cầu quảng cáo từ máy chủ đến máy chủ.
0.24.0-beta01	2026-02-13	Thêm tính năng hỗ trợ biểu ngữ neo thích ứng cỡ lớn. Biểu ngữ thích ứng cố định cỡ lớn được thiết kế để tăng mức độ tương tác và doanh thu. Yêu cầu biểu ngữ neo thích ứng cỡ lớn bằng cách sử dụng các phương thức sau trong lớp AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() Các phương thức sau trong lớp AdSize không còn được dùng nữa: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() Khắc phục lỗi khiến quảng cáo biểu ngữ có thể ngừng làm mới nếu nền tảng gọi onViewAttachedToWindow() và onViewDetachedFromWindow() không theo thứ tự khi một quảng cáo mới xuất hiện.
0.23.0-beta01	2026-01-26	Cập nhật phiên bản tối thiểu bắt buộc của Trình bổ trợ Android cho Gradle (AGP) lên 8.3.0. Khắc phục lỗi hàm khởi tạo AdView gửi một java.lang.NoSuchMethodError khi được gọi từ Kotlin. Khắc phục lỗi không gọi được bộ chuyển đổi sự kiện tuỳ chỉnh trong quá trình thực thi thác nước. Cập nhật RtbSignalData để cung cấp Ngữ cảnh hoạt động cho RtbAdapter.collectSignals() khi có. Cập nhật phần phụ thuộc androidx.webkit lên phiên bản 1.15.0. Cập nhật phần phụ thuộc SDK Nền tảng thông báo cho người dùng lên phiên bản 4.0.0. Huỷ bỏ việc ngừng sử dụng AdPreloader.getConfiguration() và AdPreloader.getConfigurations().
0.22.0-beta04	2025-12-04	Khắc phục vấn đề trong SDK phiên bản 0.22.0-beta02, trong đó siêu dữ liệu xem trước của Java 17 được đưa vào các tệp lớp không chính xác.
0.22.0-beta03	2025-11-25	Khắc phục lỗi trong đó các yêu cầu quảng cáo từ máy chủ đến máy chủ sử dụng NativeSignalRequest.Builder.setAdSize() không đặt đúng kích thước quảng cáo được yêu cầu.
0.22.0-beta02	2025-11-24	Đã giải quyết lỗi tải Ad Manager, trong đó các yêu cầu quảng cáo từ máy chủ đến máy chủ sử dụng NativeSignalRequest không hiển thị được nếu phản hồi quảng cáo thuộc loại NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	Cập nhật API quảng cáo biểu ngữ: Thêm lớp AdView. Ngừng sử dụng BannerAd.load() và BannerAd.loadFromAdResponse(). Để tải một quảng cáo biểu ngữ, hãy sử dụng AdView.loadAd() và AdView.loadFromAdResponse(). Ngừng sử dụng BannerAd.getView(). Để kết xuất BannerAd được tải bằng BannerAdPreloader, hãy tạo một thực thể AdView rồi sử dụng AdView.registerBannerAd(). Khắc phục lỗi trong quảng cáo dàn xếp, trong đó NativeAdRequest.Builder.setAdChoicesPlacement() không được tuân thủ, khiến vị trí biểu tượng Lựa chọn quảng cáo không chính xác. Hạ phiên bản tối thiểu bắt buộc của Trình bổ trợ Android cho Gradle (AGP) từ 8.2.0 xuống 7.3.1. Ngừng sử dụng AdPreloader.getConfigurations() và AdPreloader.getConfiguration(preloadId). Không có thay thế.
0.21.0-beta01	2025-10-08	Thêm phương thức InitializationConfig.Builder.disableMediationAdapterInitialization(). Hãy gọi phương thức này trước khi khởi chạy GMA Next-Gen SDK để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp. Cải thiện cách sử dụng khởi chạy WebView để giảm lỗi ANR. Hạ cấp phần phụ thuộc androidx.webkit từ 1.13.0 xuống 1.12.1. Đã xóa quyền android.permission.RECEIVE_BOOT_COMPLETED mà gói androidx.work sử dụng. Sửa một trường bị đặt tên sai trong lớp NativeAdMapper.
0.20.0-beta01	2025-09-19	Khắc phục lỗi khiến một số quảng cáo gốc dạng video không tự động phát.
0.19.0-beta01	2025-08-14	Hạ cấp phiên bản của hai phần phụ thuộc. androidx.work:work-runtime từ 2.10.0 xuống 2.7.0. androidx.core:core and androidx.core:core-ktx từ 1.15.0 xuống 1.12.0. Đổi tên thuộc tính loadedAdSourceResponse trên ResponseInfo thành loadedAdSourceResponseInfo. Sửa lỗi cho phép người dùng đóng sớm một số quảng cáo toàn màn hình bằng nút quay lại. Những nhà xuất bản có quyền sử dụng tính năng này hiện có thể dùng mã vị trí cho tất cả định dạng quảng cáo. Thêm lệnh gọi lại destroy() vào NativeAdMapper cho bộ chuyển đổi dàn xếp gốc.
0.18.0-beta01	2025-07-17	Khắc phục lỗi dàn xếp gốc làm hỏng hoạt động phân phát quảng cáo cho các bộ chuyển đổi tham chiếu đến com.google.android.gms.ads.NativeAd.MediaView. Chú thích MobileAds.registerCustomTabsSession() bằng @JvmStatic. Khắc phục lỗi khiến Quảng cáo biểu ngữ được tải bằng Thác nước mạng AdMob ngừng tải quảng cáo.
0.17.0-alpha02	2025-06-23	Khắc phục lỗi đặt giá thầu dàn xếp gốc, trong đó các bộ chuyển đổi triển khai tính năng đặt giá thầu nhưng không triển khai quy trình dàn xếp kiểu thác nước (ví dụ: Meta Audience Network) sẽ luôn không hiển thị được quảng cáo gốc. Khắc phục sự cố xảy ra khi một bộ chuyển đổi dàn xếp gọi nhiều phương thức MediationAdLoadCallback cho một yêu cầu quảng cáo.
0.17.0-alpha01	2025-06-18	Phiên bản 0.17.0-alpha01 là bản phát hành ngoài ý muốn, không chứa các tính năng mới như dự kiến. Hãy sử dụng phiên bản 0.17.0-alpha02.
0.16.0-alpha01	2025-05-23	Bạn không cần phải bật tính năng hỗ trợ đơn giản hoá API Java 8 trở lên nữa. Cập nhật phần phụ thuộc SDK Nền tảng thông báo cho người dùng lên phiên bản 3.2.0. Khắc phục lỗi dàn xếp quảng cáo gốc gây ra sự cố trong các bộ chuyển đổi tham chiếu đến lớp com.google.android.gms.ads.formats.MediaView. Tải trước quảng cáo: Thêm getNumAdsAvailable() và ngừng sử dụng numAdsAvailable(). Đã xóa thẻ thuộc tính android.adservices.AD_SERVICES_CONFIG khỏi tệp kê khai của SDK để ngăn chặn xung đột hợp nhất cho các ứng dụng Định cấu hình Dịch vụ quảng cáo theo API cụ thể.
0.15.1-alpha01	2025-04-28	Giờ đây, bạn bắt buộc phải bật tính năng hỗ trợ đơn giản hoá API Java 8 trở lên. Đối với các ứng dụng được phát triển bằng Kotlin, phiên bản Kotlin tối thiểu bắt buộc đã giảm từ 2.1 xuống 1.9.
0.15.0-alpha01	2025-04-24	Quảng cáo gốc: Thêm tính năng hỗ trợ tải nhiều quảng cáo gốc. Thêm phương thức NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) yêu cầu nhiều quảng cáo cùng một lúc. Thêm lệnh gọi lại NativeAdLoaderCallback.onAdLoadingCompleted() kích hoạt khi tất cả quảng cáo gốc tải xong. Để hỗ trợ tính năng tải không đồng bộ của Kotlin, chúng tôi đã thêm một phương thức NativeAdLoader.load(NativeAdRequest, numberOfAds) trả về Flow<NativeAdLoadResult>. Cập nhật phần phụ thuộc kotlinx-coroutines-android từ phiên bản 1.7.3 lên 1.9.0.
0.14.0-alpha01	2025-03-20	Yêu cầu quảng cáo sẽ không thành công nếu bạn khởi chạy SDK bằng một mã ứng dụng không hợp lệ. Phương thức AdPreloader.start() không còn yêu cầu lệnh gọi lại PreloadCallback nữa. Thuộc tính bufferSize là không bắt buộc khi tạo một đối tượng thông qua lớp dữ liệu PreloadConfiguration. Để cho phép Google tối ưu hoá dung lượng bộ nhớ đệm, đừng đặt thuộc tính bufferSize. Đã xóa thuộc tính maxAdsPerSession trong lớp dữ liệu PreloadConfiguration. Thêm các thuộc tính shouldRequestMultipleImages và shouldReturnUrlsForImageAssets vào lớp NativeAdOptions.
0.13.0-alpha01	2025-02-26	Thêm MediationRewardedAdCallback.onUserEarnedReward() và ngừng sử dụng MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Thêm API tải trước quảng cáo.
0.12.0-alpha01	2025-01-22	Khắc phục lỗi trong đó một số phương thức bên trong AdRequest, AdRequest.Builder, SignalRequest và SignalRequest.Builder bị làm rối mã nguồn. Đối với người dùng API WebView cho quảng cáo không có mã ứng dụng Ad Manager, chúng tôi đã thêm InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID có thể được truyền trong quá trình khởi chạy SDK. Bổ sung tính năng hỗ trợ kết hợp quảng cáo gốc và quảng cáo biểu ngữ trong yêu cầu quảng cáo của Ad Manager.
0.11.0-alpha01	2024-12-12	Cập nhật phần phụ thuộc trên SDK Nền tảng thông báo cho người dùng lên phiên bản 3.1.0. Thêm tính năng hỗ trợ cho các cử chỉ nhấp tuỳ chỉnh trong quảng cáo gốc. Thêm tính năng hỗ trợ tính số lần hiển thị thủ công cho quảng cáo biểu ngữ trong yêu cầu đặt trước của Ad Manager.
0.10.0-alpha01	2024-11-08	Thêm các hàm DSL cho VideoOptions và RequestConfiguration để hỗ trợ Kotlin tốt hơn. Thêm tính năng hỗ trợ cho Publisher Privacy Treatment API bằng RequestConfiguration.setPublisherPrivacyPersonalizationState(). Thêm API tạm ngưng Kotlin để tải quảng cáo và tạo tín hiệu. Xoá IconAd.LoadAdResult và thay thế bằng AdLoadResult. Khắc phục vấn đề khiến phiên OMID không bắt đầu cho quảng cáo dạng video gốc.
0.9.0-alpha01	2024-10-02	Xoá phần phụ thuộc trên Các API Java 8 trở lên hiện có thông qua quá trình đơn giản hoá khỏi bản phát hành 0.6.0-alpha01. Các ứng dụng sử dụng minSdkVersion thấp hơn 26 không cần bật tính năng hỗ trợ đơn giản hoá API Java 8 trở lên nữa. Thêm tính năng hỗ trợ cho công cụ kiểm tra quảng cáo. Thêm tính năng hỗ trợ video cho định dạng quảng cáo gốc tuỳ chỉnh. Bản phát hành chính thức cho các API thu thập và hiển thị tín hiệu.
0.8.0-alpha01	2024-08-22	Cập nhật phần phụ thuộc trên SDK Nền tảng thông báo cho người dùng lên phiên bản 3.0.0. Quảng cáo gốc: Phiên bản phát hành chính thức cho định dạng quảng cáo gốc. Thêm tính năng hỗ trợ phân phát video trong thành phần MediaContent. Đã thêm phương thức gọi lại trong vòng đời của video. Thêm các chế độ điều khiển tuỳ chỉnh cho việc phát video. Bật tính năng Đo lường mở cho quảng cáo gốc và quảng cáo gốc tuỳ chỉnh. signalType hiện là trường bắt buộc khi tạo SignalRequest.
0.6.0-alpha01	20/06/2024	Thêm mã sử dụng API Java 8 trở lên hiện có thông qua quá trình đơn giản hoá. Những ứng dụng sử dụng minSdkVersion thấp hơn 26 phải bật hỗ trợ đơn giản hoá API Java 8 trở lên. Bổ sung tính năng hỗ trợ cho các định dạng quảng cáo gốc và quảng cáo gốc tuỳ chỉnh không có thành phần video. Thêm tính năng hỗ trợ cho MRAID phiên bản 3. Thêm phần phụ thuộc vào User Messaging Platform SDK phiên bản 2.2.0. Cập nhật miền lỗi cho các lỗi của Google từ com.google.android.gms.ads thành com.google.android.libraries.ads.mobile.sdk. Thêm phương thức MobileAds.isInitialized() để kiểm tra xem SDK đã được khởi chạy hay chưa. Thêm BannerAd.isCollapsible() để kiểm tra xem quảng cáo biểu ngữ được trả về có thể thu gọn hay không. Thêm MobileAds.registerCustomTabsSession() để cải thiện khả năng kiếm tiền cho quảng cáo trong Thẻ tuỳ chỉnh. Đổi tên OnInitializationCompleteListener thành OnAdapterInitializationCompleteListener. Đổi tên AdapterResponseInfo thành AdSourceResponseInfo. Đổi tên AdRequest.Builder.putAdNetworkExtrasBundle() thành AdRequest.Builder.putAdSourceExtrasBundle(). Khắc phục lỗi khiến các lớp bộ chuyển đổi đặt giá thầu không được tạo thực thể đúng cách.
0.3.0-alpha01	20/03/2024	Bản phát hành đầu tiên của GMA Next-Gen SDK. Hỗ trợ quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng, quảng cáo xen kẽ có tặng thưởng và quảng cáo khi mở ứng dụng. Hỗ trợ tính năng dàn xếp cho tất cả định dạng quảng cáo. Bộ chuyển đổi được viết cho SDK quảng cáo trên thiết bị di động hiện tại có khả năng tương thích chuyển tiếp với GMA Next-Gen SDK. Thêm phần phụ thuộc vào SDK Đo lường mở phiên bản 1.4.10.