Ghi chú phát hành

Phiên bản Ngày phát hành Ghi chú
23.2.0 27/06/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 09/05/2024
  • 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 loadNativeAdloadRtbNativeAd(), thay vào đó là loadNativeAdMapper()loadRtbNativeAdMapper(). Bạn nên chuyển sang sử dụng các phương thức tải mới và đối tượng liên quan này.
23.0.0 07/03/2024
  • Thay đổi có thể gây lỗi:
    • Tăng cấp độ API Android tối thiểu 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 đó.
    • Xoá 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 giá trị boolean cho biết liệu hoạt động kiểm soát cố định 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 có lựa chọn thay thế. Các ứng dụng sử dụng QueryInfo.generate() phải vượt qua một định dạng quảng cáo.
    • Giờ đây, các phương thức AdManagerAdRequest.Builder kế thừa từ phần tử mẹ có thể được liên kết với nhau để tạo một đối tượng từ một lệnh gọi duy nhất. Do đó, bạn cần thay đổi cấu trúc kế thừa để AdManagerAdRequest.Builder không còn kế thừa từ AdRequest.Builder nữa.
  • 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. 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 06/12/2023
  • Không dùng MobileAds.setSameAppKeyEnabled() nữa và đổi tên phương thức này thành MobileAds.putPublisherFirstPartyIdEnabled().
  • Không dùng AdFormat.UNKNOWN nữa mà không có lựa chọn thay thế. Các ứng dụng sử dụng QueryInfo.generate() phải vượt qua định dạng quảng cáo.
22.5.0 30/10/2023
22.4.0 13/09/2023
  • Yêu cầu tối thiểu compileSdkVersion33.
  • Công cụ kiểm tra quảng cáo: Bổ sung tính năng hỗ trợ SDK để 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 phương thức QueryInfo.generate() mới lấy mã đơn vị quảng cáo.
  • Bật tính năng thử nghiệm ban đầu cho API bảo đảm quyền riêng tư của Topics Beta và Attribution Reporting API. Hãy xem hướng dẫn về AdMob Hộp cát về quyền riêng tư trên Android để biết thêm thông tin.
22.3.0 22/08/2023
  • Thêm tính năng hỗ trợ để tạo kích thước thích ứng bằng cách sử dụng AdSize.FULL_WIDTH làm chiều rộng. Trước đây, các kích thước quảng cáo được tạo bằng cách sử dụng AdSize.FULL_WIDTH sẽ được coi là AdSize.SMART_BANNER.
22.2.0 05/07/2023
22.1.0 18/05/2023
  • Công cụ kiểm tra quảng cáo: Cho phép kích hoạt 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/03/2023
  • Thay đổi có thể gây lỗi:
  • Thêm AdRequest.getRequestAgent().
  • Dàn xếp: Giá trị trả về cho Adapter.getVersionInfo()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 trả về loại dữ liệu mới này vì com.google.android.gms.ads.mediation.VersionInfo đã ngừng hoạt động.
21.5.0 31/01/2023
  • Quảng cáo khi mở ứng dụng: Các phương thức AppOpenAd.load() không được dùng nữa, chấp nhận tham số nhập hướng và thêm các phương thức mới không nhận tham số nhập 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ùy chọn 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à yêu cầu quyền cho ứng dụng của mình, thì bạn có thể cần phải khai báo quyền rõ ràng trong tệp kê khai Android.
21.4.0 14/12/2022
  • Mã ứng dụng Ad Manager hiện là bắt buộc cho tất cả ứng dụng Ad Manager và yêu cầu định dạng ca-app-pub-################~##########. Xem bài viết Đị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ợ 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ợ Mã nhận dạng bên thứ nhất của nhà xuất bản (trước đây gọi là cùng một khoá ứ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 10/10/2022
21.2.0 06/09/2022
  • Công cụ kiểm tra quảng cáo: Bổ sung tính năng hỗ trợ SDK để xuất nhật ký yêu cầu quảng cáo thông qua Trang chia sẻ nội dung Android.
