Một số công nghệ Hộp cát về quyền riêng tư đang được loại bỏ dần.

Xem Thông tin cập nhật về kế hoạch cho các công nghệ của Hộp cát về quyền riêng tư.

Trạng thái tính năng Hộp cát về quyền riêng tư cung cấp thêm thông tin về trạng thái của từng API và tính năng nền tảng.

Trang này được dịch bởi Cloud Translation API.

Xác định dữ liệu đối tượng

Tìm hiểu cách xác định đối tượng bằng cách tạo một nhóm đối tượng có cùng mối quan tâm bằng Protected Audience API. Hãy đọc hướng dẫn dành cho nhà phát triển để biết toàn bộ vòng đời của Protected Audience API, đồng thời tham khảo tài liệu giải thích về Protected Audience API để biết đề xuất chi tiết về cách trình duyệt ghi lại các nhóm quan tâm.

Bạn không phải là nhà phát triển? Hãy tham khảo Tổng quan về Protected Audience API.

Nhóm đối tượng có cùng mối quan tâm trong Protected Audience API

Một nhóm mối quan tâm Protected Audience API đại diện cho một nhóm người có chung mối quan tâm, tương ứng với một danh sách tái tiếp thị. Mỗi nhóm đối tượng có cùng mối quan tâm Protected Audience API đều có một chủ sở hữu.

Chủ sở hữu nhóm đối tượng có cùng mối quan tâm đóng vai trò là người mua trong phiên đấu giá quảng cáo Protected Audience API. Trình duyệt sẽ lưu trữ thông tin về việc tham gia nhóm đối tượng có cùng mối quan tâm trên thiết bị của người dùng và không chia sẻ với nhà cung cấp trình duyệt hoặc bất kỳ ai khác.

Các hàm API

`joinAdInterestGroup()`

Nền tảng bên cầu (DSP) của nhà quảng cáo hoặc chính nhà quảng cáo đó gọi navigator.joinAdInterestGroup() để yêu cầu trình duyệt thêm một nhóm đối tượng có cùng mối quan tâm vào danh sách thành viên của trình duyệt.

Nguồn gốc của ngữ cảnh gọi cho joinAdInterestGroup() phải khớp với nguồn gốc của chủ sở hữu nhóm đối tượng có cùng mối quan tâm, vì vậy, joinAdInterestGroup() sẽ cần được gọi từ một iframe (ví dụ: từ một DSP) trừ phi nguồn gốc của chủ sở hữu nhóm đối tượng có cùng mối quan tâm khớp với nguồn gốc của tài liệu hiện tại (ví dụ: một trang web có các nhóm đối tượng có cùng mối quan tâm riêng).

joinAdInterestGroup() yêu cầu quyền của:

Trang web đang được truy cập
Chủ sở hữu nhóm đối tượng có cùng mối quan tâm

Điều này có nghĩa là malicious.example không thể gọi joinAdInterestGroup() cho một nhóm mối quan tâm thuộc sở hữu của dsp.example.com mà không có sự cho phép của dsp.example.com.

Quyền của trang web đã truy cập

Bạn có thể cấp quyền từ cùng nguồn gốc hoặc nhiều nguồn gốc. Theo mặc định, quyền được cấp cho các lệnh gọi joinAdInterestGroup() từ cùng một nguồn gốc với trang web đã truy cập (nói cách khác, từ cùng một nguồn gốc với khung cấp cao nhất của trang hiện tại).

Ví dụ về cách sử dụng

Dưới đây là ví dụ về cách xác định một nhóm đối tượng có cùng mối quan tâm và yêu cầu trình duyệt tham gia nhóm đó.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Đối tượng interestGroup được truyền đến hàm không được có kích thước quá 50 kiB, nếu không lệnh gọi sẽ không thành công. Tham số thứ hai chỉ định thời lượng của nhóm lợi ích, tối đa là 30 ngày. Các lệnh gọi liên tiếp sẽ ghi đè các giá trị đã lưu trữ trước đó.

