Tìm hiểu cách sử dụng mối quan tâm trong Chủ đề làm dữ liệu đầu vào cho quy trình đặt giá thầu và phiên đấu giá sử dụng Protected Audience API. Protected Audience có một số điểm mà người mua và người bán có thể truyền các tín hiệu của bên thứ nhất vào quy trình đặt giá thầu và đấu giá. Các tín hiệu do Chủ đề cung cấp có thể được dùng để làm phong phú thêm dữ liệu có sẵn trong quá trình đặt giá thầu và lựa chọn quảng cáo, nhờ đó có thông tin về mối quan tâm hiện tại của người dùng làm tăng giá trị tiềm năng của khoảng không quảng cáo.
Trước khi đọc hướng dẫn này, hãy đảm bảo bạn đã quen thuộc với cả Topics API và Protected Audience API.
Nhận chủ đề
Khi gọi Topics API, phương thức gọi sẽ thấy một số chủ đề mà họ đã ghi nhận trước đó trên trình duyệt đó.
const currentTopics = await document.browsingTopics();
// Example result
[
{
"configVersion": "chrome.2",
"modelVersion": "4",
"taxonomyVersion": "2",
"topic": 310,
"version": "chrome.2:2:4"
}
]
Trong trường hợp này là chủ đề: 310 ánh xạ tới "Thể thao/Đạp xe".
Những ví dụ này cho thấy các giá trị chủ đề đang được dùng trực tiếp, nhưng bạn có thể chọn xử lý hoặc kết hợp các giá trị này với dữ liệu khác khi triển khai đầy đủ.
Sử dụng chủ đề để xác định theo điều kiện nhóm mối quan tâm
Bạn có thể trực tiếp chọn chủ đề thu được để chọn thêm người dùng vào một nhóm mối quan tâm.
if (currentTopics[0].topic === 310) { // Interest in "Sports/Cycling"
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
}
}
Cung cấp chủ đề của người mua cho một nhóm mối quan tâm
Bạn có thể đưa các chủ đề hiện tại (hoặc dữ liệu được xử lý từ các chủ đề đó) vào userBiddingSignals khi tạo nhóm mối quan tâm. Lựa chọn này cho phép người mua sử dụng các chủ đề khi đặt giá thầu.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
userBiddingSignals: {
topics: currentTopics,
....
},
...
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
Cung cấp các chủ đề của người bán cho phiên đấu giá
Các chủ đề hiện tại hiển thị cho người bán (hoặc dữ liệu được xử lý từ họ) có thể được kết hợp với auctionSignals, sellerSignals hoặc perBuyerSignals khi định cấu hình phiên đấu giá. Điều này cho phép cả người mua sử dụng các chủ đề khi đặt giá thầu và người bán sử dụng các chủ đề khi tính điểm giá thầu.
const myAuctionConfig = {
seller: 'https://ssp.example',
auctionSignals: {
topics: currentTopics,
},
sellerSignals: {
topics: currentTopics,
},
perBuyerSignals: {
'https://dsp.example': {
topics: currentTopics,
// ...
},
// ...
},
// ...
};
const result = await navigator.runAdAuction(myAuctionConfig);
Sử dụng các chủ đề khi đặt giá thầu
Sau đó, khi gọi hàm generateBid() của người mua, hệ thống có thể sử dụng các chủ đề đã ghi được truyền vào (giống như mọi dữ liệu khác được cung cấp trong tín hiệu) để hỗ trợ đặt giá thầu. Ví dụ: bên đặt giá thầu có thể sử dụng sự hiện diện của "Thể thao/Đạp xe" chủ đề để đặt giá thầu cao hơn với nhóm quan tâm custom-bikes này.
generateBid(interestGroup, auctionSignals, perBuyerSignals,
trustedBiddingSignals, browserSignals) {
const topics = interestGroup.userBiddingSignals.topics;
// Use the topic values in the bidding logic.
}
Sử dụng chủ đề khi tính điểm giá thầu
Sau khi đặt giá thầu khi hàm scoreAd() của người bán được gọi, các chủ đề được ghi lại có thể được sử dụng như mọi dữ liệu khác được truyền từ cấu hình phiên đấu giá. Ví dụ: người bán có thể muốn đặt trọng số giá thầu cao hơn cho những quảng cáo khớp với các chủ đề đã phát hiện.
scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals, directFromSellerSignals) {
const sellerTopics = actionConfig.auctionSignals.topics;
// or corresponding key in sellerSignals
// use the topics values to score the ads
//...
}