Ghi chú phát hành

Phiên bản Ngày phát hành Ghi chú
25.5.0 17/9/2026
  • Tăng cấp độ API Android tối thiểu lên 24.
  • Thêm onInitializationFailed() vào InitializationCompleteCallback Giờ đây, bộ chuyển đổi dàn xếp sẽ báo cáo lỗi khởi chạy SDK của bên thứ ba cho Google Mobile Ads SDK kèm theo mã lỗi, miền lỗi và thông báo lỗi.
  • Khi sử dụng tính năng dàn xếp với các 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.
25.4.0 2026‑06‑17
  • Bản sửa lỗi và cải tiến hiệu suất.
25.3.0 21/5/2026
  • Thêm phương thức setAgeRestrictedTreatment() vào RequestConfiguration.Builder và ngừng sử dụng setTagForChildDirectedTreatment() và setTagForUnderAgeOfConsent(). Hãy sử dụng phương thức mới để định cấu hình chế độ xử lý bị hạn chế theo độ tuổi cho người dùng là trẻ em và thanh thiếu niên.
25.2.0 2026‑04‑13
  • Bản sửa lỗi và cải tiến hiệu suất.
25.1.0 2026‑03‑16
25.0.0 17/2/2026
24.9.0 2025‑12‑11
  • Bản sửa lỗi và cải tiến hiệu suất.
24.8.0 20/11/2025
  • Khắc phục lỗi thiếu bản dịch cho tài nguyên SDK trong phiên bản 24.6.0 và 24.7.0.
  • Ngừng sử dụng NativeAdViewHolder. Thay vào đó, hãy sử dụng NativeAdView để hiển thị quảng cáo gốc.
  • Ngừng sử dụng các phương thức AdPreloader.getConfigurations() và AdPreloader.getConfiguration(preloadId). Không có phương thức thay thế cho các phương thức này.
24.7.0 2025‑10‑09
  • Sửa chú thích rỗng bị thiếu trên kiểu dữ liệu trả về cho NativeCustomFormatAd.getDisplayOpenMeasurement(). Chức năng không thay đổi vì khả năng trả về giá trị rỗng của phương thức đã được dự kiến.
  • Hạ cấp phần phụ thuộc androidx.webkit:webkit từ 1.14.0 xuống 1.12.1 để duy trì khả năng tương thích với trình bổ trợ Android cho Gradle 7.3.1.
24.6.0 2025‑09‑08
  • Giờ đây, bộ chuyển đổi dàn xếp gốc có thể triển khai NativeAdMapper.destroy() để nhận thông báo khi quảng cáo gốc bị huỷ.
24.5.0 24/7/2025
  • 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.
  • Khắc phục sự cố kèm theo thông báo lỗi Fatal Exception: java.util.ConcurrentModificationException.
24.4.0 2025‑06‑09
  • Thêm một số API mới để tải trước quảng cáo và ngừng sử dụng các API hiện có. Tính năng tải trước quảng cáo vẫn là một tính năng ở giai đoạn alpha có giới hạn.
24.3.0 19/5/2025
  • Cập nhật phần phụ thuộc của SDK Nền tảng thông báo cho người dùng lên phiên bản 3.2.0.
24.2.0 2025‑04‑07
  • Bản sửa lỗi và cải tiến hiệu suất.
24.1.0 2025‑03‑12
  • Phiên bản Kotlin tối thiểu hiện là 2.1.0.
  • Bản sửa lỗi và cải tiến hiệu suất.
  • play-services-ads-lite đang chuyển sang tần suất phát hành thấp hơn và không được phân phối cùng bản phát hành này. Để biết thêm thông tin, hãy xem tài liệu về SDK Lite.
24.0.0 24/2/2025
  • Thay đổi có thể gây lỗi:
    • Tăng cấp độ API Android tối thiểu lên 23.
    • Đã xóa tất cả API liên quan đến định dạng quảng cáo kiểu cuộn xen kẽ.
    • Đã xóa các API hướng AppOpenAd không dùng nữa.
    • Đã xóa các lớp SearchAdView và DynamicHeightSearchAdRequest.
  • 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.1.0.
  • Tính năng Tối ưu hoá hoạt động khởi chạy và tải quảng cáo hiện đã được phát hành rộng rãi và được bật theo mặc định.
  • Thêm MediationRewardedAdCallback.onUserEarnedReward() và ngừng sử dụng MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Bộ chuyển đổi dàn xếp nên cập nhật để sử dụng phương thức mới.
  • Đã 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ể.
23.6.0 2024‑12‑03
  • Ngừng sử dụng tất cả API liên quan đến định dạng quảng cáo xen kẽ khi cuộn. Ví dụ: AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0 2024‑10‑29
  • Cập nhật thông báo logcat về lỗi tải quảng cáo được giới thiệu trong bản phát hành 23.4.0 từ cấp độ lỗi lên cấp độ thông tin.
  • Cải thiện khả năng kiếm tiền từ quảng cáo được cá nhân hoá trong Thẻ tuỳ chỉnh cho API WebView cho quảng cáo.
23.4.0 30/9/2024
  • Giờ đây, lỗi tải quảng cáo sẽ gọi một thông báo logcat có nội dung ad failed to load trong dấu vết ngăn xếp của lỗi. Dấu vết ngăn xếp ghi lại thông báo này dưới dạng lỗi, nhưng không có nghĩa là ứng dụng gặp sự cố. Tham khảo bài viết Gỡ lỗi thông điệp nhật ký lỗi thường gặp để diễn giải các lỗi tải quảng cáo thường gặp. Nếu bạn thấy lỗi định kỳ liên quan đến việc phân phát quảng cáo không được ghi lại, hãy chia sẻ dấu vết ngăn xếp với nhóm hỗ trợ Google Mobile Ads SDK (Legacy).
  • Thêm các phương thức addCustomTargeting() vào AdRequest.