Điểm mấu chốt: Tất cả URL được dùng làm tham số cho các phương thức Protected Audience API phải có nguồn gốc bảo mật: tất cả tài nguyên phải được phân phát qua URL HTTPS. Cách sử dụng HTTPS cho quá trình phát triển cục bộ giải thích cách thực hiện việc này khi chạy Protected Audience API cục bộ. Ngoài ra, biddingLogicUrl, decisionLogicUrl và trustedBiddingSignals yêu cầu tiêu đề phản hồi HTTP X-Allow-FLEDGE: true.

Thuộc tính bắt buộc

Các thuộc tính bắt buộc duy nhất đối với nhóm mối quan tâm là owner và name:

Thuộc tính	Ví dụ:	Vai trò
`owner`	`https://dsp.example`	Nguồn gốc của chủ sở hữu nhóm đối tượng có cùng mối quan tâm.
`name`	`custom-bikes`	Tên của nhóm sở thích.

Thuộc tính tuỳ chọn

Các thuộc tính còn lại là không bắt buộc:

biddingLogicUrl^{1, 2}: Ví dụ: https://dsp.example/bid/custom-bikes/bid.js; Vai trò: URL cho JavaScript đặt giá thầu chạy trong worklet.
biddingWasmHelperUrl^{1, 2}: Ví dụ: https://dsp.example/bid/custom-bikes/bid.wasm; Vai trò: URL cho mã WebAssembly được điều khiển từ biddingLogicUrl.
updateUrl²: Ví dụ: https://dsp.example/bid/custom-bikes/update; Vai trò: URL trả về JSON để cập nhật các thuộc tính của nhóm mối quan tâm. (Xem phần Cập nhật dữ liệu về đối tượng và làm mới quảng cáo.)
trustedBiddingSignalsUrl²: Ví dụ: https://dsp.example/trusted/bidding-signals; Vai trò: URL cơ sở cho các yêu cầu khoá-giá trị đối với dịch vụ Khoá/Giá trị đáng tin cậy của bên đặt giá thầu.
trustedBiddingSignalsKeys: Ví dụ: ['key1', 'key2' ...]; Vai trò: Khoá cho các yêu cầu đối với dịch vụ Khoá/Giá trị đáng tin cậy.
userBiddingSignals: Ví dụ: {...}; Vai trò: Siêu dữ liệu bổ sung mà chủ sở hữu có thể sử dụng trong quá trình đặt giá thầu.
ads¹: Ví dụ: [bikeAd1, bikeAd2, bikeAd3]; Vai trò: Quảng cáo có thể được hiển thị cho nhóm mối quan tâm này.
adComponents: Ví dụ: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]; Vai trò: Các thành phần cho quảng cáo bao gồm nhiều phần.

¹ Thuộc tính biddingLogicUrl và ads là không bắt buộc, nhưng bạn phải sử dụng để tham gia một phiên đấu giá. Có thể có các trường hợp sử dụng để tạo một nhóm mối quan tâm mà không có các thuộc tính này: ví dụ: chủ sở hữu nhóm mối quan tâm có thể muốn thêm một trình duyệt vào một nhóm mối quan tâm cho một chiến dịch chưa chạy hoặc cho một số mục đích sử dụng khác trong tương lai, hoặc họ có thể tạm thời hết ngân sách quảng cáo.

² Trong quá trình triển khai Protected Audience API hiện tại, biddingLogicUrl, biddingWasmHelperUrl, updateUrl và trustedBiddingSignalsUrl phải có cùng nguồn gốc với chủ sở hữu. Đây có thể không phải là một hạn chế lâu dài và URL ads và adComponents không có hạn chế như vậy.

Chỉ định quảng cáo cho một nhóm đối tượng có cùng mối quan tâm

Các đối tượng ads và adComponents bao gồm một URL cho mẫu quảng cáo và siêu dữ liệu tuỳ ý (không bắt buộc) có thể được dùng tại thời điểm đặt giá thầu.

Ví dụ:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

`leaveAdInterestGroup()`

Chủ sở hữu nhóm lợi ích có thể yêu cầu trình duyệt xoá một nhóm lợi ích. Trình duyệt sẽ xoá nhóm mối quan tâm khỏi danh sách thành viên.

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

