Ghi chú phát hành

Phiên bản Ngày phát hành Ghi chú
23.4.0 30/09/2024
  • Giờ đây, các lỗi tải quảng cáo sẽ gọi ra một thông báo logcat cho biết 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 ngụ ý sự cố. Hãy tham khảo bài viết Gỡ lỗi thông báo 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 gặp lỗi lặp lại liên quan đến việc phân phát quảng cáo không được ghi nhận, hãy chia sẻ dấu vết ngăn xếp với Hỗ trợ SDK quảng cáo trên thiết bị di động.
  • 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 vào AdView.isCollapsible() để cho biết liệu biểu ngữ được tải gần đây nhất có thể thu gọn được 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: loadNativeAd đã ngừng hoạt động và loadRtbNativeAd() để ưu tiên 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 và đối tượng liên quan này.
23.0.0 7/3/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, liên kết ứng dụng AdMob với Firebase và tích hợp ứng dụng Google Analytics cho Firebase SDK vào ứng dụng của bạn.
    • 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 boolean về việc liệu tính năng kiểm soát liên tục có thành công hay không.
    • Native Ads:
      • Đã xoá AdLoader.forUnifiedNativeAd(). Sử dụng Hãy AdLoader.forNativeAd().
      • Đã xoá AdLoader.forCustomTemplateAd(). Sử dụng Hãy 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 truyền một định dạng quảng cáo.
    • AdManagerAdRequest.Builder phương thức được kế thừa từ thành phần mẹ hiện có thể được liên kết với nhau để tạo một đối tượng chỉ từ một lệnh gọi. Đ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 cho quảng cáo trong Thẻ tuỳ chỉnh. Hãy xem phần 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
  • Ngừng sử dụng MobileAds.setSameAppKeyEnabled() và đổi tên phương thức thành MobileAds.putPublisherFirstPartyIdEnabled().
  • Không dùng AdFormat.UNKNOWN nữa mà không có lựa chọn thay thế. Chiến dịch Quảng cáo ứng dụng sử dụng QueryInfo.generate() phải chuyển định dạng quảng cáo.
22.5.0 30/10/2023
22.4.0 13/09/2023
  • Yêu cầu compileSdkVersion tối thiểu là 33.
  • 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ô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ư của Attribution Reporting Beta và Topics Beta. Hãy xem hướng dẫn về Ad Manager 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
22.2.0 5/7/2023
22.1.0 18/05/2023
  • Công cụ kiểm tra quảng cáo: Cho phép khả năng 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 các 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() và Đã thay đổi Adapter.getSDKVersionInfo() từ loại com.google.android.gms.ads.mediation.VersionInfo đến com.google.android.gms.ads.VersionInfo. Bạn nên bộ chuyển đổi sẽ trả về loại mới kể từ khi com.google.android.gms.ads.mediation.VersionInfo là không dùng nữa.
21.5.0 31/01/2023
  • Quảng cáo khi mở ứng dụng: AppOpenAd.load() đã ngừng hoạt động các phương thức chấp nhận tham số nhập hướng và thêm các phương thức mới không lấy phương thức 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, khớ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 bạn đang sử dụng Gradle phiên bản cũ hơn 7.2.0 và yêu cầu quyền cho ứng dụng của bạn, bạn có thể cần 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 đối với tất cả ứng dụng Ad Manager và yêu cầu đị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 tính 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.
  • Thêm 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 phù hợp và được cá nhân hoá 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: Thêm 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ính năng hỗ trợ kiếm tiền từ quảng cáo trong WebView. Hãy xem phần Tích hợp API WebView 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 25/5/2022
  • Thay đổi có thể gây lỗi:
    • SDK quảng cáo trên thiết bị di động của Google hiện yêu cầu tất cả ứng dụng phải có API Android cấp 19 trở lên để 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.
    • 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 định vị sau:
      • setLocation() trên AdRequest.Builder
      • getLocation() trên AdRequest
      • getLocation() trên 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(). Sử dụng MobileAds.getVersion() thay thế.
  • Thêm phương thức getLoadedAdapterResponseInfo() trong ResponseInfo.
  • Đã thêm các phương thức sau trong 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
  • Thêm tính năng hỗ trợ cho các thiết bị Android 12 dành cho ứng dụng nhắm đến API 31.
  • Đã thêm tùy chọn 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à phòng chống gian lận.
20.4.0 22/09/2021
  • Kể từ phiên bản 20.4.0, SDK quảng cáo trên thiết bị di động của Google sẽ đưa quyền com.google.android.gms.permission.AD_ID vào tệp kê khai của SDK. Tệp này sẽ tự động hợp nhất vào tệp kê khai ứng dụng bằng các công cụ bản dựng Android. Để tìm hiểu thêm về tính năng 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 trang 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 08/06/2021
  • Thêm tính năng hỗ trợ công cụ kiểm tra quảng cáo (Bản thử nghiệm) cho nhà xuất bản Google Ad Manager.