21.1.0 14/07/2022
  • Đã thêm tùy chọn hỗ trợ kiếm tiền từ quảng cáo trong WebView. Hãy xem bài viết Tích hợp API WebView cho quảng cáo để biết thêm thông tin.
  • Thêm getResponseExtras() vào ResponseInfo để có thể trả về thêm thông tin về nội dung phản hồi quảng cáo.
21.0.0 25/05/2022
  • Thay đổi có thể gây lỗi:
    • SDK Quảng cáo của Google trên thiết bị di động hiện yêu cầu tất cả các ứng dụng đều bắt buộc phải sử dụng API Android cấp 19 trở lên.
    • Thêm các chú giải @NonNull vào mọi phương thức mà trước đây không xác định rõ ràng tính chất rỗng.
    • Xoá phương thức AdRequest.Builder.addNetworkExtras(). Thay vào đó, hãy sử dụng AdRequest.Builder.addNetworkExtrasBundle().
    • Xoá các phương thức truy cập thông tin 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á việc khởi chạy và tải quảng cáo, hãy xem Hướng dẫn tối ưu hoá quá trình 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() trong ResponseInfo.
  • Thêm các phương thức sau vào AdapterResponseInfo:
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • Đã thêm tuỳ chọn hỗ trợ cho các sự kiện tuỳ chỉnh trong công cụ kiểm tra quảng cáo.
20.6.0 22/02/2022
20.5.0 18/11/2021
  • Bổ sung tính năng hỗ trợ thiết bị Android 12 đối với ứng dụng nhắm đến API cấp 31.
  • Hỗ trợ thêm cho mã nhóm ứng dụng cho các trường hợp sử dụng như tính năng báo cáo và phòng chống lừa đảo.
20.4.0 22/09/2021
  • Kể từ phiên bản 20.4.0, SDK Quảng cáo của Google trên thiết bị di động 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 được các công cụ xây dựng của 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 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/08/2021
20.2.0 08/06/2021
  • Đã thêm chức 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 29/04/2021
20.0.0 05/04/2021
  • Thay đổi có thể gây lỗi:
    • Xoá API Interstitial cũ.
    • Xoá 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, NativeContentAdUnifiedNativeAd. Hiện có một định dạng quảng cáo gốc 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 (Bản thử nghiệm).
  • Ngừng sử dụng AdSize.SMART_BANNER và chuyển sang sử dụng quảng cáo biểu ngữ thích ứng.
  • Thêm chú giải rõ ràng về tính chất rỗng trên tất cả các API công khai.
19.8.0 15/03/2021
  • Thêm một phần phụ thuộc trên SDK Nền tảng thông báo cho người dùng.
  • Thêm lệnh gọi lại onAdImpression() vào FullScreenContentCallback.
  • Không dùng định dạng InstreamAd nữa.
  • Bộ chuyển đổi dàn xếp:
    • Không dùng MediationBannerAdapter, MediationInterstitialAdapterMediationNativeAdapter nữa. Các bộ chuyển đổi mới nên 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/01/2021
  • Thay đổi chính đố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ỏ cuối cùng 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. 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 04/12/2020
  • Không dùng phương thức onAdLeftApplication() AdListener nữa.
  • Khắc phục lỗi trong đó người dùng trên các thiết bị Android 11 được yêu cầu chọn 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 trên thiết bị di động của Google thực hiện.
19.4.0 10/09/2020
  • Bổ sung tính năng hỗ trợ thiết bị Android 11 đối với ứng dụng nhắm đến API cấp 30.
  • Quảng cáo khi mở ứng dụng: Thay đổi định dạng AppOpenAd để hoạt động giống định dạng toàn màn hình hơn so với chế độ xem biểu ngữ. Thêm các phương thức getResponseInfo()show() vào AppOpenAd. Các lớp AppOpenAdViewAppOpenAdPresentationCallback đã ngừng hoạt động.
  • 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ũ: RewardedVideoAd đã ngừng hoạt động.
  • Khắc phục lỗi MobileAds.initialize() chỉ gọi lại trình xử lý hoàn thành một lần. Giờ đây, mọi lệnh gọi đến MobileAds.initialize() sẽ gọi lệnh gọi lại hoàn thành.
