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 nhóm mối quan tâm bằng Protected Audience API. Hãy đọc hướng dẫn cho nhà phát triển để biết toàn bộ vòng đời của Protected Audience API và tham khảo tài liệu giải thích về Protected Audience API để xem đề xuất chuyên sâu về cách các trình duyệt ghi lại các nhóm mối quan tâm.

Bạn không phải nhà phát triển? Tham khảo tổng quan về Protected Audience API.

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

Nhóm đối tượng có cùng 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 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. Tư cách thành viên của nhóm đối tượng có cùng mối quan tâm được trình duyệt, thiết bị của người dùng lưu trữ và không được 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 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 mối quan tâm. Vì vậy, joinAdInterestGroup() sẽ cần được gọi từ iframe (ví dụ: từ DSP), trừ phi nguồn gốc của chủ sở hữu nhóm 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ó nhóm mối quan tâm riêng).

joinAdInterestGroup() yêu cầu bạn cấp quyền:

Đ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 do dsp.example.com sở hữu khi chưa dsp.example.com cấp quyền.

Quyền từ trang web đã truy cập

Bạn có thể cấp quyền từ cùng một nguồn gốc hoặc nhiều nguồn gốc. Theo mặc định, quyền sẽ được cấp cho các lệnh gọi joinAdInterestGroup() từ cùng nguồn gốc với trang web được truy cập (tức là có cùng 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

Sau đây là ví dụ về cách một người có thể xác định một nhóm 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 vào hàm không được có kích thước không 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 hạn của nhóm mối quan tâm, giới hạn là 30 ngày. Các lệnh gọi tiếp theo sẽ ghi đè các giá trị đã lưu trữ trước đó.

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

Các thuộc tính bắt buộc duy nhất cho 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 mối quan tâm.
name custom-bikes Tên của nhóm mối quan tâm.

Thuộc tính tuỳ chọn

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

biddingLogicUrl1, 2
Ví dụ: https://dsp.example/bid/custom-bikes/bid.js
Vai trò: URL để đặt giá thầu JavaScript chạy trong worklet.
biddingWasmHelperUrl1, 2
Ví dụ: https://dsp.example/bid/custom-bikes/bid.wasm
Vai trò: URL cho mã WebAssembly lấy từ biddingLogicUrl.
updateUrl2
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 bài viết Cập nhật dữ liệu đối tượng và làm mới quảng cáo.)
trustedBiddingSignalsUrl2
Ví dụ: https://dsp.example/trusted/bidding-signals
Vai trò: URL cơ sở cho các yêu cầu khoá-giá trị đến 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 cho khoá-giá trị.
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.
ads1
Ví dụ: [bikeAd1, bikeAd2, bikeAd3]
Vai trò: Quảng cáo có thể hiển thị cho nhóm đối tượng có cùng 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 gồm nhiều phần.

1 Bạn không bắt buộc phải sử dụng thuộc tính biddingLogicUrl và ads để tham gia phiên đấu giá. Có thể có các trường hợp sử dụng việc tạo 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 quan tâm có thể muốn thêm trình duyệt vào nhóm mối quan tâm cho một chiến dịch hiện không 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.

2 Trong quy trình triển khai hiện tại của Protected Audience API, biddingLogicUrl, biddingWasmHelperUrl, updateUrl và trustedBiddingSignalsUrl phải có cùng nguồn gốc với chủ sở hữu. Đó có thể không phải là một quy tắc ràng buộc lâu dài, đồng thời URL ads và adComponents cũng không có quy tắc ràng buộc đó.

Chỉ định quảng cáo cho nhóm sở thích

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

Ví dụ:

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

leaveAdInterestGroup()

Chủ sở hữu nhóm đối tượng có cùng mối quan tâm có thể yêu cầu xoá trình duyệt khỏi nhóm đối tượng có cùng mối quan tâm. Trình duyệt sẽ xoá nhóm đối tượng có cùng 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 nhóm mối quan tâm, thì chủ sở hữu nhóm mối quan tâm đó có thể gọi hàm navigator.leaveAdInterestGroup() để yêu cầu trình duyệt xoá nhóm mối quan tâm đó.

Mã cho 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

Mỗi chủ sở hữu nhóm có tối đa bao nhiêu nhóm mối quan tâm cho một người dùng?

Chrome cho phép mỗi chủ sở hữu có tối đa 1.000 nhóm mối quan tâm và tối đa 1.000 chủ sở hữu nhóm mối quan tâm. Những giới hạn này được đặt như rào chắn để không bị ảnh hưởng trong hoạt động thông thường.

Làm cách nào để tối đa hoá quảng cáo cho nhóm đối tượng có cùng mối quan tâm đáp ứng ngưỡng k-anon?

Như giải thích công khai lưu ý, vì một nhóm mối quan tâm có thể chứa nhiều quảng cáo có thể hiển thị, nên nhóm sẽ có cơ hội đặt giá thầu lại một trong các quảng cáo khác của nhóm để hoạt động như một "quảng cáo dự phòng" bất cứ khi nào lựa chọn ưu tiên nhất của họ dưới 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 k-anonymity vẫn có thể chọn tham gia phiên đấu giá và nhóm đối tượng có cùng mối quan tâm có cách quay lại 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 đủ lớn.

Từ góc độ chiến thuật, bạn có thể xem xét 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 với 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 phải làm gì thêm.
  • Bạn có thể có một quảng cáo dự phòng mà bạn sử dụng khi quảng cáo mới không phải là k-anon. Có một số rủi ro khiến quảng cáo dự phòng không trở thành k-anon, vì vậy, đôi khi bạn có thể xem xét chỉ đặt giá thầu với quảng cáo dự phòng ngay từ đầu. Ví dụ: bạn có thể làm việc này 1% thời gian, nếu đó là mức độ tốt để đảm bảo rằng bạn mong đợi dự phòng vượt quá ngưỡng.

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

Tất cả tệp tham chiếu Protected Audience API

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

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.