23.3.0 12/8/2024
  • 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.0.0.
23.2.0 27/6/2024
  • Thêm AdView.isCollapsible() để cho biết liệu biểu ngữ được tải gần đây nhất có thể thu gọn hay không.
23.1.0 2024‑05‑09
  • Yêu cầu compileSdkVersion tối thiểu là 34.
  • Bộ chuyển đổi dàn xếp gốc: Ngừng sử dụng loadNativeAd và loadRtbNativeAd() để thay bằng loadNativeAdMapper() và loadRtbNativeAdMapper(). Bộ chuyển đổi nên chuyển sang sử dụng các phương thức tải mới này và các đối tượng liên quan.
23.0.0 2024‑03‑07
  • Thay đổi có thể gây lỗi:
    • Tăng cấp độ API tối thiểu của Android lên 21.
    • Để tiếp tục thu thập chỉ số người dùng trong AdMob, hãy liên kết ứng dụng AdMob của bạn với Firebase và tích hợp SDK Google Analytics cho Firebase vào ứng dụng đó.
    • Đã xóa API MobileAds.enableSameAppKey() không dùng nữa và cập nhật phương thức thay thế MobileAds.putPublisherFirstPartyIdEnabled() để trả về một boolean về việc liệu tính bền vững của chế độ kiểm soát có thành công hay không.
    • Native Ads:
      • Đã xoá AdLoader.forUnifiedNativeAd(). Thay vào đó, hãy sử dụng AdLoader.forNativeAd().
      • Đã xoá AdLoader.forCustomTemplateAd(). Thay vào đó, hãy sử dụng AdLoader.forCustomFormatAd().
    • Đã xoá AdFormat.UNKNOWN mà không thay thế. Ứng dụng sử dụng QueryInfo.generate() phải truyền một định dạng quảng cáo.
    • Giờ đây, bạn có thể liên kết các phương thức AdManagerAdRequest.Builder kế thừa từ thành phần mẹ để tạo một đối tượng từ một lệnh gọi duy nhất. Điều này đòi hỏi phải thay đổi cấu trúc kế thừa sao cho AdManagerAdRequest.Builder không còn kế thừa từ AdRequest.Builder.
  • Thêm MobileAds.registerCustomTabsSession() để cải thiện khả năng kiếm tiền từ quảng cáo trong Thẻ tuỳ chỉnh. Hãy xem bài viết Tối ưu hoá Thẻ tuỳ chỉnh để biết thêm thông tin.
  • 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 2.2.0.
22.6.0 6/12/2023
  • Ngừng sử dụng MobileAds.setSameAppKeyEnabled() và đổi tên phương thức thành MobileAds.putPublisherFirstPartyIdEnabled().
  • Ngừng sử dụng AdFormat.UNKNOWN mà không có phương án thay thế. Các ứng dụng sử dụng QueryInfo.generate() phải truyền một định dạng quảng cáo.
22.5.0 2023‑10‑30
22.4.0 2023‑09‑13
  • Yêu cầu compileSdkVersion tối thiểu là 33.
  • Công cụ kiểm tra quảng cáo: Thêm tính năng hỗ trợ SDK quảng cáo để yêu cầu và hiển thị quảng cáo được yêu cầu thông qua giao diện người dùng của Công cụ kiểm tra quảng cáo.
  • Thêm một phương thức QueryInfo.generate() mới lấy mã đơn vị quảng cáo.
  • Cho phép thử nghiệm ban đầu các API bảo đảm quyền riêng tư trong giai đoạn thử nghiệm beta của Attribution Reporting và Topics. Hãy xem hướng dẫn về Hộp cát về quyền riêng tư trên Android của AdMob để biết thêm thông tin.
22.3.0 22/8/2023
22.2.0 2023‑07‑05
22.1.0 2023‑05‑18
  • Công cụ kiểm tra quảng cáo: Cho phép kích hoạt các yêu cầu quảng cáo từ giao diện người dùng của công cụ kiểm tra quảng cáo trên những thiết bị không có Dịch vụ Google Play.
22.0.0 29/3/2023
  • Thay đổi có thể gây lỗi:
  • Thêm AdRequest.getRequestAgent().
  • Dàn xếp: Giá trị trả về cho Adapter.getVersionInfo() và Adapter.getSDKVersionInfo() đã thay đổi từ loại com.google.android.gms.ads.mediation.VersionInfo thành com.google.android.gms.ads.VersionInfo. Bạn nên sử dụng bộ chuyển đổi trả về loại mới vì com.google.android.gms.ads.mediation.VersionInfo không còn được dùng nữa.
21.5.0 2023‑01‑31
  • Quảng cáo khi mở ứng dụng: Ngừng sử dụng các phương thức AppOpenAd.load() chấp nhận tham số đầu vào hướng và thêm các phương thức mới không nhận đầu vào hướng. Các phương thức mới xác định hướng tại thời điểm yêu cầu, phù hợp với hành vi của các định dạng toàn màn hình khác.
  • Dàn xếp: Thêm tính năng hỗ trợ dàn xếp cho quảng cáo khi mở ứng dụng.
  • Xoá quyền RECEIVE_BOOT_COMPLETED khỏi phần phụ thuộc androidx.work:work-runtime. Nếu đang sử dụng các phiên bản Gradle cũ hơn 7.2.0 và cần có quyền cho ứng dụng, bạn có thể cần phải khai báo quyền một cách rõ ràng trong tệp kê khai Android.