20.1.0 29/4/2021
20.0.0 5/4/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ố là 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 có tên là NativeAd.
    • RewardedAd hiện là 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.
  • Ngừng sử dụng AdSize.SMART_BANNER và thay vào đó là 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ả các API công khai.
19.8.0 15/03/2021
  • Thêm 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.
  • 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 sẽ triển khai Lớp Adapter đến 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 Định dạng dành riêng cho RTB.
19.7.0 20/1/2021
  • Các 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ỏ 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 phiên bản 20.0.0 hướng dẫn di chuyển để biết thêm chi tiết.
19.6.0 4/12/2020
  • Ngừng sử dụng phương thức onAdLeftApplication() AdListener.
  • Khắc phục lỗi người dùng trên 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
19.4.0 10/9/2020
  • Thêm tính năng hỗ trợ cho các thiết bị Android 11 dành cho ứ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 định dạng toàn màn hình hơn là chế độ xem biểu ngữ. Đã thêm Phương thức getResponseInfo() và show() đến AppOpenAd. Không dùng nữa 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 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.
  • Thêm định dạng RewardedInterstitialAd, hiện đang ở giai đoạn thử nghiệm beta riêng tư.
  • Khắc phục lỗi MobileAds.initialize() chỉ gọi lại trình xử lý hoàn tất một lần. Mọi cuộc gọi đến MobileAds.initialize() hiện 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() và getCause() vào AdError.
  • Thêm lệnh gọi lại mới về lỗi tải vào tất cả định dạng quảng cáo trả về một LoadAdError. Ví dụ: onAdFailedToLoad(LoadAdError).
  • Các lệnh gọi lại lỗi tải không dùng nữa trả về một int. 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 MEDIATION_SHOW_ERROR mã lỗi trình bày. Tất cả lỗi trình bày liên quan đến quảng cáo được dàn xếp hiện sẽ trả về MEDIATION_SHOW_ERROR cho AdError.getCode() và AdError.getCause() NonNull đại diện cho lỗi dàn xếp cơ bản.
19.2.0 18/06/2020
  • 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 trên các yêu cầu kiểm thử để giúp bạn phát hiện và khắc phục các lỗi vi phạm chính sách về quảng cáo gốc.
  • Đã thêm MobileAds.disableMediationAdapterInitialization() . Hãy gọi phương thức này trước khi khởi chạy SDK Quảng cáo của Google trên thiết bị di động để 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/3/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 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ề một quảng cáo được tải.
  • Đối với tất cả các định dạng quảng cáo, getMediationAdapterClassName() không dùng nữa ủng hộ getResponseInfo().
  • Quảng cáo gốc: Đã thêm getDuration() và getCurrentTime() đến 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.
  • Không được chấp nhận AdRequest.Builder.addTestDevice(). Sử dụng Hãy RequestConfiguration.Builder.setTestDeviceIds().
18.3.0 5/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 ở giai đoạn thử nghiệm beta riêng tư. 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() đến AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize().
  • Dàn xếp: SDK quảng cáo của Google trên thiết bị di động 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 nếu nhiều quảng cáo có tặng thưởng được dàn xếp được lưu vào bộ nhớ đệm, thì chỉ một quảng cáo sẽ hiển thị.
  • Thêm phương thức setTestDeviceIds() để cho phép thiết lập thiết bị thử nghiệm một lần cho tất cả cá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 có trong phiên bả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.
18.1.1 23/7/2019
  • Dàn xếp: Trình 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 SDK quảng cáo trên thiết bị di động của Google hiện được phát hiện và xử lý bằng SDK quảng cáo trên thiết bị di động của Google.
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.
  • 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 của Google trên thiết bị di động và tất cả các quảng cáo đã định cấu hình bộ chuyển đổi dàn xếp đã 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 phương thức setImageOrientation() hiện không 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 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 qua URL có thể nhận được nội dung nghe nhìn của quảng cáo nội dung, cung cấp hình ảnh cho nội dung đó và gọi MediaView.setMediaContent() để điền dữ liệu hình ảnh đến MediaView đối với quảng cáo không phải dạng video.
  • Quảng cáo gốc: Thêm các API để bật dịch vụ hỗ trợ tiêu chuẩn Đo lường mở cho định dạng quảng cáo gốc tuỳ chỉnh không phải 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 thông qua UnifiedNativeAdMapper.setMediaContentAspectRatio().
  • Xoá lớp Correlator và các API liên kết. Tính năng này trước đây không hoạt động.
  • Đã thêm các phần phụ thuộc trên play-services-measurement và play-services-measurement-sdk. Ứng dụng không còn nữa bạn cần thêm các phần phụ thuộc này một cách rõ ràng.