19.3.0 20/07/2020
  • Thêm các phương thức getDomain()getCause() vào AdError.
  • Thêm các lệnh gọi lại lỗi tải mới vào tất cả những định dạng quảng cáo trả về LoadAdError. Ví dụ: onAdFailedToLoad(LoadAdError).
  • Không dùng các lệnh gọi lại lỗi tải nữa mà trả về một số nguyên. Ví dụ: onAdFailedToLoad(int).
  • Quảng cáo có tặng thưởng: Đã thêm onRewardedAdFailedToShow(AdError) và không dùng onRewardedAdFailedToShow(int) nữa.
  • Dàn xếp 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()AdError.getCause() NonNull thể hiện lỗi dàn xếp cơ bản.
19.2.0 18/06/2020
  • Thêm định dạng RewardedInterstitialAd. Tính năng này đang trong giai đoạn thử nghiệm beta 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 của Trình xác thực quảng cáo gốc trong 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 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 SDK quảng cáo trên thiết bị di động của Google để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp.
19.1.0 16/04/2020
19.0.1 18/03/2020
  • Quảng cáo gốc: Khắc phục vấn đề rò rỉ bộ nhớ xảy ra khi sử dụng NativeCustomTemplateAd.
19.0.0 02/03/2020
  • Hỗ trợ thêm tính năng đọc các thông số đồng ý từ TCF phiên bản 2.0 của IAB và chuỗi IAB us_privacy.
  • Thêm setNeighboringContentUrls()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 mọi định dạng quảng cáo, ngừng sử dụng getMediationAdapterClassName() và thay bằng getResponseInfo().
  • Quảng cáo gốc: Thêm phương thức getDuration()getCurrentTime() vào MediaContent.
  • Dàn xếp gốc: Đã thêm phương thức getDuration()getCurrentTime() vào UnifiedNativeAdMapper để bộ chuyển đổi triển khai.
  • Không dùng AdRequest.Builder.addTestDevice() nữa. Thay vào đó, hãy sử dụng RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 05-11-2019
  • Thêm các API cho định dạng quảng cáo InstreamAd. Tính năng này hiện đang trong giai đoạn thử nghiệm beta kín. 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.
  • Biểu ngữ thích ứng: Đã thay đổi các 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: SDK quảng cáo trên thiết bị di động của Google hiện có thể nắm bắt các trường hợp ngoại lệ do bộ chuyển đổi dàn xếp gửi.
  • Dàn xếp có tặng thưởng: Đã khắc phục lỗi trong đó nếu nhiều quảng cáo có tặng thưởng đã dàn xếp được lưu vào bộ nhớ đệm, thì sẽ chỉ có một quảng cáo hiển thị.
  • Thêm phương thức setTestDeviceIds() để bật việc đặ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 29-08-2019
  • Thêm các API cho định dạng AppOpenAd. Tính năng này hiện đang trong giai đoạn thử nghiệm beta kín. 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.
18.1.1 23-07-2019
  • Dàn xếp: Các 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 trường hợp ngoại lệ về bộ chuyển đổi có dấu vết ngăn xếp bao gồm SDK quảng cáo trên thiết bị di động của Google hiện được SDK quảng cáo trên thiết bị di động của Google phát hiện và xử lý.
18.1.0 09-07-2019
  • Bản phát hành chính thức cho tính năng hỗ trợ Đ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 khởi động ứng dụng. Thêm tuỳ chọn để trì hoãn việc đo lường ứng dụng cho đến khi SDK Quảng cáo của Google trên thiết bị di động đượ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 SDK quảng cáo trên thiết bị di động của Google và tất cả bộ chuyển đổi dàn xếp đã định cấu hình đã khởi chạy xong.
  • Thêm MobileAds.getInitializationStatus() để cung cấp trạng thái khởi chạy của tất cả cá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 thông 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ả cá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 tỷ lệ khung hình cụ thể cho thành phần nội dung nghe nhìn của quảng cáo gốc. Tuỳ chọn này được ưu tiên hơn so với phương thức setImageOrientation() hiện không được dùng nữa.
  • Quảng cáo gốc: Đối với quảng cáo không phải video, bạn hiệ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 thông qua URL có thể nhận được nội dung nghe nhì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: Bộ chuyển đổi hiện có thể cung cấp tỷ lệ khung hình thông qua UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • Thêm các phần phụ thuộc trên play-services-measurementplay-services-measurement-sdk. Các ứ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 17-06-2019
  • 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 chạy đầu tiên sau khi cài đặt ứng dụng qua 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 thêm các phần phụ thuộc trong tệp build.gradle của họ:
    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-05-2019
  • Bản sửa lỗi ANR bắt nguồn từ android.media.AudioManager.getStreamVolume.