21.4.0 14/12/2022
  • Hiện tại, tất cả ứng dụng Ad Manager đều phải có mã ứng dụng Ad Manager và phải ở định dạng ca-app-pub-################~##########. Hãy xem phần Định cấu hình ứng dụng để biết thêm thông tin chi tiết.
  • Công cụ kiểm tra quảng cáo: Mở rộng khả năng hỗ trợ của SDK để hiển thị quảng cáo biểu ngữ và quảng cáo gốc được yêu cầu thông qua giao diện người dùng của công cụ kiểm tra quảng cáo.
  • Bổ sung tính năng hỗ trợ cho Mã nhận dạng bên thứ nhất của nhà xuất bản (trước đây gọi là khoá cho cùng ứng dụng) để giúp bạn phân phối quảng cáo được cá nhân hoá và phù hợp hơn bằng cách sử dụng dữ liệu thu thập được từ các ứng dụng của bạn.
  • Phiên bản phát hành chính thức cho thế hệ QueryInfo.
21.3.0 2022‑10‑10
21.2.0 2022‑09‑06
  • Công cụ kiểm tra quảng cáo: Thêm tính năng hỗ trợ SDK quảng cáo để xuất nhật ký yêu cầu quảng cáo thông qua Trang chia sẻ nội dung trong Android.
21.1.0 2022‑07‑14
  • Thêm tính năng hỗ trợ kiếm tiền từ quảng cáo trong WebView. Hãy xem bài viết Tích hợp WebView API cho quảng cáo để biết thêm thông tin chi tiết.
  • Đã thêm getResponseExtras() vào ResponseInfo có thể trả về thông tin bổ sung về nội dung phản hồi quảng cáo.
21.0.0 2022‑05‑25
  • Thay đổi có thể gây lỗi:
    • Google Mobile Ads SDK (Legacy) hiện yêu cầu tất cả ứng dụng phải có cấp độ API Android tối thiểu là 19 để có thể chạy.
    • Thêm chú thích @NonNull vào mọi phương thức trước đây chưa xác định rõ ràng tính chất rỗng.
    • Đã xóa phương thức AdRequest.Builder.addNetworkExtras(). Thay vào đó, hãy sử dụng AdRequest.Builder.addNetworkExtrasBundle().
    • Đã xóa các phương thức vị trí sau:
      • setLocation() vào AdRequest.Builder
      • getLocation() trên AdRequest
      • getLocation() vào MediationAdConfiguration
  • Thêm cờ tệp kê khai để tối ưu hoá hoạt động khởi chạy và tải quảng cáo, hãy xem Hướng dẫn tối ưu hoá hoạt động khởi chạy và tải quảng cáo để biết thêm thông tin chi tiết.
  • Ngừng sử dụng MobileAds.getVersionString(). Thay vào đó, hãy sử dụng MobileAds.getVersion().
  • Thêm phương thức getLoadedAdapterResponseInfo() vào ResponseInfo.
  • Thêm các phương thức sau vào AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • Thêm tính năng hỗ trợ sự kiện tuỳ chỉnh trong công cụ kiểm tra quảng cáo.
20.6.0 2022‑02‑22
20.5.0 2021‑11‑18
  • Thêm tính năng hỗ trợ cho các thiết bị Android 12 đối với ứng dụng nhắm đến API 31.
  • Thêm tính năng hỗ trợ cho mã nhóm ứng dụng cho các trường hợp sử dụng như báo cáo và ngăn chặn gian lận.
20.4.0 2021‑09‑22
  • Kể từ phiên bản 20.4.0, Google Mobile Ads SDK (Legacy) sẽ bao gồm quyền com.google.android.gms.permission.AD_ID trong tệp kê khai của SDK. Quyền này sẽ được các công cụ bản dựng Android tự động hợp nhất vào tệp kê khai ứng dụng. Để tìm hiểu thêm về việc khai báo quyền AD_ID, bao gồm cả cách tắt tính năng này, hãy tham khảo bài viết trợ giúp này trên Trung tâm trợ giúp của Play Console.
  • Thêm lệnh gọi lại onAdClicked() vào FullScreenContentCallback.
  • Bật lệnh gọi lại onAdClicked() trong lớp AdListener cho định dạng quảng cáo gốc.
20.3.0 23/8/2021
20.2.0 2021‑06‑08
  • Thêm tính năng hỗ trợ công cụ kiểm tra quảng cáo (Thử nghiệm) cho nhà xuất bản Google Ad Manager.
20.1.0 2021‑04‑29
20.0.0 2021‑04‑05
  • Thay đổi có thể gây lỗi:
    • Đã xóa API Interstitial cũ.
    • Đã xóa API RewardedVideoAd cũ.
    • Xoá các lớp có tiền tố Publisher (ví dụ: PublisherAdView).
    • Đã xoá CustomRenderedAd.
    • Đã xoá InstreamAd.
    • Đã xoá SearchAdRequest.
    • Đã xoá AdListener.onAdLeftApplication().
    • Xoá NativeAppInstallAd, NativeContentAd và UnifiedNativeAd. Hiện có một định dạng quảng cáo gốc tên là NativeAd.
    • RewardedAd hiện là một lớp trừu tượng. Sử dụng phương thức tĩnh RewardedAd.load() để tải quảng cáo có tặng thưởng.
  • Thêm công cụ kiểm tra quảng cáo (Thử nghiệm).
  • Ngừng sử dụng AdSize.SMART_BANNER và thay bằng quảng cáo biểu ngữ thích ứng.
  • Thêm chú thích rõ ràng về tính chất rỗng trên tất cả API công khai.
19.8.0 2021‑03‑15
  • Thêm phần phụ thuộc vào User Messaging Platform SDK.
  • Thêm lệnh gọi lại onAdImpression() vào FullScreenContentCallback.
  • Ngừng sử dụng định dạng InstreamAd.
  • Bộ chuyển đổi dàn xếp:
    • Đã ngừng sử dụng MediationBannerAdapter, MediationInterstitialAdapter và MediationNativeAdapter. Các bộ chuyển đổi mới phải triển khai lớp Adapter để tải các định dạng này.
    • Giờ đây, bộ chuyển đổi đặt giá thầu có thể triển khai các phương thức tải riêng biệt trong lớp Adapter cho các định dạng dành riêng cho RTB.
