privacysandbox ads

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên privacysandbox-ads, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc phần Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.1

Phiên bản 1.1.0-beta12

Ngày 12 tháng 3 năm 2025

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12. Phiên bản 1.1.0-beta12 bao gồm các thay đổi sau.

Tính năng mới

• Mức độ ưu tiên của đối tượng tuỳ chỉnh: Chúng tôi đã thêm trường mức độ ưu tiên trong đối tượng tuỳ chỉnh. Điều này cho phép người mua chỉ định một giá trị mức độ ưu tiên trong CustomAudience. Giá trị này sẽ được dùng để xác định đối tượng tuỳ chỉnh sẽ có trong phiên đấu giá nếu tập hợp đối tượng tuỳ chỉnh của người mua vượt quá giới hạn kích thước trên mỗi người mua
• Cấu hình của người bán: Tính năng này cho phép người bán xác định các tham số đấu giá để kiểm soát kích thước tải trọng và người tham gia phiên đấu giá. Cấu hình phiên đấu giá của người bán sẽ cho phép người bán chỉ định:
  • Danh sách người mua được phép
  • Đối với các phiên đấu giá do người bán nhất định khởi tạo, chỉ những người mua trong danh sách cho phép mới có thể đóng góp CustomAudiences cho phiên đấu giá
  • Giới hạn kích thước trên mỗi người mua
  • Người bán có thể chỉ định giới hạn trên mỗi người mua để điều chỉnh kích thước dữ liệu mà mỗi người mua tải lên trong tải trọng đang được gửi đến SellerFrontendService. Nếu người mua vượt quá giới hạn kích thước trên mỗi người mua, mức độ ưu tiên CustomAudience được đặt trong cấu hình tải trọng của người mua sẽ được dùng để lấy dữ liệu trong các giới hạn dự kiến.
  • Giới hạn kích thước tối đa cho tải trọng
  • Mỗi người bán có thể có một mức phân bổ tài nguyên riêng và họ có thể muốn đặt giới hạn kích thước tối đa cho tải trọng phiên đấu giá theo yêu cầu. Giới hạn kích thước tối đa sẽ tuân theo nhóm kích thước cố định do API ProtectedAudience đặt ra.
• Cập nhật đối tượng tuỳ chỉnh bị trì hoãn: Tính năng này cho phép người mua lên lịch cập nhật bị trì hoãn cho Đối tượng tuỳ chỉnh. Mỗi yêu cầu cập nhật cho phép phương thức gọi lên lịch cập nhật bị trì hoãn bằng API scheduleCustomAudienceUpdate() mới. Đối với mỗi lần cập nhật, người dùng có thể chỉ định các nhóm Đối tượng tuỳ chỉnh để tham gia hoặc rời khỏi.

Thay đổi về API

• Thêm Cấu hình người bán trong API GetAdSelectionRequest (Ibb5c7)
• Giới thiệu API ScheduleCustomAudienceUpdate dưới dạng thử nghiệm (I6b905)

Phiên bản 1.1.0-beta11

Ngày 30 tháng 10 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11. Phiên bản 1.1.0-beta11 bao gồm các thay đổi sau.

Tính năng mới

• Bản cập nhật này sẽ xoá tính năng hỗ trợ đo lường hộp cát về quyền riêng tư và API adid trên Android R (hiện không còn được dùng nữa). Giờ đây, các lệnh gọi để lấy các lớp trình quản lý trên Android R sẽ trả về giá trị rỗng.

Phiên bản 1.1.0-beta10

Ngày 21 tháng 8 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10. Phiên bản 1.1.0-beta10 bao gồm các thay đổi sau.

Thay đổi về API

• Thêm các phương thức nạp chồng hàm khởi tạo Java bị thiếu cho API Thử nghiệm GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest và FetchAndJoinCustomAudienceRequest. (I19e7f)

Phiên bản 1.1.0-beta09

Ngày 10 tháng 7 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09. Phiên bản 1.1.0-beta09 bao gồm các thay đổi sau.