17.2.0 11-03-2019
  • Video có tặng thưởng: Đã thêm một bộ API có tặng thưởng mới (xem gói có tặng thưởng) cho phép bạn tải đồng thời nhiều quảng cáo có tặng thưởng.
  • Dàn xếp: Đã thêm một nhóm API bộ chuyển đổi dàn xếp mới có hỗ trợ hoạt động khởi tạo. Các bộ chuyển đổi triển khai API mới sẽ triển khai lớp Adapter.
  • Nhà xuất bản đang 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 31-01-2019
  • Nhà xuất bản đang 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 03-12-2018
  • Nhà xuất bản đang 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 12-11-2018
  • Khắc phục lỗi một số tổ hợp nhất định của play-services-adsfirebase-analytics (ví dụ: ads:17.1.0analytics:16.0.5) dẫn đến lỗi trình biên dịch duplicate entry. Nhà xuất bản đang 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 02-11-2018
17.0.0 05-10-2018
  • Các nhà xuất bản của Google AdMob phải chỉ định một thẻ <meta-data> có khoá com.google.android.gms.ads.APPLICATION_ID trong tệp AndroidManifest.xml của họ. Hãy tham khảo Hướng dẫn bắt đầu sử dụng để biết thêm thông tin.
  • Quảng cáo gốc: NativeAppInstallAd, NativeContentAd và các API liên kết đã ngừng hoạt động và 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 để được hướng dẫn thêm 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 nhỏ: "UnconfirmedClickListener không được có giá trị rỗng trong khi ClickConfirmingView được đặt." đã bị loại bỏ.
  • 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ẽ làm rỗng 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 02-10-2018
  • 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 12-04-2018
  • 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 sẽ kết hợp NativeAppInstallAdsNativeContentAds thành một kiểu mới: UnifiedNativeAd.
  • Lưu ý: Khi sử dụng quảng cáo gốc, có một cảnh báo nhỏ xuất hiện trong nhật ký khi quảng cáo gốc được nhấp vào: "UnconfirmedClickListener không được có giá trị rỗng trong khi ClickConfirmingView được đặt." Cảnh báo này có thể bị bỏ qua và sẽ bị xoá trong bản phát hành tiếp theo.
12.0.1 28-03-2018
  • 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-03-2018
  • Video có tặng thưởng: Đã thêm phương thức gọi lại onRewardedVideoCompleted() vào RewardedVideoAdListener.
  • Tính năng 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 nội dung quảng cáo gốc. Ngừng sử dụng trackView() và thay bằng trackViews().
11.8.0 18-12-2017
  • Sửa lỗi và cải tiến chung.
11.6.0 07-11-2017
  • Thêm lớp NativeAdViewHolder và các phương thức liên quan trong NativeAppInstallAdNativeContentAd.
  • AdLoader.getMediationAdapterClassName không dùng nữa (nhà xuất bản nên sử dụng các phương thức cùng tên trong NativeAppInstallAdNativeContentAd).
  • Giờ đây, quảng cáo thử nghiệm sẽ 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 19-09-2017
  • Thêm phương thức getMediationAdapterClassName() vào các lớp NativeAppInstallAdNativeContentAd. 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, phương thức hasVideoContent(), setHasVideoContent()setMediaView() vào lớp NativeAdMapper và các phương thức getAdVolume()isAdMuted() vào lớp NativeMediationAdRequest để hỗ trợ tính năng dàn xếp video gốc.
  • Xoá lớp SearchAdRequest.