18.0.0 17/6/2019
  • Di chuyển từ Thư viện hỗ trợ Android sang Jetpack (AndroidX) Thư viện. 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 11/3/2019
  • Video có tặng thưởng: Thêm một bộ API có tặng thưởng mới (xem gói rewarded) 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 hỗ trợ khởi tạo. 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 31-01-2019
  • 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 03-12-2018
  • Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.1.2 của mọi thư viện quảng cá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-ads & firebase-analytics (ví dụ: ads:17.1.0 và analytics:16.0.5) đã dẫn đến duplicate entry lỗi trình biên dịch. Nhà xuất bản sử dụng firebase-analytics cùng với phiên bản 17.1.1 của mọi thư viện quảng cá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
  • Google Ad Manager nhà xuất bản bắt buộc phải chỉ định một Thẻ <meta-data> có khoá com.google.android.gms.ads.AD_MANAGER_APP trong tệp AndroidManifest.xml của họ. Hãy tham khảo Hướng dẫn bắt đầu để biết thêm thông tin.
  • 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. Tham khảo Quảng cáo gốc Advanced Unified để đượ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 lành tính: "UnconfirmedClickListener không được có giá trị rỗng trong khi đặt ClickConfirmingView" đã 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ẽ huỷ bỏ chuỗi trình nghe.
  • Ngừng sử dụng các phương thức sau đây trên AdRequest.Builder.
  • Khắc phục lỗi không kích hoạt onRewardedVideoCompleted() các trình mô phỏng.
16.0.0 2/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
  • Phiên bản beta MRAID v3.
  • 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 vô hại hiển thị 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 bộ." 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 28-03-2018
  • Không có thay đổi nào về quảng cáo. Xem ghi chú phát hành của Dịch vụ Google Play để biết thêm chi tiết.
12.0.0 20-03-2018
  • Video có tặng thưởng: Đã thêm onRewardedVideoCompleted() phương thức gọi lại đến RewardedVideoAdListener.
  • Dàn xếp gốc: Thêm phương thức trackViews() vào NativeAdMapper, cấp cho các bộ chuyển đổi quyền 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 18/12/2017
  • Sửa lỗi và cải tiến chung.
11.6.0 7/11/2017
  • Thêm lớp NativeAdViewHolder và các phương thức liên quan trong NativeAppInstallAd và NativeContentAd.
  • Không dùng nữa AdLoader.getMediationAdapterClassName (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).
  • Giờ đây, quảng cáo thử nghiệm sẽ hiển thị nhãn ở trên cùng của 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 các phương thức getMediationAdapterClassName() vào phần tử Lớp NativeAppInstallAd và NativeContentAd. Phương thức có cùng tên trong AdLoader sẽ không được dùng nữa.
  • Đã thêm một onVideoEnd() vào MediationNativeListener lớp, hasVideoContent(), setHasVideoContent() và setMediaView() cho lớp NativeAdMapper, và getAdVolume() và isAdMuted() cho 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 nhận đối tượng PublisherAdRequest vào lớp RewardedVideoAd.
11.2.0 14/8/2017
  • 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 chỉ 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 trên thiết bị di động của Google, build.gradle của ứng dụng cũng phải được cập nhật để chỉ định compileSdkVersion từ 26 trở lên (Android O). Việc 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 cập nhật targetSdkVersion.
  • Kể từ phiên bản 11.2.0, SDK Quảng cáo của Google trên thiết bị di động có sẵn thông qua Kho lưu trữ Maven của Google. Để biết thêm thông tin, hãy xem Dịch vụ Google Play ghi chú phát hành.