Thay đổi về API

• Thêm các phương thức nạp chồng hàm khởi tạo Java bị thiếu cho API thử nghiệm GetAdSelectionDataRequest. (Ifbf88).

Phiên bản 1.1.0-beta08

Ngày 26 tháng 6 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08. Phiên bản 1.1.0-beta08 bao gồm các thay đổi sau.

Tính năng mới

• Thêm tính năng hỗ trợ cho các tín hiệu ứng dụng được bảo vệ.
• Hỗ trợ nhiều nhà cung cấp dịch vụ đám mây cho phiên đấu giá phía máy chủ B&A.

Thay đổi về API

• API thử nghiệm GetAdSelectionDataRequest::seller không được rỗng. (I68044)
• Thêm API thử nghiệm GetAdSelectionDataRequest::coordinatorOriginUri. (I18c0b)
• Thêm API updateSignals. (Ia8512)

Phiên bản 1.1.0-beta07

Ngày 14 tháng 5 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07. Phiên bản 1.1.0-beta07 bao gồm các thay đổi sau.

Tính năng mới

• GetTopics hiện hỗ trợ các phản hồi đã mã hoá trong GetTopicsResponse.

Thay đổi về API

• Thêm EncryptedTopic vào lớp GetTopicResponse. (Iab362)

Phiên bản 1.1.0-beta06

Ngày 17 tháng 4 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06. Phiên bản 1.1.0-beta06 bao gồm các thay đổi sau.

Lưu ý

• Kể từ bản phát hành jetpack privacysandbox-ads 1.1.0-beta06, tất cả thiết bị Android R bật cờ sẽ có thể truy cập vào PPAPI. Đối với mọi trường hợp sử dụng không hỗ trợ Android R, bạn sẽ cần thêm các trình bảo vệ trong mã bằng cách sử dụng mã jetpack privacysandbox-ads.

Tính năng mới

• Hỗ trợ khả năng tương thích ngược cho Android R.

Phiên bản 1.1.0-beta05

Ngày 3 tháng 4 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05. Phiên bản 1.1.0-beta05 bao gồm các thay đổi sau.

Sửa lỗi

• Thêm tính năng phát hiện lỗi khi không tìm thấy định nghĩa lớp trên thiết bị Android S do thiếu thẻ uses-library trong tệp kê khai.

Phiên bản 1.1.0-beta04

Ngày 24 tháng 1 năm 2024

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04. Phiên bản 1.1.0-beta04 bao gồm các thay đổi sau.

Tính năng mới

• API mới để hỗ trợ báo cáo sự kiện của người dùng sau phiên đấu giá
• Hỗ trợ thêm tính năng Lọc giới hạn tần suất cho quảng cáo tái tiếp thị
• Hỗ trợ tính năng uỷ quyền Tham gia đối tượng tuỳ chỉnh
• Hỗ trợ cắt bớt chuỗi dàn xếp kiểu thác nước
• Hỗ trợ Phiên đấu giá được bảo vệ trên Máy chủ đặt giá thầu và Máy chủ phiên đấu giá

Thay đổi về API

• Giới thiệu API thử nghiệm AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2)
• Giới thiệu API thử nghiệm ReportEventRequest::inputEvent (Ib94f3)
• Đặt ReportImpressionRequest::adSelectionConfig ở chế độ không bắt buộc (Ief280)
• Giới thiệu API thử nghiệm AdSelectionManager::getAdSelectionData và AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
• Giới thiệu API thử nghiệm CustomAudienceManager::fetchAndJoinCustomAudience (I09152)
• Giới thiệu API thử nghiệm AdSelectionManager::reportEvent (I0d7dc)
• Ra mắt API thử nghiệm AdSelectionManager::updateAdCounterHistogram và thay đổi AdData để cho biết một loạt AdFilters (I87b83)

Sửa lỗi