11.2.2 05-09-2017
  • Thêm một phương thức loadAd() mới đưa đối tượng PublisherAdRequest vào lớp RewardedVideoAd.
11.2.0 14-08-2017
  • Thêm phương thức loadAds() vào lớp AdLoader, cho phép các ứng dụng tải nhiều quảng cáo riêng biệt trong một yêu cầu duy nhất.
  • Khi 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, bạn cũng phải cập nhật build.gradle của ứng dụng để 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 chạy. Bạn không cần phải cập nhật targetSdkVersion.
  • Kể từ phiên bản 11.2.0, bạn có thể sử dụng SDK Quảng cáo của Google trên thiết bị di động 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 07-06-2017
  • Thêm phương thức onAdClicked()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.
  • Xoá phương thức getInAppPurchaseListener()setInAppPurchaseListener() khỏi các lớp AdView, InterstitialAdNativeExpressAdView. Đồ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()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 PublisherInterstitialAdRewardedVideoAd.
  • 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èm 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 để nhận thông báo về nội dung cập nhật của 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 15-2-2017
  • 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). Các ứng dụng được phát triển bằng bản phát hành SDK 10.2.x trở lên yêu cầu API Android cấp 14 trở lên và không thể cài đặt trên các thiết bị chạy API dưới 14. Để tìm hiểu thêm về các tuỳ chọn, bao gồm cả việc tạo nhiều 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ùy chọn hỗ trợ cho nội dung video đối với nội dung 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()getVideoOptions() vào lớp PublisherAdView.
  • Thêm lớp AdChoicesView.
  • Thêm phương thức getAdChoicesContent()setAdChoicesContent() vào lớp NativeAdMapper.
  • Đã thêm giao diện InitializableMediationRewardedVideoAdAdapter cho bộ chuyển đổi dàn xếp video có tặng thưởng muốn chọn tham gia khởi chạy sớm trước khi một yêu cầu quảng cáo được thực hiện.
  • Đã thêm tùy chọn hỗ trợ cho tính năng 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 sử dụng lại. Cá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à chuyển mã xử lý ứng dụng của họ.
9.6.0 22-09-2016
  • Thêm lớp MediaView cho Quảng cáo gốc nâng cao dạng video.
  • 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 của Ad Manager.
  • Đã thêm tùy chọn hỗ trợ cho các sự kiện tùy chỉnh của video có tặng thưởng.
9.4.0 01-08-2016
  • Sửa lỗi và cải tiến chung.
9.2.0 27-06-2016
  • Đã thêm phương thức setAdChoicesPlacement() vào lớp NativeAdOptions.Builder mà nhà xuất bản ứng dụng hiện có thể sử dụng để chỉ định vị trí của AdChoices của họ 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 bằng một số bản sửa lỗi.
9.0.1 26-05-2016
  • 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 18-05-2016
  • 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 thông tin vị trí một cách rõ ràng.
  • Đã thêm tùy chọn hỗ trợ cho các sự kiện tùy chỉnh dàn xếp video có tặng thưởng.
  • Đã thêm tùy chọn video cho Quảng cáo gốc 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) không còn được dùng nữa.
  • Phương thức MobileAds.initialize(android.content.Context) hiện không đượ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 đây vào tệp cấu hình ProGuard:

    -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 18-12-2015
  • Thêm một phương thức công khai, MobileAds.setAppVolume(), để thông báo cho SDK quảng cáo trên thiết bị di động về mức âm lượng hiện tại của một ứng dụng.
  • Đã triển khai các bản sửa lỗi và điểm cải tiến.
8.3.0 6-11-2015
  • Đã thêm tùy chọn hỗ trợ cho quảng cáo video có tặng thưởng.
  • Thêm phương thức isLoading() vào PublisherAdViewPublisherInterstitialAd để kiểm tra xem có yêu cầu quảng cáo nào đang được thực hiện hay không.
  • Thêm phương thức setIsDesignedForFamilies() vào AdRequest.BuilderPublisherAdRequest.Builder.
  • Thêm phương thức destroy() vào NativeAdView.
