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 đấu giá và đặt giá thầu trong Protected Audience. Protected Audience có một số điểm mà người mua và người bán có thể truyền tín hiệu của bên thứ nhất vào quá trình đặt giá thầu và phiên đấu giá. Các tín hiệu do Chủ đề cung cấp có thể được dùng để làm phong phú dữ liệu có sẵn trong quá trình đặt giá thầu và lựa chọn quảng cáo với thông tin về mối quan tâm hiện tại của người dùng nhằ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 hiểu rõ cả Topics và Protected Audience API.
Tải chủ đề
Khi gọi Topics API, phương thức gọi sẽ thấy một lựa chọn về các chủ đề mà họ đã quan sát 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, chủ đề: 310 liên kết với "Thể thao/Đạp xe".
Những ví dụ này cho thấy các giá trị chủ đề được sử dụng trực tiếp, nhưng bạn có thể chọn xử lý hoặc kết hợp chúng với dữ liệu khác nếu triển khai đầy đủ.
Sử dụng chủ đề để xác định có điều kiện một nhóm mối quan tâm
Chủ đề thu được có thể được dùng trực tiếp để 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. Điều 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 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ừ những chủ đề đó) có thể được kết hợp với auctionSignals, sellerSignals hoặc perBuyerSignals khi thiết lập phiên đấu giá. Điều này cho phép cả người mua sử dụng chủ đề khi đặt giá thầu và người bán sử dụng 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 chủ đề khi đặt giá thầu
Sau đó, khi hàm generateBid() của người mua được gọi, các chủ đề được ghi lại đã được truyền vào có thể được sử dụng (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 chủ đề "Thể thao/đạp xe" để đặt giá thầu cao hơn với nhóm mối 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ư bất kỳ dữ liệu nào khác được truyền vào từ cấu hình phiên đấu giá. Ví dụ: người bán có thể muốn đặt giá thầu cao hơn cho những quảng cáo phù hợp với các chủ đề được 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
//...
}