• Giờ đây, URI đầu vào được so khớp trên một trang web/nguồn gốc dùng chung thay vì yêu cầu phải khớp chính xác tên máy chủ.
• Khắc phục lỗi kiểm thử do thiếu lược đồ HTTPS (d573058)
• Khắc phục tình trạng thiếu lược đồ HTTPS trong URL trang web (cecdcb8)
• Thêm chú thích gửi vào các API đo lường (2dba359)

Phiên bản 1.1.0-beta03

Ngày 15 tháng 11 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03. Phiên bản 1.1.0-beta03 bao gồm các thay đổi sau.

Tính năng mới

• Hỗ trợ khả năng tương thích ngược cho Android S.

Phiên bản 1.1.0-beta02

Ngày 4 tháng 10 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02. Phiên bản 1.1.0-beta02 bao gồm các thay đổi sau.

Thay đổi về API

• Xoá tính năng kiểm tra phiên bản T+ khỏi các lớp yêu cầu đo lường. Ứng dụng không cần kiểm tra phiên bản nền tảng T+ để truy cập vào các lớp yêu cầu MeasurementManager của privacysandbox. MeasurementManager sẽ rỗng với hành vi mới. (Ieb105)

Phiên bản 1.1.0-beta01

Ngày 23 tháng 8 năm 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 được phát hành mà không có thay đổi nào. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-alpha01

Ngày 9 tháng 8 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 và androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

• Giới thiệu danh sách registerSource (Iae92f)
• Xoá các trường hợp sử dụng API isAtLeastU() thử nghiệm (Ie9117, b/289269026)

Sửa lỗi

• Hợp nhất các tệp API thử nghiệm và công khai (I15da3, b/278769092)

Phiên bản 1.0

Phiên bản 1.0.0-beta05

Ngày 7 tháng 6 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05. Phiên bản 1.0.0-beta05 bao gồm các thay đổi sau.

Sửa lỗi

• Thêm một quy trình kiểm tra tiện ích sdk 5 vào TopicsManager
• Nâng phần phụ thuộc coroutine Kotlin lên 1.7.1 để ngăn các lỗi bản dựng lớp trùng lặp trong gradle

Phiên bản 1.0.0-beta04

Ngày 10 tháng 5 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04. Phiên bản 1.0.0-beta04 bao gồm các thay đổi sau.

Sửa lỗi

• Giải quyết vấn đề tắc nghẽn khi API đo lường dịch vụ quảng cáo được phương thức gọi gọi trên luồng chính. (I65361)

Phiên bản 1.0.0-beta03

Ngày 19 tháng 4 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03. Phiên bản 1.0.0-beta03 bao gồm các thay đổi sau.

Tính năng mới

• Bật API Xem trước cho Chủ đề.

Phiên bản 1.0.0-beta02

Ngày 22 tháng 3 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02. Phiên bản 1.0.0-beta02 bao gồm các thay đổi sau.

Sửa lỗi

• Bật API MeasurementManager cho Tiện ích SDK phiên bản 5 trở lên.
• Tắt các API MeasurementManager cho Tiện ích SDK phiên bản 4 trở xuống.

Phiên bản 1.0.0-beta01

Ngày 22 tháng 2 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 mà không có thay đổi đáng kể nào. Phiên bản 1.0.0-beta01 được phát hành từ một nhánh nội bộ.

Thay đổi về hành vi

• Tính năng Báo cáo phân bổ đã bị tắt và không dùng được trong bản phát hành này.

Phiên bản 1.0.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 và androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 được phát hành từ một nhánh nội bộ.

• Đây là thư viện Jetpack mới cho phép tích hợp với Privacy Preserving API (API Bảo đảm quyền riêng tư) của Hộp cát về quyền riêng tư (Chủ đề, FLEDGE và Báo cáo phân bổ).
• Privacy Sandbox API (API Hộp cát về quyền riêng tư) của Jetpack có thể dùng để thay thế cho các API Hộp cát về quyền riêng tư được cung cấp trong SDK phần mở rộng 4.