Nếu người dùng quay lại trang web đã yêu cầu trình duyệt thêm một nhóm đối tượng có cùng mối quan tâm, thì chủ sở hữu nhóm đối tượng có cùng mối quan tâm có thể gọi hàm navigator.leaveAdInterestGroup() để yêu cầu trình duyệt xoá nhóm đối tượng có cùng mối quan tâm đó.

Mã của một quảng cáo cũng có thể gọi hàm này cho nhóm mối quan tâm của quảng cáo đó.

Câu hỏi thường gặp

Số lượng tối đa nhóm mối quan tâm cho mỗi chủ sở hữu nhóm đối với một người dùng là bao nhiêu?

Chrome cho phép tối đa 1.000 nhóm đối tượng có cùng mối quan tâm cho mỗi chủ sở hữu và tối đa 1.000 chủ sở hữu nhóm đối tượng có cùng mối quan tâm. Các giới hạn này được đặt ra để làm biện pháp bảo vệ, không phải để đạt được trong quá trình hoạt động thường xuyên.

Làm cách nào để tối đa hoá quảng cáo dựa trên nhóm lợi ích đáp ứng ngưỡng 𝑘-ẩn danh?

Như giải thích công khai, vì một nhóm lợi ích có thể mang nhiều quảng cáo có thể xuất hiện, nên nhóm này sẽ có cơ hội đặt giá thầu lại cho một quảng cáo khác để đóng vai trò là "quảng cáo dự phòng" bất cứ khi nào lựa chọn được ưu tiên nhất của nhóm thấp hơn ngưỡng. Điều này có nghĩa là một quảng cáo nhỏ, chuyên biệt vẫn dưới ngưỡng ẩn danh k vẫn có thể chọn tham gia đấu giá và nhóm lợi ích của quảng cáo đó có thể quay lại một quảng cáo chung chung hơn cho đến khi quảng cáo chuyên biệt hơn có đủ đối tượng.

Về mặt chiến thuật, bạn có thể cân nhắc những điều sau:

Để quảng cáo mới bắt đầu hiển thị, bạn chỉ cần bắt đầu đặt giá thầu cho quảng cáo đó trong trường hợp bạn muốn quảng cáo hiển thị. Bạn không cần làm gì thêm.
Bạn có thể có một quảng cáo dự phòng để sử dụng khi quảng cáo mới không phải là 𝑘-anon. Có một số rủi ro là quảng cáo dự phòng của bạn không phải là 𝑘-anon, vì vậy, đôi khi bạn có thể chỉ đặt giá thầu bằng quảng cáo dự phòng ngay từ đầu. Có lẽ bạn nên thực hiện việc này 1% thời gian, ví dụ: nếu đó là một mức phù hợp để đảm bảo rằng bạn dự kiến giá trị dự phòng sẽ duy trì ở trên ngưỡng.

Gần đây, đã có một số cuộc thảo luận về những cách khác mà mọi thứ có thể hoạt động. Vì vậy, nếu bạn có trường hợp sử dụng mà cơ chế này sẽ gây ra vấn đề, hãy tiếp tục tham gia cuộc trò chuyện công khai về những cách mà API có thể cải thiện.

Tất cả tài liệu tham khảo về Protected Audience API

Hướng dẫn tham khảo API có sẵn:

Hướng dẫn dành cho nhà phát triển về Protected Audience API.
Hướng dẫn cho người mua quảng cáo về các nhóm mối quan tâm và cách tạo giá thầu trong Protected Audience.
Hướng dẫn dành cho người bán quảng cáo về phiên đấu giá quảng cáo trong Protected Audience.
Hướng dẫn báo cáo kết quả phiên đấu giá
Các phương pháp hay nhất cho độ trễ của phiên đấu giá quảng cáo trong Protected Audience
Khắc phục sự cố với Protected Audience

Thông tin giải thích về Protected Audience API cũng cung cấp thông tin chi tiết về các quy tắc hỗ trợ và các quy tắc ràng buộc của tính năng.

Xác định dữ liệu đối tượng Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.