19.7.0 20/1/2021
  • Những thay đổi lớn đối với:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • Ngừng sử dụng CustomRenderedAd.
  • Các lớp và gói có tiền tố Publisher đã ngừng hoạt động và được thay thế bằng tiền tố AdManager.
  • Bản phát hành nhỏ gần đây nhất trước phiên bản 20.0.0. Tất cả API được đánh dấu là không dùng nữa trong bản phát hành này và các bản phát hành trước sẽ bị xoá trong phiên bản 20.0.0. Hãy xem hướng dẫn di chuyển phiên bản 20.0.0 để biết thêm thông tin chi tiết.
19.6.0 2020‑12‑04
  • Ngừng sử dụng phương thức onAdLeftApplication() AdListener.
  • Sửa lỗi khiến người dùng trên thiết bị Android 11 được yêu cầu chọn một trình duyệt khi nhấp vào quảng cáo.
19.5.0 20/10/2020
  • Quảng cáo biểu ngữ: Phương thức onAdImpression() AdListener hiện được gọi cho quảng cáo biểu ngữ.
  • Thêm phương thức setHttpTimeoutMillis() để tuỳ chỉnh thời gian chờ cho các lệnh gọi HTTPS do SDK Quảng cáo của Google trên thiết bị di động thực hiện.
19.4.0 2020‑09‑10
  • Thêm tính năng hỗ trợ thiết bị Android 11 cho các ứng dụng nhắm đến API 30.
  • Quảng cáo khi mở ứng dụng: Thay đổi định dạng AppOpenAd để hoạt động giống với định dạng toàn màn hình hơn là chế độ xem biểu ngữ. Thêm các phương thức getResponseInfo() và show() vào AppOpenAd. Ngừng sử dụng các lớp AppOpenAdView và AppOpenAdPresentationCallback.
  • Dàn xếp: Hiện đã có báo cáo trạng thái dàn xếp. Sử dụng ResponseInfo.getAdapterResponses() để nhận thông tin phản hồi cho từng mạng quảng cáo đã tham gia vào một yêu cầu quảng cáo.
  • Quảng cáo có tặng thưởng cũ: Ngừng sử dụng RewardedVideoAd.
  • Khắc phục lỗi trong đó MobileAds.initialize() chỉ gọi lại trình xử lý hoàn tất một lần. Mỗi lệnh gọi đến MobileAds.initialize() hiện sẽ gọi lệnh gọi lại hoàn tất.
19.3.0 20/7/2020
  • Thêm các phương thức getDomain() và getCause() vào AdError.
  • Thêm lệnh gọi lại mới khi tải không thành công vào tất cả định dạng quảng cáo trả về LoadAdError. Ví dụ: onAdFailedToLoad(LoadAdError).
  • Ngừng sử dụng lệnh gọi lại lỗi tải trả về một int. Ví dụ: onAdFailedToLoad(int).
  • Quảng cáo có tặng thưởng: Thêm onRewardedAdFailedToShow(AdError) và ngừng sử dụng onRewardedAdFailedToShow(int).
  • Dàn xếp quảng cáo có tặng thưởng: Thêm mã lỗi trình bày MEDIATION_SHOW_ERROR. Tất cả lỗi trình bày liên quan đến quảng cáo dàn xếp hiện trả về MEDIATION_SHOW_ERROR cho AdError.getCode() và một AdError.getCause() NonNull đại diện cho lỗi dàn xếp cơ bản.
19.2.0 2020‑06‑18
  • Đã thêm định dạng RewardedInterstitialAd. Tính năng này đang trong phiên bả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.
  • Quảng cáo gốc: Thêm giao diện người dùng Trình xác thực quảng cáo gốc vào các yêu cầu thử nghiệm để giúp bạn phát hiện và khắc phục các lỗi vi phạm chính sách quảng cáo gốc.
  • Thêm phương thức MobileAds.disableMediationAdapterInitialization(). Hãy gọi phương thức này trước khi khởi chạy Google Mobile Ads SDK (Legacy) để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp.
19.1.0 2020‑04‑16
19.0.1 2020‑03‑18
  • Quảng cáo gốc: Khắc phục lỗi rò rỉ bộ nhớ xảy ra khi sử dụng NativeCustomTemplateAd.
19.0.0 2020‑03‑02
  • Thêm tính năng hỗ trợ đọc các tham số về sự đồng ý từ TCF phiên bản 2.0 của IAB và chuỗi us_privacy của IAB.
  • Thêm setNeighboringContentUrls() và getNeighboringContentUrls() vào AdRequest.
  • Thêm lớp ResponseInfo cung cấp thông tin về quảng cáo đã tải.
  • Đối với tất cả định dạng quảng cáo, getMediationAdapterClassName() không còn được dùng nữa và được thay thế bằng getResponseInfo().
  • Quảng cáo gốc: Thêm các phương thức getDuration() và getCurrentTime() vào MediaContent.
  • Dàn xếp gốc: Thêm các phương thức getDuration() và getCurrentTime() vào UnifiedNativeAdMapper để các bộ chuyển đổi triển khai.
  • Ngừng sử dụng AdRequest.Builder.addTestDevice(). Thay vào đó, hãy sử dụng RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 2019‑11‑05
  • Thêm API cho định dạng quảng cáo InstreamAd. 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 cấp quyền truy cập.
  • Biểu ngữ thích ứng: Thay đổi phương thức tạo biểu ngữ thích ứng trong lớp AdSize. Ví dụ: đổi tên AdSize.getCurrentOrientationBannerAdSizeWithWidth() thành AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • Dàn xếp: Google Mobile Ads SDK (Legacy) hiện đã phát hiện các ngoại lệ do bộ chuyển đổi dàn xếp gửi.
  • Dàn xếp quảng cáo có tặng thưởng: Khắc phục lỗi khiến chỉ một quảng cáo có tặng thưởng được dàn xếp xuất hiện khi có nhiều quảng cáo có tặng thưởng được lưu vào bộ nhớ đệm.
  • Thêm phương thức setTestDeviceIds() để cho phép đặt thiết bị thử nghiệm một lần cho tất cả yêu cầu quảng cáo.