8.1.0 24-09-2015 Nhiều bản sửa lỗi.
7.8.0 13-08-2015
  • Phiên bản phát hành chính thức MRAID phiên bản 2.
  • Đã thêm phương thức isLoading() vào AdLoader, AdViewInterstitialAd để kiểm tra xem có yêu cầu quảng cáo nào đang được thực hiện hay không.
  • Ngừng sử dụng PublisherAdRequest.Builder#setManualImpressionsEnabled(). Sử dụng PublisherAdView#setManualImpressionsEnabled() thay thế.
7.5.0 28-05-2015
  • Đã thêm tùy chọn hỗ trợ cho các định dạng quảng cáo gốc về nội dung và cài đặt ứng dụng trên AdMob và Ad Manager.
  • Đã thêm tùy chọn hỗ trợ cho các định dạng quảng cáo gốc tùy chỉnh, có sẵn cho quảng cáo đặt trước trên Ad Manager.
7.3.0 28-04-2015 Nhiều bản sửa lỗi.
7.0.0 19-03-2015
  • Thêm phương thức addCustomTargeting()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 phương thức đếm số 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.BuilderPublisherAdRequest.Builder. Bạn nên sử dụng phương thức này để biểu thị nguồn gốc của yêu cầu quảng cáo do các bên thứ ba dàn xếp cho SDK quảng cáo trên thiết bị di động.
6.5.87 08-12-2014
  • Ra mắt kiến trúc JAR chia tách – Giờ đây, nhà phát triển Android Studio có thể chỉ cần đưa phần quảng cáo của Dịch vụ Google Play vào bằng cách dựa vào com.google.android.gms:play‑services‑ads:6.+.
    Lưu ý: Ứ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ộ com.google.android.gms:play‑services:6.+ thư viện.
  • Nhiều bản sửa lỗi.
6.1 08-10-2014
  • Thêm phương thức getLocation() vào com.google.android.gms.ads.MediationAdRequest.
  • Thêm phần mô tả nội dung vào nút đóng quảng cáo xen kẽ để hỗ trợ tiếp cận.
  • Xoá tính năng 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 đúng cách.
  • Đã 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 hiện đang hiển thị quảng cáo.
5 25-06-2014
  • Đã 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 bằng cách sử dụng API Google Play Billing.
4,4 07-05-2014
  • Đã thêm API bộ chuyển đổi dàn xếp mới.
  • Thêm định dạng quảng cáo LARGE_BANNER 320x100 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 Giao dịch mua hàng trong ứng dụng. Đặt một InAppPurchaseListener trên InterstitialAd để theo dõi các sự kiện mua hàng trong ứng dụng.
  • Sửa lỗi cho sự cố SecurityException do đọc gservices khi chưa được phép.
4,3 17-03-2014
  • InterstitialAd hiện hoạt động nếu được truyền một ngữ cảnh ứng dụng.
  • Thêm phương thức setContentUrl() vào PublisherAdRequest.Builder.
  • Đã khắc phục cho trường hợp ngoại lệ khi Dịch vụ không được đăng ký.
4,2 03-02-2014 Nhiều bản sửa lỗi.
4.1 16-01-2014
  • Đã thêm tùy chọn hỗ trợ cho Ad Manager và Quảng cáo đi kèm kết quả tìm kiếm cho ứng dụng dành cho thiết bị di động.
  • AdRequest.Builder hiện có một phương thức setLocation().
  • Khắc phục sự cố xảy ra nếu quảng cáo xen kẽ được yêu cầu nhưng AdActivity không được chỉ định trong tệp kê khai.
4 31-10-2013
  • API Quảng cáo trên thiết bị di động của Google 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 đối với API Quảng cáo của Google trên thiết bị di động sẽ tự động được đẩy tới các thiết bị thông qua Dịch vụ Google Play.
  • Ad Manager và Quảng cáo đi kèm kết quả tìm kiếm cho ứng dụng dành cho thiết bị di động chưa được hỗ trợ.