การใช้ดีลหรือที่เรียกว่ามาร์เก็ตเพลสส่วนตัว (PMP) ในการประมูลที่ใช้ Protected Audience API
ภาพรวม
ดีลหรือที่เรียกว่ามาร์เก็ตเพลสส่วนตัว (PMP) จะมอบการเข้าถึงที่มีการดูแลจัดการหรือการกำหนดราคาที่ต้องการสำหรับผู้ซื้อในพื้นที่โฆษณาบางส่วน เพื่อช่วยสนับสนุนดีลแบบเป็นโปรแกรม จะมีการใช้รหัสที่นั่งและรหัสดีลตามขั้นตอนต่อไปนี้
- รหัสที่นั่งมาจากผู้ซื้อ และเป็นตัวระบุที่แสดงถึงลูกค้าของผู้ซื้อ รหัสใบอนุญาตอาจมีผลกับการเรียกเก็บเงิน เช่น ในกรณีที่ใบอนุญาตที่มีส่วนลดจากผู้ขายหนึ่งๆ
- รหัสดีลจะมาจากผู้ซื้อหรือผู้ขาย และเป็นตัวระบุที่แสดงถึงข้อตกลงระหว่างผู้ซื้อกับผู้ขาย รหัสดีลอาจมีพร็อพเพอร์ตี้ เช่น ต้นทุน/ราคา ความมุ่งมั่นด้านปริมาณ ข้อมูลกลุ่มเป้าหมาย ความพิเศษ และอื่นๆ
Protected Audience ช่วยอำนวยความสะดวกให้ดีลต่างๆ โดยใช้รหัสการรายงานซึ่งจะทำให้ใช้ได้ทั้งรหัสที่นั่งและรหัสดีลสำหรับการเสนอราคาในการประมูล การให้คะแนน และการรายงาน รหัสการรายงานเป็นกลไกที่ช่วยให้บริษัทเทคโนโลยีโฆษณาได้รับดีลและรหัสที่นั่งเหล่านี้ในการรายงาน Protected Audience หลังการประมูลเพื่อทําธุรกรรมดีลและจัดระเบียบการเรียกเก็บเงิน เราคาดหวังว่าผู้ซื้อ ผู้ขาย เอเจนซี และผู้ลงโฆษณาอาจมีกลยุทธ์ที่ออกแบบมาโดยเฉพาะเพื่อตีความและทำความเข้าใจรหัสดีลและรหัสที่นั่งที่ตนได้รับ
คำแนะนำแบบทีละขั้น
ขั้นตอนในการส่งเสริมดีลในการประมูลที่ใช้ Protected Audience API มีดังนี้
- ผู้ซื้อจะลงทะเบียนดีลและรหัสที่นั่งในการกำหนดค่ากลุ่มความสนใจก่อนการประมูลทำงาน
- คุณสามารถตั้งค่ารหัสดีลและรหัสที่นั่งในช่องรหัสการรายงานที่เลือกได้ (
selectableBuyerAndSellerReportingIds
) - หากรหัสที่นั่งในดีลทั้งหมดเหมือนกัน คุณสามารถตั้งค่ารหัสที่นั่งใน
buyerAndSellerReportingId
และกำหนดรหัสดีลในช่องรหัสการรายงานที่เลือกได้ (selectableBuyerAndSellerReportingIds
)
- คุณสามารถตั้งค่ารหัสดีลและรหัสที่นั่งในช่องรหัสการรายงานที่เลือกได้ (
- ในระหว่างการสร้างราคาเสนอ ดีลและรหัสที่นั่งจะพร้อมใช้งาน ผู้ซื้อเลือกรหัสดีลจาก
selectableBuyerAndSellerReportingIds
ผู้ซื้อสร้างราคาเสนอซึ่งมีรหัสดีลที่เชื่อมโยงกับราคาเสนอนั้นโดยการส่งคืนselectedBuyerAndSellerReportingId
การเสนอราคาจะชนะการประมูลได้ก็ต่อเมื่อรหัสดีลที่แสดงผลเป็นแบบไม่ระบุตัวบุคคลแบบ K ควบคู่ไปกับรหัสการรายงานอื่นๆ และพร็อพเพอร์ตี้ที่เลือกของกลุ่มความสนใจ - ในระหว่างการให้คะแนนโฆษณา ผู้ขายจะเห็นดีลและรหัสที่นั่งที่เลือก
- รหัสดีลและรหัสที่นั่งจะปรากฏในฟังก์ชันการรายงานของผู้ขาย
- รหัสดีลและใบอนุญาตจะมีอยู่ในฟังก์ชันการรายงานของผู้ซื้อ
1. การลงทะเบียนรหัสดีลและหมายเลขประจำตัวผู้ใช้
ผู้ซื้อจะลงทะเบียนดีลและรหัสที่นั่งในการกําหนดค่ากลุ่มความสนใจก่อนการประมูลจะเริ่มขึ้น ดีลและรหัสดีลมีการตั้งค่าใน selectableBuyerAndSellerReportingIds
เป็นอาร์เรย์ของสตริง หากรหัสที่นั่งเหมือนกันสำหรับดีลทั้งหมดและไม่จำเป็นต้องระบุซ้ำ คุณสามารถเพิ่มรหัสที่นั่งในช่อง buyerAndSellerReportingId
ซึ่งยอมรับสตริงได้ ดังนี้
const interestGroupConfig = {
owner: 'https://buyer.example',
name: 'example-ig',
ad: [
{
renderURL: 'https://buyer.example/ad.html',
selectableBuyerAndSellerReportingIds: ['deal123', 'deal456', 'deal789'], // Deal IDs
buyerAndSellerReportingId: 'seat123', // Seat ID
// Though it is not used to facilitate deals, the buyer
// reporting ID can be defined with other reporting IDs
buyerAndReportingId: 'brid123'
},
],
};
navigator.joinAdInterestGroup(interestGroupConfig);
หากรหัสที่นั่งของดีลต่างกัน คุณจะใช้การตั้งค่าต่อไปนี้ได้
const interestGroupConfig = {
owner: 'https://buyer.example',
name: 'example-ig',
ad: [
{
renderURL: 'https://buyer.example/ad.html',
selectableBuyerAndSellerReportingIds: [
'deal123seat123',
'deal456seat456',
'deal789seat456'
], // Deal and Seat IDs
},
],
};
navigator.joinAdInterestGroup(interestGroupConfig);
2. รหัสดีลและรหัสใบอนุญาตสำหรับผู้ซื้อระหว่างการสร้างราคาเสนอ
ในระหว่างการสร้างราคาเสนอ ผู้ซื้อจะตัดสินใจว่าต้องการเสนอราคาในรหัสดีลหรือไม่ ใน generateBid()
ผู้ซื้อสามารถเลือกรหัสดีลจาก selectableBuyerAndSellerReportingIds
และแสดงผลเป็น selectedBuyerAndSellerReportingId
ราคาเสนอจะถูกปฏิเสธหากรหัสดีลที่เลือกไม่อยู่ในอาร์เรย์ selectableBuyerAndSellerReportingIds
function generateBid(..., browserSignals, ...) {
const {
buyerAndSellerReportingId, // 'seat123'
selectableBuyerAndSellerReportingIds // ['deal123', 'deal456', 'deal789']
buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
} = browserSignals;
// ...
return {
bid: 1,
render: 'https://buyer.example/ad.html',
selectedBuyerAndSellerReportingId: 'deal456', // Buyer selects a deal ID
};
}
ราคาเสนอที่มีค่าที่แสดงผลสำหรับ selectedbuyerAndSellerReportingId
จะชนะการประมูลก็ต่อเมื่อค่าของ selectedbuyerAndSellerReportingId
เป็น k-anonymous ร่วมกับ buyerAndSellerReportingId
(หากมี), buyerReportingId
(หากมี) เจ้าของตามกลุ่มความสนใจ, URL สคริปต์การเสนอราคา, URL การแสดงผล และขนาดโฆษณา (ขนาดโฆษณาไม่รวมอยู่ในการตรวจสอบนี้จนถึงไตรมาส 1 ปี 2025 เป็นอย่างน้อย)
แม้จะมีการกำหนด selectablebuyerAndSellerReportingIds
ในการกำหนดค่ากลุ่มความสนใจแล้ว แต่ generateBid()
ก็ยังคงมีสิทธิ์แสดงราคาเสนอที่ไม่มี selectedbuyerAndSellerReportingId
ในกรณีนี้ รหัสการรายงานที่ให้ไว้ในฟังก์ชันการรายงานหากราคาเสนอนี้ชนะ จะเป็นไปตามลักษณะการทำงานของรหัสการรายงานที่เลือกไม่ได้
ในกรณีที่เรียกใช้ generateBid()
อีกครั้งเนื่องจากการเรียกใช้ครั้งแรกไม่ได้สร้างการเสนอราคาสำหรับโฆษณาที่ผ่านการตรวจสอบ k-anonymity แล้ว selectableBuyerAndSellerReportingIds
ที่ไม่ผ่านการตรวจสอบ k-anonymity จะไม่ปรากฏในกลุ่มความสนใจในการเรียกใช้อีกครั้ง
3. รหัสดีลและรหัสที่นั่งสำหรับผู้ขายในระหว่างการให้คะแนนโฆษณา
scoreAd()
จะเข้าถึงรหัสดีลที่เลือก รวมถึงรหัสที่นั่ง (หากมี) ได้ ผู้ขายจะต้องให้คะแนนความพอใจของราคาเสนอที่ชนะ โดยพิจารณาจากรหัสดีลและเงื่อนไขพิเศษใดๆ หากผู้ขายไม่ได้ใช้รหัสดีลที่ผู้ซื้อเลือก ผู้ขายจะปฏิเสธการเสนอราคาโดยให้คะแนนความต้องการเป็นศูนย์หรือติดลบ
function scoreAd(..., browserSignals, ...) {
const {
buyerAndSellerReportingId, // 'seat123'
selectedBuyerAndSellerReportingIds, // 'deal456'
} = browserSignals;
// ...
}
4. รหัสดีลและรหัสที่นั่งสำหรับการรายงานผู้ขาย
โปรดทราบว่าราคาเสนอจะชนะการประมูลก็ต่อเมื่อ selectedBuyerAndSellerReportingId
, buyerAndSellerReportingId
(หากมี) และ buyerReportingId
(หากมี) เป็นชื่อ k กับเจ้าของกลุ่มความสนใจ, URL ของสคริปต์การเสนอราคา, URL การแสดงผล และขนาดโฆษณา (ขนาดโฆษณาไม่รวมอยู่ในการตรวจสอบนี้จนกว่าจะถึงไตรมาสที่ 1 ปี 2025 เป็นอย่างน้อย) ดังนั้น ค่ารหัสการรายงานที่มี selectedBuyerAndSellerReportingId
จะอยู่ใน reportResult()
เสมอ โปรดทราบว่าแม้ว่าจะมีการเลือก buyerReportingId
เพื่อตรวจสอบการลบข้อมูลระบุตัวบุคคลแบบ k แต่ค่าดังกล่าวจะใช้ได้กับฟังก์ชันการรายงานผู้ซื้อเท่านั้น ไม่ใช่ฟังก์ชันการรายงานผู้ขาย
function reportResult(..., browserSignals, ...) {
const {
buyerAndSellerReportingId, // 'seat123'
selectedBuyerAndSellerReportingIds // 'deal456'
} = browserSignals;
// ...
}
5. รหัสดีลและรหัสใบอนุญาตสําหรับการรายงานของผู้ซื้อ
แนวคิดเดียวกันจากการรายงานผู้ขายจะใช้กับการรายงานผู้ซื้อ โปรดทราบว่าราคาเสนอจะชนะการประมูลก็ต่อเมื่อ selectedBuyerAndSellerReportingId
, buyerAndSellerReportingId
(หากมี) และ buyerReportingId
(หากมี) เป็น k-anonym กับเจ้าของกลุ่มความสนใจ, URL ของสคริปต์การเสนอราคา, URL การแสดงผล และขนาดโฆษณา (ขนาดโฆษณาไม่รวมอยู่ในการตรวจสอบนี้จนกว่าจะถึงไตรมาสที่ 1 ปี 2025 เป็นอย่างน้อย) ดังนั้น ค่ารหัสการรายงานที่มี selectedBuyerAndSellerReportingId
จะอยู่ใน reportWin()
เสมอ
function reportWin(..., browserSignals, ...) {
const {
buyerAndSellerReportingId, // 'seat123'
selectedBuyerAndSellerReportingId // 'deal456'
buyerAndReportingId // 'brid123' - Not used for deals, but the value is available
} = browserSignals;
}
มีส่วนร่วมและแชร์ความคิดเห็น
- ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสการรายงานได้ที่ส่วนรหัสการรายงานในวิดีโออธิบาย Protected Audience
- GitHub: หยิบยกคำถามและติดตามการสนทนาเกี่ยวกับปัญหาในที่เก็บ API
- W3C: พูดคุยเกี่ยวกับกรณีการใช้งานในอุตสาหกรรมในการโทรของ WICG
- ประกาศ: เข้าร่วมหรือดูรายชื่ออีเมล
- ทีมสนับสนุนนักพัฒนาแอป Privacy Sandbox: ถามคำถามและเข้าร่วมการสนทนาในที่เก็บการสนับสนุนนักพัฒนาซอฟต์แวร์ของ Privacy Sandbox
- Chromium: รายงานข้อบกพร่อง Chromium เพื่อถามคำถามเกี่ยวกับการใช้งานที่สามารถทดสอบได้ใน Chrome