ดูวิธีใช้ความสนใจจาก Topics เป็นอินพุตในกระบวนการเสนอราคาและการประมูลสำหรับ Protected Audience Protected Audience มีหลายจุดที่ผู้ซื้อและผู้ขายอาจส่งสัญญาณของบุคคลที่หนึ่งไปยังกระบวนการเสนอราคาและการประมูล สัญญาณที่ได้จาก Topics สามารถใช้เพื่อปรับปรุงข้อมูลที่มีในระหว่างกระบวนการเสนอราคาและการเลือกโฆษณา ด้วยข้อมูลเกี่ยวกับความสนใจของผู้ใช้ในปัจจุบันที่ช่วยเพิ่มศักยภาพของพื้นที่โฆษณา
ก่อนอ่านคู่มือนี้ โปรดทำความคุ้นเคยกับทั้งหัวข้อและกลุ่มเป้าหมายที่มีการป้องกัน
รับหัวข้อ
เมื่อเรียกใช้ Topics API ผู้โทรจะเห็นหัวข้อที่เลือกไว้ก่อนหน้านี้สำหรับเบราว์เซอร์นั้นๆ
const currentTopics = await document.browsingTopics();
// Example result
[
{
"configVersion": "chrome.2",
"modelVersion": "4",
"taxonomyVersion": "2",
"topic": 310,
"version": "chrome.2:2:4"
}
]
หัวข้อในกรณีนี้คือ 310
แมปกับ "กีฬา/ปั่นจักรยาน"
ตัวอย่างเหล่านี้แสดงค่าหัวข้อที่ใช้โดยตรง แต่การใช้งานเต็มรูปแบบอาจเลือกประมวลผลหรือรวมกับข้อมูลอื่นๆ ก็ได้
ใช้หัวข้อเพื่อกำหนดเงื่อนไขกลุ่มความสนใจ
สามารถใช้หัวข้อที่ได้โดยตรงเพื่อเลือกเพิ่มผู้ใช้ลงในกลุ่มความสนใจ
if (currentTopics[0].topic === 310) { // Interest in "Sports/Cycling"
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
}
}
ระบุหัวข้อของผู้ซื้อให้กับกลุ่มความสนใจ
หัวข้อปัจจุบัน (หรือข้อมูลที่ประมวลผลแล้ว) สามารถรวมอยู่ใน userBiddingSignals
เมื่อสร้างกลุ่มความสนใจ ซึ่งจะทำให้ผู้ซื้อใช้หัวข้อเมื่อเสนอราคาได้
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
userBiddingSignals: {
topics: currentTopics,
....
},
...
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
ระบุหัวข้อผู้ขายในการประมูล
หัวข้อปัจจุบันที่ผู้ขายเห็น (หรือข้อมูลที่ประมวลผลจากผู้ขายเหล่านั้น) อาจรวมอยู่ใน auctionSignals
, sellerSignals
หรือ perBuyerSignals
เมื่อกำหนดค่าการประมูล วิธีนี้ช่วยให้ทั้งผู้ซื้อใช้หัวข้อเมื่อเสนอราคาและผู้ขายสามารถใช้หัวข้อเมื่อให้คะแนนราคาเสนอ
const myAuctionConfig = {
seller: 'https://ssp.example',
auctionSignals: {
topics: currentTopics,
},
sellerSignals: {
topics: currentTopics,
},
perBuyerSignals: {
'https://dsp.example': {
topics: currentTopics,
// ...
},
// ...
},
// ...
};
const result = await navigator.runAdAuction(myAuctionConfig);
ใช้หัวข้อเมื่อเสนอราคา
จากนั้นเมื่อมีการเรียกฟังก์ชัน generateBid()
ของผู้ซื้อ ระบบจะใช้หัวข้อที่บันทึกไว้ที่ส่งผ่าน (เช่นเดียวกับข้อมูลอื่นๆ ที่ให้ไว้ในสัญญาณ) เพื่อช่วยในการเสนอราคา ตัวอย่างเช่น ผู้เสนอราคาอาจใช้หัวข้อ "กีฬา/การปั่นจักรยาน" ที่มีเพื่อเสนอราคาสูงขึ้นด้วยกลุ่มความสนใจ custom-bikes
นี้
generateBid(interestGroup, auctionSignals, perBuyerSignals,
trustedBiddingSignals, browserSignals) {
const topics = interestGroup.userBiddingSignals.topics;
// Use the topic values in the bidding logic.
}
ใช้หัวข้อเมื่อให้คะแนนราคาเสนอ
หลังจากการเสนอราคาเมื่อมีการเรียกใช้ฟังก์ชัน scoreAd()
ของผู้ขาย หัวข้อที่บันทึกไว้จะสามารถใช้ได้เช่นเดียวกับข้อมูลอื่นๆ ที่ส่งจากการกำหนดค่าการประมูล ตัวอย่างเช่น ผู้ขายอาจต้องการให้น้ำหนักราคาเสนอสูงขึ้นสำหรับโฆษณาที่ตรงกับหัวข้อที่ตรวจพบ
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
//...
}