18.2.0 2019‑08‑29
  • Thêm API cho định dạng AppOpenAd. 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 cấp quyền truy cập.
18.1.1 23/7/2019
  • Dàn xếp: Bộ chuyển đổi hiện được khởi chạy khi ứng dụng gọi MobileAds.initialize(Context, OnInitializationCompleteListener).
  • Dàn xếp: Các ngoại lệ của bộ chuyển đổi có dấu vết ngăn xếp bao gồm Google Mobile Ads SDK (Legacy) hiện được Google Mobile Ads SDK (Legacy) phát hiện và xử lý.
18.1.0 2019‑07‑09
  • Bản phát hành chính thức hỗ trợ tính năng Đo lường ứng dụng.
  • Theo mặc định, tính năng đo lường ứng dụng sẽ khởi chạy và gửi dữ liệu khi ứng dụng khởi động. Thêm một tuỳ chọn để trì hoãn việc đo lường ứng dụng cho đến khi Google Mobile Ads SDK (Legacy) được gọi một cách rõ ràng.
  • Thêm một phương thức khởi chạy mới, MobileAds.initialize(Context, OnInitializationCompleteListener), thông báo cho bạn khi Google Mobile Ads SDK (Legacy) và tất cả bộ chuyển đổi dàn xếp đã định cấu hình hoàn tất quá trình khởi chạy.
  • Thêm MobileAds.getInitializationStatus() để cung cấp trạng thái khởi chạy của tất cả mạng quảng cáo được định cấu hình cho ứng dụng của bạn.
  • Đã thêm MobileAds.getRequestConfiguration(). Các tham số nhắm mục tiêu được đặt trên đối tượng cấu hình này được dùng cho tất cả yêu cầu quảng cáo.
  • Quảng cáo gốc: Thêm phương thức NativeAdOptions.Builder.setMediaAspectRatio() để yêu cầu một tỷ lệ khung hình cụ thể cho tài sản truyền thông của quảng cáo gốc. Lựa chọn này được ưu tiên hơn phương thức setImageOrientation() hiện không còn được dùng nữa.
  • Quảng cáo gốc: Đối với quảng cáo không phải dạng video, giờ đây, bạn có thể đặt loại tỷ lệ hình ảnh của MediaView bằng cách sử dụng MediaView.setImageScaleType().
  • Quảng cáo gốc: Đã thêm UnifiedNativeAd.getMediaContent(). Giờ đây, những nhà xuất bản chỉ tải hình ảnh bằng URL có thể lấy nội dung đa phương tiện của quảng cáo, cung cấp hình ảnh cho nội dung đó và gọi MediaView.setMediaContent() để điền dữ liệu hình ảnh thông qua MediaView cho quảng cáo không phải dạng video.
  • Dàn xếp quảng cáo gốc: Giờ đây, bộ chuyển đổi có thể cung cấp tỷ lệ khung hình bằng cách sử dụng UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • Thêm các phần phụ thuộc vào play-services-measurement và play-services-measurement-sdk. Ứng dụng không cần thêm các phần phụ thuộc này một cách rõ ràng nữa.
18.0.0 2019‑06‑17
  • Di chuyển từ Thư viện hỗ trợ Android sang Thư viện Jetpack (AndroidX). Hãy tham khảo ghi chú phát hành của Dịch vụ Google Play để biết thêm thông tin.
  • Để tránh sự cố xảy ra trong lần khởi chạy đầu tiên sau khi cài đặt ứng dụng từ Cửa hàng Play, bản phát hành này yêu cầu nhà xuất bản khai báo các phần phụ thuộc bổ sung trong 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 21/5/2019
  • Khắc phục lỗi ANR bắt nguồn từ android.media.AudioManager.getStreamVolume.
17.2.0 2019‑03‑11
  • Video có tặng thưởng: Thêm một nhóm API có tặng thưởng mới (xem gói có tặng thưởng) cho phép bạn tải nhiều quảng cáo có tặng thưởng cùng một lúc.
  • Dàn xếp: Thêm một nhóm API bộ chuyển đổi dàn xếp mới hỗ trợ khởi chạy. Bộ chuyển đổi triển khai API mới sẽ triển khai lớp Adapter.
  • Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.2.0 của bất kỳ thư viện quảng cáo nào (ví dụ: com.google.android.gms:play-services-ads:17.2.0) phải sử dụng com.google.firebase:firebase-analytics:16.3.0.
17.1.3 2019‑01‑31
  • Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.1.3 của bất kỳ thư viện quảng cáo nào (ví dụ: com.google.android.gms:play-services-ads:17.1.3) phải sử dụng com.google.firebase:firebase-analytics:16.3.0.
17.1.2 2018‑12‑03
  • Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.1.2 của bất kỳ thư viện quảng cáo nào (ví dụ: com.google.android.gms:play-services-ads:17.1.2) phải sử dụng com.google.firebase:firebase-analytics:16.0.6.
17.1.1 2018‑11‑12
  • Khắc phục lỗi trong đó một số tổ hợp play-services-ads và firebase-analytics (ví dụ: ads:17.1.0 và analytics:16.0.5) dẫn đến lỗi trình biên dịch duplicate entry. Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.1.1 của bất kỳ thư viện quảng cáo nào (ví dụ: com.google.android.gms:play-services-ads:17.1.1) phải sử dụng com.google.firebase:firebase-analytics:16.0.5.
