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-beta10"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10"
 
}

dependencies {

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

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

Để 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-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

• Bổ sung tính năng hỗ trợ 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 thể có giá trị 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ợ 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 của privacysandbox-ads 1.1.0-beta06, tất cả thiết bị Android R đã bật cờ sẽ có thể truy cập PPAPI. Đối với bất kỳ trường hợp sử dụng nào không hỗ trợ Android R, cần có các biện pháp bảo vệ bổ sung trong mã sử dụng mã jetpack privacysandbox-ads.

Tính năng mới

• Hỗ trợ khả năng tương thích ngược dành 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 lỗi 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ẻ sử dụng thư viện 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ợ tính năng 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ợ cho 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

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

Sửa lỗi

• URI đầu vào hiện được so khớp trên một trang web/nguồn gốc dùng chung thay vì yêu cầu so khớp chính xác tên máy chủ lưu trữ.
• Khắc phục lỗi kiểm thử không thành công do thiếu giao thức HTTPS (d573058)
• Khắc phục vấn đề thiếu lược đồ HTTPS trong các URL web (cecdcb8)
• Thêm chú giải 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 dành 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á chế độ 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+ ở phía mình để truy cập vào các lớp yêu cầu MeasurementManager của hộp cát về quyền riêng tư. MeasurementManager sẽ có giá trị rỗng do 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

• Ra mắt danh sách registerSource (Iae92f)
• Xoá việc 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 bước kiểm tra tiện ích SDK 5 vào TopicsManager
• Đẩy phần phụ thuộc coroutine Kotlin lên 1.7.1 để ngăn chặ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 phương thức gọi các API đo lường adservices 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 Bản dùng thử 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 các 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.