11.0.0 07-06-2017
  • Đã thêm 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.
  • Đã xoá getInAppPurchaseListener() và setInAppPurchaseListener() phương thức từ AdView, InterstitialAd, và NativeExpressAdView. Cũng đã xóa mục trong ứng dụng có liên quan mua hàng.
  • 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ế độ chìm đắm 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 gốc kèm biểu ngữ.
  • Thêm OnImmersiveModeUpdatedListener (không bắt buộc) giao diện mà các bộ chuyển đổi dàn xếp có thể triển khai để nhận thông báo về chế độ hiển thị tối đa bản cập nhật.
  • Thêm phương thức getMediationAdapterClassName() vào phần tử Lớp RewardedVideoAd.
  • Đã thêm keep quy tắc để tự động duy trì bộ chuyển đổi dàn xếp tên lớ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 bao gồm hỗ trợ đầy đủ cho Android phiên bản 2.3.x (Gingerbread). Ứ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 cấp độ API Android tối thiểu là 14 và không thể cài đặt trên thiết bị chạy API cấp thấp hơn 14. Để tìm hiểu thêm về các lựa chọn của bạn, bao gồm 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ính năng hỗ trợ cho thành phần video cho nội dung Quảng cáo gốc nâng cao và quảng cáo mẫu tuỳ 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 getAdChoicesContent() và setAdChoicesContent() phương thức vào NativeAdMapper.
  • Đã thêm InitializableMediationRewardedVideoAdAdapter giao diện 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 Ads Người quản lý.
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) đã không còn được sử dụng nữa. Nhà xuất bản Google Ad Manager nên gọi phương thức này khi khởi tạo ứ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ã ứng dụng của họ.
9.6.0 22/9/2016
  • Đã thêm MediaView cho Quảng cáo gốc nâng cao dạng video.
  • Đã thêm Phương thức openDebugMenu() cho MobileAds để xem trước mẫu quảng cáo và khắc phục sự cố của đơn vị quảng cáo Ad Manager.
  • Thêm tính năng hỗ trợ cho các sự kiện tuỳ 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 setAdChoicesPlacement() cho NativeAdOptions.Builder mà nhà xuất bản ứng dụng hiện có thể dùng để chỉ định vị trí trong 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 bằng một số bản sửa lỗi.
9.0.1 26-05-2016
  • Khắc phục vấn đề ProGuard xuất hiện trong phiên bản 9.0.0. Nhà xuất bản không còn cần tuỳ chọn keep cho com.google.android.gms.common.util.DynamiteApi.
9.0.0 18/5/2016
  • Đã thêm tự động điền thông tin vị trí đối với 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ính năng hỗ trợ cho các sự kiện tuỳ 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 không đượ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ộ điều hợp 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ý ứ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 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 ứ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ù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 PublisherAdView và PublisherInterstitialAd để 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.Builder và PublisherAdRequest.Builder.
  • Thêm phương thức destroy() vào NativeAdView.
8.1.0 24/9/2015 Đã khắc phục nhiều lỗi khác nhau.
7.8.0 13/8/2015
  • Phiên bản phát hành chính thức MRAID phiên bản 2.
  • Thêm một phương thức isLoading() vào AdLoader thân mến! AdView, và InterstitialAd để 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(). Thay vào đó, hãy sử dụng PublisherAdView#setManualImpressionsEnabled().
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ính năng hỗ trợ cho các định dạng quảng cáo gốc tuỳ chỉnh, có sẵn cho các lượt đặt trước trên Ad Manager.
7.3.0 28/4/2015 Đã khắc phục nhiều lỗi khác nhau.
7.0.0 19-03-2015
  • Thêm các phương thức addCustomTargeting() và addCategoryExclusion() vào PublisherAdRequest.Builder.
  • Khắc phục sự cố 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 số lượt hiển thị theo cách thủ công.
  • Khắc phục vấn đề khiến quảng cáo hiển thị không chính xác 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. Phương thức này nên được dùng để biểu thị nguồn yêu cầu quảng cáo của bên thứ ba dàn xếp với SDK quảng cáo trên thiết bị di động.
6.5.87 08-12-2014
  • Giới thiệu kiến ​​trúc JAR chia nhỏ--Giờ đây, nhà phát triển Android Studio có thể chỉ cần bao gồ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 ý: Ứng dụng tạo quảng cáo biểu ngữ trong XML vẫn phải tham chiếu toàn bộ thư viện com.google.android.gms:play‑services:6.+.
  • Đã khắc phục nhiều lỗi khác nhau.
6.1 8/10/2014
  • 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.
  • Xoá 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 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 giao dịch Mua hàng trong ứng dụng bằng API Google Play Billing.
4,4 7/5/2014
  • Thêm các API Trình 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 để nghe cho các sự kiện mua hàng trong ứng dụng.
  • Bản sửa lỗi cho sự cố SecurityException do đọc gservices khi chưa được cho phép.
4,3 17/3/2014
  • 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 cho trường hợp ngoại lệ khi Dịch vụ chưa được đăng ký.
4,2 3/2/2014 Đã khắc phục nhiều lỗi khác nhau.
4.1 16-01-2014
  • Thêm tính năng 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ó 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 Chưa chỉ định AdActivity trong tệp kê khai.
4 31-10-2013
  • API Google Ads cho thiết bị di động 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 Google Mobile Ads sẽ tự động được đẩy đến các thiết bị thông qua Dịch vụ Google Play.
  • Chưa hỗ trợ 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.