17.1.0 2018‑11‑02
17.0.0 2018‑10‑05
  • Nhà xuất bản Google AdMob bắt buộc phải chỉ định một thẻ <meta-data> có khoá com.google.android.gms.ads.APPLICATION_ID trong tệp AndroidManifest.xml. Tham khảo Hướng dẫn bắt đầu sử dụng để biết thêm thông tin chi tiết.
  • Quảng cáo gốc: NativeAppInstallAd, NativeContentAd và các API liên quan không còn được dùng nữa mà thay vào đó là UnifiedNativeAd. Hãy tham khảo bài viết Quảng cáo gốc Nâng cao hợp nhất để biết thêm hướng dẫn về cách sử dụng các API mới.
  • Quảng cáo gốc: Đã thêm tính năng "Ẩn quảng cáo này".
  • Quảng cáo gốc: Nhật ký cảnh báo lành tính: "UnconfirmedClickListener must not be null while ClickConfirmingView is set." (UnconfirmedClickListener không được rỗng khi ClickConfirmingView được đặt) đã bị xoá.
  • Quảng cáo có tặng thưởng: Thêm phương thức setAdMetadataListener trên RewardedVideoAd để theo dõi các thay đổi về siêu dữ liệu quảng cáo.
  • Quảng cáo có tặng thưởng: Việc gọi destroy() sẽ vô hiệu hoá trình nghe.
  • Ngừng sử dụng các phương thức sau trên AdRequest.Builder.
  • Khắc phục lỗi onRewardedVideoCompleted() không kích hoạt trên trình mô phỏng.
16.0.0 2018‑10‑02
  • Không có thay đổi nào về quảng cáo. Hãy tham khảo ghi chú phát hành của Dịch vụ Google Play để biết thêm thông tin.
15.0.0 2018‑04‑12
  • Phiên bản thử nghiệm MRAID phiên bản 3.
  • Quảng cáo gốc: Thêm API Quảng cáo gốc hợp nhất. Thao tác này kết hợp NativeAppInstallAds và NativeContentAds thành một loại mới: UnifiedNativeAd.
  • Lưu ý: Khi sử dụng quảng cáo gốc, có một cảnh báo lành tính xuất hiện trong nhật ký khi người dùng nhấp vào quảng cáo gốc: "UnconfirmedClickListener không được rỗng khi ClickConfirmingView được đặt." Bạn có thể bỏ qua cảnh báo này và cảnh báo này sẽ bị xoá trong bản phát hành tiếp theo.
12.0.1 2018‑03‑28
  • Không có thay đổi nào về quảng cáo. Hãy xem ghi chú phát hành của Dịch vụ Google Play để biết thêm thông tin chi tiết.
12.0.0 20/3/2018
  • Video có tặng thưởng: Đã thêm phương thức gọi lại onRewardedVideoCompleted() vào RewardedVideoAdListener.
  • Dàn xếp gốc: Đã thêm phương thức trackViews() vào NativeAdMapper, cho phép bộ chuyển đổi truy cập vào các đối tượng View tương ứng với từng thành phần quảng cáo gốc. Ngừng sử dụng trackView() và thay bằng trackViews().
11.8.0 2017‑12‑18
  • Sửa lỗi và cải tiến chung.
11.6.0 2017‑11‑07
  • Thêm lớp NativeAdViewHolder và các phương thức liên quan trong NativeAppInstallAd và NativeContentAd.
  • Không dùng AdLoader.getMediationAdapterClassName nữa (thay vào đó, nhà xuất bản nên sử dụng các phương thức có cùng tên trong NativeAppInstallAd và NativeContentAd).
  • Quảng cáo thử nghiệm hiện hiển thị một nhãn ở đầu quảng cáo. Hãy xem hướng dẫn kiểm thử để biết thêm thông tin chi tiết.
11.4.0 2017‑09‑19
  • Thêm các phương thức getMediationAdapterClassName() vào lớp NativeAppInstallAd và NativeContentAd. Phương thức cùng tên trong AdLoader sẽ không được dùng nữa.
  • Thêm phương thức onVideoEnd() vào lớp MediationNativeListener, các phương thức hasVideoContent(), setHasVideoContent() và setMediaView() vào lớp NativeAdMapper, và các phương thức getAdVolume() và isAdMuted() vào lớp NativeMediationAdRequest để hỗ trợ tính năng dàn xếp video gốc.
  • Đã xóa lớp SearchAdRequest.
11.2.2 2017‑09‑05
  • Thêm một phương thức loadAd() mới nhận đối tượng PublisherAdRequest vào lớp RewardedVideoAd.
11.2.0 2017‑08‑14
  • Thêm phương thức loadAds() vào lớp AdLoader, cho phép ứng dụng tải nhiều quảng cáo riêng biệt trong một yêu cầu.
  • Khi bạn nâng cấp ứng dụng lên phiên bản 11.2.0 trở lên của SDK Quảng cáo của Google trên thiết bị di động, build.gradle của ứng dụng cũng phải được cập nhật để chỉ định compileSdkVersion tối thiểu là 26 (Android O). Điều này không làm thay đổi cách ứng dụng của bạn chạy. Bạn sẽ không cần phải cập nhật targetSdkVersion.
  • Kể từ phiên bản 11.2.0, Google Mobile Ads SDK (Legacy) được cung cấp thông qua kho lưu trữ Maven của Google. Để biết thêm thông tin, hãy xem ghi chú phát hành của Dịch vụ Google Play.
11.0.0 2017‑06‑07
  • Thêm các phương thức onAdClicked() và onAdImpression() vào lớp AdListener. Các phương thức này chỉ được gọi cho quảng cáo cài đặt ứng dụng gốc và quảng cáo nội dung gốc.
  • Đã xóa các phương thức getInAppPurchaseListener() và setInAppPurchaseListener() khỏi các lớp AdView, InterstitialAd và NativeExpressAdView. Đồng thời, xoá các lớp mua hàng trong ứng dụng có liên quan.
  • Thêm các phương thức OnVideoMute(), OnVideoPause(), OnVideoPlay() và OnVideoStart() vào lớp VideoController.VideoLifecycleCallbacks.
  • Thêm khả năng bật chế độ hiển thị tối đa trên quảng cáo toàn màn hình bằng cách thêm phương thức setImmersiveMode() vào các lớp PublisherInterstitialAd và RewardedVideoAd.
  • Thêm giao diện OnPublisherAdViewLoadedListener, lớp PublisherAdViewOptions và lớp PublisherAdViewOptions.Builder để sử dụng với AdLoader cho các yêu cầu quảng cáo gốc kết hợp biểu ngữ.
  • Thêm giao diện OnImmersiveModeUpdatedListener không bắt buộc mà các bộ chuyển đổi dàn xếp có thể triển khai để được thông báo về các bản cập nhật chế độ hiển thị tối đa.
  • Thêm phương thức getMediationAdapterClassName() vào lớp RewardedVideoAd.
  • Thêm các quy tắc keep để tự động giữ lại tên lớp của bộ chuyển đổi dàn xếp khi sử dụng ProGuard.
10.2.0 2017‑2‑15
  • Dịch vụ Google Play 10.2.x là bản phát hành đầu tiên không còn hỗ trợ đầy đủ cho Android phiên bản 2.3.x (Gingerbread). Ứng dụng được phát triển bằng SDK phiên bản 10.2.x trở lên yêu cầu cấp độ API Android tối thiểu là 14 và không thể cài đặt trên các thiết bị chạy cấp độ API thấp hơn 14. Để tìm hiểu thêm về các lựa chọn, bao gồm cả việc tạo nhiều tệp APK để mở rộng khả năng hỗ trợ của ứng dụng cho Android Gingerbread, hãy xem Blog dành cho nhà phát triển Android.
  • Thêm tính năng hỗ trợ cho thành phần video đối với nội dung Quảng cáo gốc nâng cao và quảng cáo mẫu tùy chỉnh.
  • Thêm các phương thức getVideoController(), setVideoOptions() và getVideoOptions() vào lớp PublisherAdView.
  • Thêm lớp AdChoicesView.
  • Thêm các phương thức getAdChoicesContent() và setAdChoicesContent() vào lớp NativeAdMapper.
  • Thêm giao diện InitializableMediationRewardedVideoAdAdapter cho các bộ chuyển đổi dàn xếp video có tặng thưởng muốn chọn sử dụng tính năng khởi chạy sớm trước khi đưa ra yêu cầu quảng cáo.
  • Thêm tính năng hỗ trợ xem trước trong ứng dụng và khắc phục sự cố trong Google Ad Manager.
10.0.1 21/11/2016
  • Sửa lỗi và cải tiến chung.
9.8.0 24/10/2016
  • MobileAds.Initialize(Context) đã được khôi phục. Nhà xuất bản Google Ad Manager nên gọi phương thức này khi khởi chạy ứng dụng của họ. Nhà xuất bản AdMob vẫn nên sử dụng MobileAds.Initialize(Context, String) và truyền mã xử lý ứng dụng của họ.
9.6.0 2016‑09‑22
  • Thêm lớp MediaView cho quảng cáo dạng video Quảng cáo gốc nâng cao.
  • Thêm phương thức openDebugMenu() vào lớp MobileAds để xem trước mẫu quảng cáo và khắc phục sự cố cho đơn vị quảng cáo Ad Manager.
  • Thêm tính năng hỗ trợ cho sự kiện tuỳ chỉnh của video có tặng thưởng.
9.4.0 2016‑08‑01
  • Sửa lỗi và cải tiến chung.
9.2.0 2016‑06‑27
  • Thêm phương thức setAdChoicesPlacement() vào lớp NativeAdOptions.Builder. Giờ đây, nhà xuất bản ứng dụng có thể sử dụng phương thức này để chỉ định vị trí của AdChoices trong quảng cáo gốc.
  • Tính năng phát quảng cáo dạng video đã được cải thiện nhờ một số bản sửa lỗi.
9.0.1 2016‑05‑26
  • Giải quyết vấn đề về ProGuard xuất hiện trong phiên bản 9.0.0. Nhà xuất bản không cần lựa chọn keep cho com.google.android.gms.common.util.DynamiteApi nữa.
9.0.0 2016‑05‑18
  • Thêm tính năng tự động điền thông tin vị trí cho các ứng dụng cấp quyền truy cập vị trí một cách rõ ràng.
  • Thêm tính năng hỗ trợ cho các sự kiện tuỳ chỉnh của tính năng dàn xếp Video có tặng thưởng.
  • Đã thêm các lựa chọn video cho quảng cáo biểu cảm Native Express.
  • Cập nhật API Quảng cáo tìm kiếm tuỳ chỉnh.
  • Thêm phương thức setAppMuted().
  • Phương thức MobileAds.initialize(android.content.Context, java.lang.String) đã được sử dụng trở lại.
  • Phương thức MobileAds.initialize(android.content.Context) hiện không còn được dùng nữa.
  • Thêm phương thức MediationNativeListener.onAdImpression() để báo cáo lượt hiển thị trong bộ chuyển đổi dàn xếp.
  • Chỉ đối với bản phát hành này, các ứng dụng sử dụng ProGuard để xử lý hậu kỳ ứng dụng cần thêm tuỳ chọn keep sau vào tệp cấu hình ProGuard: -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 2015‑12‑18
  • Thêm một phương thức công khai, MobileAds.setAppVolume(), để thông báo cho Google Mobile Ads SDK (Legacy) về mức âm lượng hiện tại của ứng dụng.
  • Đã triển khai các bản sửa lỗi và cải tiến.
8.3.0 6/11/2015
  • Thêm tính năng hỗ trợ quảng cáo dạng video có tặng thưởng.
  • Thêm phương thức isLoading() vào PublisherAdView và PublisherInterstitialAd để kiểm tra xem yêu cầu quảng cáo có đang được thực hiện hay không.
  • Thêm phương thức setIsDesignedForFamilies() vào AdRequest.Builder và PublisherAdRequest.Builder.
  • Thêm phương thức destroy() vào NativeAdView.
8.1.0 2015‑09‑24 Nhiều bản sửa lỗi khác nhau.
7.8.0 2015‑08‑13
  • Phiên bản phát hành chính thức của MRAID phiên bản 2.
  • Thêm phương thức isLoading() vào AdLoader, AdView và InterstitialAd để kiểm tra xem yêu cầu quảng cáo có đang được thực hiện hay không.
  • Ngừng sử dụng PublisherAdRequest.Builder#setManualImpressionsEnabled(). Thay vào đó, hãy sử dụng PublisherAdView#setManualImpressionsEnabled().
7.5.0 2015‑05‑28
  • Bổ sung tính năng hỗ trợ cho định dạng quảng cáo gốc về nội dung và quảng cáo cài đặt ứng dụng trên AdMob và Ad Manager.
  • Hỗ trợ thêm các định dạng quảng cáo gốc tuỳ chỉnh, có sẵn cho các mục đặt trước trên Ad Manager.
7.3.0 2015‑04‑28 Nhiều bản sửa lỗi khác nhau.
7.0.0 2015‑03‑19
  • Thêm các phương thức addCustomTargeting() và addCategoryExclusion() vào PublisherAdRequest.Builder.
  • Khắc phục vấn đề khiến PublisherAdView.recordManualImpression() ghi lại nhiều lượt hiển thị trong Ad Manager khi sử dụng tính năng đếm lượt hiển thị thủ công.
  • Khắc phục vấn đề khiến quảng cáo hiển thị không đúng cách khi sử dụng thuộc tính android:largestWidthLimitDp trên thẻ <supports-screens>.
  • Thêm phương thức setRequestAgent() vào AdRequest.Builder và PublisherAdRequest.Builder. Bạn nên sử dụng phương thức này để biểu thị nguồn gốc yêu cầu quảng cáo của bên thứ ba dàn xếp đến Google Mobile Ads SDK (Legacy).
6.5.87 2014‑12‑08
  • Ra mắt cấu trúc JAR phân tách – Nhà phát triển Android Studio hiện có thể chỉ cần thêm phần quảng cáo của Dịch vụ Google Play bằng cách dựa vào com.google.android.gms:play‑services‑ads:6.+.
    Lưu ý: Các ứng dụng tạo quảng cáo biểu ngữ trong XML vẫn phải tham chiếu đến toàn bộ thư viện com.google.android.gms:play‑services:6.+.
  • Nhiều bản sửa lỗi khác nhau.
6.1 2014‑10‑08
  • Thêm phương thức getLocation() vào com.google.android.gms.ads.MediationAdRequest.
  • Thêm nội dung mô tả vào nút đóng quảng cáo xen kẽ để hỗ trợ tiếp cận.
  • Đã xóa ghi nhật ký "Không tìm thấy tài nguyên Google Play" khi dự án thư viện được liên kết chính xác.
  • Đã thêm getMediationAdapterClassName() vào AdView để lấy tên lớp của bộ chuyển đổi dàn xếp mạng quảng cáo đang hiển thị quảng cáo.
17.0.0 2018‑10‑05
  • Thêm các API mới để triển khai Sự kiện tuỳ chỉnh.
  • Thêm quy trình mua mặc định cho tính năng Mua hàng trong ứng dụng, sử dụng API Google Play Billing.
4,4 2014‑05‑07
  • Thêm các API Bộ chuyển đổi dàn xếp mới.
  • Thêm định dạng quảng cáo 320x100 LARGE_BANNER mới cho cả điện thoại và máy tính bảng.
  • Thêm định dạng quảng cáo xen kẽ mới cho tính năng Mua hàng trong ứng dụng. Đặt InAppPurchaseListener trên InterstitialAd để theo dõi các sự kiện mua hàng trong ứng dụng.
  • Bản sửa lỗi khiến SecurityException gặp sự cố do đọc gservices mà không được phép.
4,3 2014‑03‑17
  • InterstitialAd hiện hoạt động nếu được truyền ngữ cảnh ứng dụng.
  • Thêm phương thức setContentUrl() vào PublisherAdRequest.Builder.
  • Khắc phục ngoại lệ khi Dịch vụ chưa được đăng ký.
4.2 2014‑02‑03 Nhiều bản sửa lỗi khác nhau.
4.1 2014‑01‑16
  • Bổ sung tính năng hỗ trợ cho Ad Manager và Quảng cáo tìm kiếm cho ứng dụng di động.
  • AdRequest.Builder hiện có phương thức setLocation().
  • Khắc phục sự cố xảy ra nếu có yêu cầu quảng cáo xen kẽ nhưng AdActivity không được chỉ định trong tệp kê khai.
4 2013‑10‑31
  • API Google Mobile Ads hiện là một phần của Dịch vụ Google Play.
  • Các bản cập nhật trong tương lai cho API quảng cáo trên thiết bị di động của Google sẽ tự động được đẩy đến các thiết bị thông qua Dịch vụ Google Play.
  • Ad Manager và Quảng cáo tìm kiếm cho ứng dụng di động chưa được hỗ trợ.