สร้างรายงานข้อมูลรวมโดยใช้ข้อมูลจาก Protected Audience และข้อมูลจากหลายเว็บไซต์จากพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน
Private Aggregation API สร้างขึ้นเพื่อรวบรวมและรายงานข้อมูลข้ามเว็บไซต์ในลักษณะที่รักษาความเป็นส่วนตัว เพื่อให้มีฟีเจอร์สําคัญที่เว็บต้องใช้
สถานะการติดตั้งใช้งาน
ข้อเสนอ | สถานะ |
---|---|
ป้องกันไม่ให้รายงาน Private Aggregation API ไม่ถูกต้องด้วยการยืนยันรายงานสําหรับพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน คําอธิบาย |
พร้อมใช้งานใน Chrome |
ความพร้อมใช้งานของโหมดแก้ไขข้อบกพร่องการรวมข้อมูลส่วนตัวขึ้นอยู่กับการมีสิทธิ์ของ 3PC ปัญหาเกี่ยวกับ GitHub |
พร้อมใช้งานใน Chrome M119 |
การลดความล่าช้าของรายงาน คำอธิบาย |
พร้อมใช้งานใน Chrome M119 |
ระยะหมดเวลาของการมีส่วนร่วมในการรวมข้อมูลส่วนตัวสําหรับพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน คําอธิบาย |
พร้อมให้บริการใน M119 |
การรองรับ Private Aggregation API และบริการรวมข้อมูลสําหรับ Google Cloud คําอธิบาย |
พร้อมใช้งานใน Chrome M121 |
การถ่วงน้ำหนักสำหรับเพย์โหลดรายงานที่รวบรวมได้ คำอธิบาย |
พร้อมใช้งานใน Chrome M119 |
โหมดแก้ไขข้อบกพร่องของ Private Aggregation พร้อมใช้งานสําหรับการรายงาน auctionReportBuyers คําอธิบาย |
พร้อมใช้งานใน Chrome M123 |
การรองรับการกรองรหัส คำอธิบาย |
พร้อมใช้งานใน Chrome M128 |
การผสานข้อมูลที่ได้จากไคลเอ็นต์ คำอธิบาย |
พร้อมใช้งานใน Chrome M129 |
ขีดจํากัดการมีส่วนร่วมต่อบริบท คําอธิบาย |
คาดว่าจะพร้อมให้บริการในไตรมาส 1 ปี 2025 |
งบประมาณความเป็นส่วนตัวที่มีชื่อซึ่งจัดสรรงบประมาณความเป็นส่วนตัวล่วงหน้าสําหรับกรณีการใช้งานการวัดผลที่แตกต่างกัน คําอธิบาย |
คาดว่าจะพร้อมให้บริการในไตรมาสที่ 2 ปี 2025 |
การรายงานข้อผิดพลาดแบบรวมที่แก้ไขข้อบกพร่องในการติดตั้งใช้งานโดยไม่ต้องใช้คุกกี้ของบุคคลที่สาม คําอธิบาย |
คาดว่าจะพร้อมให้บริการในไตรมาสที่ 2 ปี 2025 |
Private Aggregation API คืออะไร
Private Aggregation API ช่วยให้นักพัฒนาซอฟต์แวร์สร้างรายงานข้อมูลรวมได้โดยใช้ข้อมูลจาก Protected Audience API และข้อมูลจากหลายเว็บไซต์จาก Shared Storage
ฟังก์ชันหลักของ API นี้เรียกว่า contributeToHistogram()
การดำเนินการกับฮิสโตแกรมช่วยให้คุณรวบรวมข้อมูลจากผู้ใช้ในแต่ละที่เก็บข้อมูล (หรือที่เรียกว่าคีย์การรวมข้อมูลใน API) ที่คุณกำหนด
การเรียกใช้ฮิสโตแกรมจะรวบรวมค่าและแสดงผลลัพธ์แบบรวมที่มีสัญญาณรบกวนในรูปแบบของรายงานสรุป เช่น รายงานอาจแสดงจํานวนเว็บไซต์ที่ผู้ใช้แต่ละรายเห็นเนื้อหาของคุณ หรือพบข้อบกพร่องในสคริปต์ของบุคคลที่สาม การดำเนินการนี้จะดำเนินการภายในเวิร์กเลตของ API อื่น
เช่น หากก่อนหน้านี้คุณได้บันทึกข้อมูลประชากรและข้อมูลทางภูมิศาสตร์ไว้ในพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน คุณสามารถใช้ Private Aggregation API เพื่อสร้างฮิสโตแกรมซึ่งบอกจํานวนผู้ใช้ในนิวยอร์กซิตี้ที่เห็นเนื้อหาของคุณในหลายเว็บไซต์โดยประมาณ หากต้องการรวบรวมข้อมูลสําหรับการวัดนี้ คุณสามารถเข้ารหัสมิติข้อมูลภูมิศาสตร์ลงในคีย์การรวบรวมข้อมูลและนับผู้ใช้ในค่าที่รวบรวมได้
หัวข้อสำคัญ
เมื่อคุณเรียกใช้ Private Aggregation API ด้วยคีย์การรวมและค่าที่รวมได้ เบราว์เซอร์จะสร้างรายงานที่รวมได้
ระบบจะส่งรายงานที่รวบรวมได้ไปยังเซิร์ฟเวอร์เพื่อรวบรวมและจัดกลุ่ม บริการรวมข้อมูลจะประมวลผลรายงานกลุ่มในภายหลัง และสร้างรายงานสรุป
ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวคิดสําคัญที่เกี่ยวข้องกับ Private Aggregation API ได้ในเอกสารข้อมูลเบื้องต้นเกี่ยวกับ Private Aggregation API
ความแตกต่างจากการรายงานการระบุแหล่งที่มา
Private Aggregation API มีความคล้ายคลึงกับ Attribution Reporting API หลายประการ การรายงานการระบุแหล่งที่มาคือ API แบบสแตนด์อโลนที่ออกแบบมาเพื่อวัด Conversion ส่วนการรวมข้อมูลส่วนตัวสร้างขึ้นสำหรับการวัดผลข้ามเว็บไซต์ร่วมกับ API เช่น Protected Audience API และ Shared Storage ทั้ง 2 API จะสร้างรายงานที่รวบรวมข้อมูลได้ ซึ่งแบ็กเอนด์ของบริการรวบรวมข้อมูลจะใช้เพื่อสร้างรายงานสรุป
การรายงานการระบุแหล่งที่มาจะเชื่อมโยงข้อมูลที่รวบรวมจากเหตุการณ์การแสดงผลและเหตุการณ์ Conversion ซึ่งเกิดขึ้นในเวลาที่ต่างกัน การรวมข้อมูลส่วนตัวจะวัดเหตุการณ์เดียวที่ข้ามเว็บไซต์
ทดสอบ API นี้
หากต้องการทดสอบ Private Aggregation API ในเครื่อง ให้เปิดใช้ Ad Privacy API ทั้งหมดในส่วน chrome://settings/adPrivacy
อ่านเพิ่มเติมเกี่ยวกับการทดสอบในทดสอบและเข้าร่วม
ใช้เวอร์ชันเดโม
คุณสามารถดูการสาธิต Private Aggregation API สำหรับพื้นที่เก็บข้อมูลส่วนกลางได้ที่ goo.gle/shared-storage-demo และดูโค้ดได้ที่ GitHub การแสดงตัวอย่างจะใช้การดำเนินการฝั่งไคลเอ็นต์และสร้างรายงานที่รวบรวมได้ซึ่งส่งไปยังเซิร์ฟเวอร์
เราจะเผยแพร่การสาธิต Private Aggregation API สําหรับ Protected Audience API ในอนาคต
กรณีการใช้งาน
Private Aggregation คือ API อเนกประสงค์สําหรับการวัดผลข้ามเว็บไซต์ และพร้อมให้ใช้งานในเวิร์กเลต Shared Storage และ Protected Audience API ขั้นตอนแรกคือตัดสินใจว่าต้องการรวบรวมข้อมูลใดบ้าง จุดข้อมูลเหล่านั้นเป็นพื้นฐานของคีย์การรวม
มีพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน
พื้นที่เก็บข้อมูลที่ใช้ร่วมกันช่วยให้คุณอ่านและเขียนข้อมูลจากหลายเว็บไซต์ในสภาพแวดล้อมที่ปลอดภัยเพื่อป้องกันการรั่วไหล และ Private Aggregation API ช่วยให้คุณวัดข้อมูลจากหลายเว็บไซต์ที่จัดเก็บไว้ในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันได้
การวัด Unique Reach
คุณอาจต้องวัดจํานวนผู้ใช้ที่ไม่ซ้ำซึ่งเห็นเนื้อหา Private Aggregation API สามารถให้คำตอบ เช่น "ผู้ใช้ที่ไม่ซ้ำประมาณ 317 คนเห็น Content ID 861"
คุณสามารถตั้งค่า Flag ใน Shared Storage เพื่อระบุว่าผู้ใช้เคยเห็นเนื้อหานั้นหรือไม่ ในการเข้าชมครั้งแรกที่ไม่มีการตั้งค่าสถานะ ระบบจะเรียกใช้การรวมข้อมูลส่วนตัว จากนั้นจึงตั้งค่าสถานะ ในการเข้าชมครั้งต่อๆ ไปของผู้ใช้ ซึ่งรวมถึงการเข้าชมข้ามเว็บไซต์ คุณสามารถตรวจสอบ Shared Storage และข้ามการส่งรายงานไปยัง Private Aggregation ได้หากตั้งค่า Flag ไว้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้การวัดเหล่านี้ได้ในสมุดปกขาวเกี่ยวกับการเข้าถึง
การวัดข้อมูลประชากร
คุณอาจต้องวัดข้อมูลประชากรของผู้ใช้ที่ดูเนื้อหาของคุณในเว็บไซต์ต่างๆ
การรวมข้อมูลส่วนตัวสามารถให้คําตอบได้ เช่น "ผู้ใช้ที่ไม่ซ้ำกันประมาณ 317 คนมีอายุ 18-45 ปีและมาจากเยอรมนี" ใช้พื้นที่เก็บข้อมูลส่วนกลางเพื่อเข้าถึงข้อมูลประชากรจากบริบทของบุคคลที่สาม ในอนาคต คุณสามารถสร้างรายงานที่มีการรวมข้อมูลส่วนตัวได้โดยการเข้ารหัสมิติข้อมูลกลุ่มอายุและประเทศในคีย์การรวมข้อมูล
การวัดความถี่ตั้งแต่ K ครั้งขึ้นไป
คุณอาจต้องวัดจํานวนผู้ใช้ที่เห็นเนื้อหาหรือโฆษณาอย่างน้อย K ครั้งในเบราว์เซอร์หนึ่งๆ สําหรับค่า K ที่เลือกไว้ล่วงหน้า
การรวมข้อมูลส่วนตัวสามารถให้คำตอบ เช่น "ผู้ใช้ประมาณ 89 คนเห็น Content ID 581 อย่างน้อย 3 ครั้ง" ตัวนับจะเพิ่มขึ้นในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันจากเว็บไซต์ต่างๆ และสามารถอ่านได้ภายในเวิร์กเลต เมื่อจำนวนถึง K แล้ว คุณจะส่งรายงานได้โดยใช้การรวมข้อมูลส่วนตัว
การระบุแหล่งที่มาแบบมัลติทัช
การระบุแหล่งที่มาของการตลาดเป็นวิธีที่ผู้ลงโฆษณาใช้เพื่อพิจารณาว่ากลยุทธ์ทางการตลาดและการโต้ตอบกับโฆษณาในภายหลังส่งผลต่อยอดขายหรือ Conversion มากน้อยเพียงใด
เมื่อใช้ Protected Audience API
Protected Audience API รองรับ Use Case ของการกำหนดเป้าหมายใหม่และกลุ่มเป้าหมายที่กำหนดเอง ส่วนการรวมข้อมูลส่วนตัวช่วยให้คุณรายงานเหตุการณ์จากเวิร์กเลตของผู้ซื้อและผู้ขายได้ API นี้สามารถใช้สําหรับงานต่างๆ เช่น การวัดการกระจายของราคาเสนอในการประมูล
จากชิ้นงาน Protected Audience API คุณสามารถรวบรวมข้อมูลได้โดยตรงโดยใช้ contributeToHistogram()
และรายงานข้อมูลตามทริกเกอร์โดยใช้ contributeToHistogramOnEvent()
ซึ่งเป็นส่วนขยายพิเศษสําหรับ Protected Audience API
ฟังก์ชันที่ใช้ได้
ฟังก์ชันต่อไปนี้มีอยู่ในออบเจ็กต์ privateAggregation
ที่มีอยู่ในชิ้นงาน Shared Storage และ Protected Audience API
contributeToHistogram()
คุณสามารถเรียกใช้ privateAggregation.contributeToHistogram({ bucket: <bucket>, value: <value> })
โดยที่คีย์การรวมข้อมูลคือ bucket
และค่าที่รวมข้อมูลได้คือ value
สำหรับพารามิเตอร์ bucket
ต้องมี BigInt
สำหรับพารามิเตอร์ value
ต้องใช้ตัวเลขเต็ม
ต่อไปนี้คือตัวอย่างการเรียกใช้พื้นที่เก็บข้อมูลที่ใช้ร่วมกันสําหรับการวัดการเข้าถึง
iframe.js
// Cross-site iframe code
async function measureReach() {
// Register worklet
await window.sharedStorage.worklet.addModule('worklet.js');
// Run reach measurement operation
await window.sharedStorage.run('reach-measurement', {
data: { contentId: '1234' }
});
}
measureReach();
worklet.js
// Shared storage worklet code
function convertContentIdToBucket(campaignId){
// Generate aggregation key
}
// The scale factor is multiplied by the aggregatable value to
// maximize the signal-to-noise ratio. See "Noise and scaling"
// section in the Aggregation Fundamentals document to learn more.
const SCALE_FACTOR = 65536;
class ReachMeasurementOperation {
async run(data) {
const key = 'has-reported-content';
// Read the flag from Shared Storage
const hasReportedContent = await sharedStorage.get(key) === 'true';
// Don't send report if the flag is set
if (hasReportedContent) {
return;
}
// Send histogram report
// Set the aggregation key in `bucket`
// Bucket examples: 54153254n or BigInt(54153254)
// Set the scaled aggregatable value in `value`
privateAggregation.contributeToHistogram({
bucket: convertContentIdToBucket(data.contentId),
value: 1 * SCALE_FACTOR
});
// Set the flag in Shared Storage
await sharedStorage.set(key, true);
}
}
register('reach-measurement', ReachMeasurementOperation);
ตัวอย่างโค้ดก่อนหน้านี้จะเรียกใช้การรวมข้อมูลส่วนตัวทุกครั้งที่โหลดเนื้อหา iframe จากหลายเว็บไซต์ โค้ด iframe จะโหลดชิ้นงาน และชิ้นงานจะเรียกใช้ Private Aggregation API โดยแปลงรหัสเนื้อหาเป็นคีย์การรวมข้อมูล (ที่เก็บข้อมูล)
contributeToHistogramOnEvent()
ในชิ้นงาน Protected Audience API เท่านั้น เราจะจัดเตรียมกลไกที่ทำงานตามทริกเกอร์เพื่อส่งรายงานเฉพาะในกรณีที่เกิดเหตุการณ์หนึ่งๆ เท่านั้น ฟังก์ชันนี้ยังช่วยให้ที่เก็บข้อมูลและค่าขึ้นอยู่กับสัญญาณที่ยังไม่พร้อมใช้งาน ณ จุดนั้นในการประมูล
เมธอด privateAggregation.contributeToHistogramOnEvent(eventType, contribution)
จะรับ eventType
ที่ระบุเหตุการณ์เรียกให้แสดง และ contribution
ที่ส่งเมื่อมีการเรียกเหตุการณ์ให้แสดง เหตุการณ์เรียกให้แสดงอาจมาจากตัวการประมูลเองหลังจากการประมูลสิ้นสุดลง เช่น เหตุการณ์ชนะหรือการแพ้การประมูล หรืออาจมาจากเฟรมที่กั้นเขตซึ่งแสดงผลโฆษณา
หากต้องการส่งรายงานสำหรับเหตุการณ์การประมูล คุณสามารถใช้คีย์เวิร์ด reserved.win
, reserved.loss
และ reserved.always
ที่เราสงวนไว้ 2 คํา หากต้องการส่งรายงานที่เรียกให้แสดงโดยเหตุการณ์จากเฟรมที่มีรั้ว ให้กําหนดประเภทเหตุการณ์ที่กําหนดเอง หากต้องการทริกเกอร์เหตุการณ์จากเฟรมที่มีรั้ว ให้ใช้เมธอด fence.reportEvent()
ที่มีอยู่ใน Fenced Frames Ads Reporting API
ตัวอย่างต่อไปนี้จะส่งรายงานการแสดงผลเมื่อมีการเรียกเหตุการณ์การชนะการประมูล และส่งรายงานการคลิกหากมีการเรียกเหตุการณ์ click
จากเฟรมที่มีการกำหนดเขตซึ่งแสดงผลโฆษณา ค่า 2 รายการนี้ใช้คํานวณอัตราการคลิกผ่านได้
function generateBid(interestGroup, auctionSignals, perBuyerSignals, trustedBiddingSignals, browserSignals) {
// …
privateAggregation.contributeToHistogramOnEvent("reserved.win", {
bucket: getImpressionReportBucket(),
value: 1
});
privateAggregation.contributeToHistogramOnEvent("click", {
bucket: getClickReportBuckets(), // 128-bit integer as BigInt
value: 1
});
ดูข้อมูลเพิ่มเติมได้ที่คําอธิบายการรายงานการรวมข้อมูลส่วนตัวแบบขยาย
enableDebugMode()
แม้ว่าคุกกี้ของบุคคลที่สามจะยังคงใช้งานได้อยู่ แต่เราจะจัดเตรียมกลไกชั่วคราวที่ช่วยให้แก้ไขข้อบกพร่องและทดสอบได้ง่ายขึ้นด้วยการเปิดใช้โหมดแก้ไขข้อบกพร่อง รายงานการแก้ไขข้อบกพร่องมีประโยชน์ในการเปรียบเทียบการวัดผลที่อิงตามคุกกี้กับการวัดผลแบบรวมข้อมูลส่วนตัว และยังช่วยให้คุณตรวจสอบการผสานรวม API ได้อย่างรวดเร็ว
การเรียกใช้ privateAggregation.enableDebugMode()
ในเวิร์กเลตจะเปิดใช้โหมดแก้ไขข้อบกพร่อง ซึ่งทําให้รายงานที่รวบรวมได้รวมเพย์โหลดที่ไม่ได้เข้ารหัส (ข้อความธรรมดา) จากนั้นประมวลผลเพย์โหลดเหล่านี้ด้วยเครื่องมือทดสอบในเครื่องของบริการรวมข้อมูล
โหมดแก้ไขข้อบกพร่องมีไว้สำหรับผู้เรียกที่ได้รับอนุญาตให้เข้าถึงคุกกี้ของบุคคลที่สามเท่านั้น หากผู้เรียกใช้ไม่มีสิทธิ์เข้าถึงคุกกี้ของบุคคลที่สาม enableDebugMode()
จะดำเนินการไม่สําเร็จโดยอัตโนมัติ
นอกจากนี้ คุณยังตั้งค่าคีย์การแก้ไขข้อบกพร่องได้โดยเรียกใช้ privateAggregation.enableDebugMode({ <debugKey: debugKey> })
โดยที่ BigInt
สามารถใช้เป็นคีย์การแก้ไขข้อบกพร่องได้ คุณสามารถใช้คีย์แก้ไขข้อบกพร่องเพื่อเชื่อมโยงข้อมูลจากการวัดผลที่อิงตามคุกกี้และข้อมูลจากการวัดผลแบบรวมข้อมูลส่วนตัว
โดยเรียกได้เพียงครั้งเดียวต่อบริบท การเรียกใช้ครั้งต่อๆ ไปจะทำให้เกิดข้อยกเว้น
// Enables debug mode
privateAggregation.enableDebugMode();
// Enables debug mode and sets a debug key
privateAggregation.enableDebugMode({ debugKey: BigInt(1234) });
การยืนยันรายงาน
Private Aggregation API ช่วยให้วัดผลข้ามเว็บไซต์ได้ในขณะที่ปกป้องความเป็นส่วนตัวของผู้ใช้ อย่างไรก็ตาม ผู้ไม่ประสงค์ดีอาจพยายามบิดเบือนความแม่นยำของการวัดเหล่านี้ คุณสามารถใช้รหัสบริบทเพื่อยืนยันความถูกต้องของรายงานเพื่อป้องกันไม่ให้เกิดกรณีเช่นนี้
การตั้งค่ารหัสบริบทช่วยให้มั่นใจได้ว่าข้อมูลจะถูกต้องเมื่อนำไปรวมกับผลลัพธ์รวมสุดท้าย ซึ่งทำได้ด้วยวิธีต่อไปนี้
- การป้องกันรายงานที่ผิดกฎหมายหรือไม่ถูกต้อง: ตรวจสอบว่ารายงานสร้างขึ้นผ่านการเรียก API ที่ถูกต้องและน่าเชื่อถือ ซึ่งทำให้ผู้ไม่ประสงค์ดีปลอมแปลงรายงานได้ยาก
- การป้องกันการเล่นรายงานซ้ำ: ตรวจหาและปฏิเสธการพยายามใช้รายงานเก่าซ้ำ ช่วยให้มั่นใจว่าแต่ละรายงานจะส่งผลต่อผลลัพธ์รวมเพียงครั้งเดียว
พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน
เมื่อใช้พื้นที่เก็บข้อมูลที่ใช้ร่วมกันเพื่อเรียกใช้การดำเนินการที่ส่งรายงานแบบรวมได้ คุณจะตั้งค่ารหัสที่คาดเดาไม่ได้นอกเวิร์กเลตได้
รหัสนี้จะฝังอยู่ในรายงานที่สร้างจากชิ้นงาน คุณสามารถระบุค่านี้เมื่อเรียกใช้เมธอดพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน run()
หรือ selectURL()
ภายในออบเจ็กต์ตัวเลือกภายใต้คีย์ privateAggregationConfig
เช่น
sharedStorage.run('measurement-operation', {
privateAggregationConfig: {
contextId: 'exampleId123456789abcdeFGHijk'
}
});
หลังจากตั้งค่ารหัสนี้แล้ว คุณจะใช้รหัสดังกล่าวเพื่อยืนยันว่ารายงานส่งมาจากการดำเนินการในระบบพื้นที่เก็บข้อมูลที่ใช้ร่วมกันได้ ระบบจะส่งรายงานเพียง 1 ฉบับต่อการดำเนินการใน Shared Storage (แม้ว่าจะไม่มีการส่งข้อมูลก็ตาม) เพื่อป้องกันไม่ให้ข้อมูลรั่วไหล โดยไม่คำนึงถึงจํานวนการเรียกใช้ contributeToHistogram()
Private Aggregation API จะส่งรายงานที่รวบรวมได้โดยมีเวลาหน่วงแบบสุ่มสูงสุด 1 ชั่วโมง อย่างไรก็ตาม การตั้งค่ารหัสบริบทเพื่อยืนยันรายงานจะช่วยลดความล่าช้านี้ ในกรณีนี้ การหน่วงเวลาจะลดลงเป็น 5 วินาทีแบบคงที่นับจากเวลาที่เริ่มการดำเนินการกับพื้นที่เก็บข้อมูลร่วมกัน

ตัวอย่างเวิร์กโฟลว์ (ดังที่แสดงในแผนภาพด้านบน)
- ระบบจะเรียกใช้การดำเนินการของพื้นที่เก็บข้อมูลที่ใช้ร่วมกันด้วยการกำหนดค่าการรวมข้อมูลส่วนตัว โดยระบุรหัสบริบทและสร้างรายงานที่รวบรวมได้
- รหัสบริบทจะฝังอยู่ในรายงานแบบรวมที่สร้างขึ้นซึ่งส่งไปยังเซิร์ฟเวอร์ของคุณ
- เซิร์ฟเวอร์จะรวบรวมรายงานที่รวบรวมได้ซึ่งสร้างขึ้น
- กระบวนการในเซิร์ฟเวอร์จะตรวจสอบรหัสบริบทในรายงานที่รวบรวมข้อมูลได้แต่ละรายการเทียบกับรหัสบริบทที่เก็บไว้เพื่อให้แน่ใจว่าถูกต้องก่อนที่จะจัดกลุ่มรายงานและส่งไปยังบริการรวมข้อมูล
การยืนยันรหัสบริบท
รายงานขาเข้าไปยังเซิร์ฟเวอร์รวบรวมข้อมูลสามารถยืนยันได้หลายวิธีก่อนที่จะส่งไปยังบริการรวมข้อมูล รายงานที่มีรหัสบริบทไม่ถูกต้องอาจถูกปฏิเสธได้ในกรณีต่อไปนี้
- ไม่ทราบ: หากมีรายงานเข้ามาพร้อมรหัสบริบทที่ระบบของคุณไม่ได้สร้างขึ้น คุณสามารถทิ้งรายงานได้ ซึ่งจะช่วยป้องกันผู้ไม่รู้จักหรือผู้ไม่ประสงค์ดีจากการแทรกข้อมูลลงในไปป์ไลน์การรวม
- รายการที่ซ้ำกัน: หากคุณได้รับรายงาน 2 รายการ (หรือมากกว่า) ที่มีรหัสบริบทเดียวกัน หมายความว่าคุณต้องเลือกรายงานที่จะทิ้ง
- แจ้งว่าเป็นสแปมในการตรวจจับสแปม:
- หากตรวจพบกิจกรรมที่น่าสงสัยจากผู้ใช้ เช่น การเปลี่ยนแปลงอย่างฉับพลันในกิจกรรมของผู้ใช้ขณะประมวลผลรายงาน คุณสามารถทิ้งรายงานได้
- คุณสามารถจัดเก็บรายงานพร้อมกับรหัสบริบทและสัญญาณที่เกี่ยวข้อง (เช่น User Agent, แหล่งที่มาของอ้างอิง ฯลฯ) ต่อมา เมื่อวิเคราะห์พฤติกรรมของผู้ใช้และระบุตัวบ่งชี้สแปมใหม่ คุณจะประเมินรายงานที่เก็บไว้อีกครั้งได้โดยอิงตามรหัสบริบทและสัญญาณที่เกี่ยวข้อง ซึ่งจะช่วยให้คุณทิ้งรายงานจากผู้ใช้ที่แสดงกิจกรรมที่น่าสงสัยได้ แม้ว่าจะไม่มีการแจ้งว่าน่าสงสัยในตอนแรกก็ตาม
มีส่วนร่วมและแชร์ความคิดเห็น
Private Aggregation API อยู่ระหว่างการหารือและอาจมีการเปลี่ยนแปลงในอนาคต หากคุณลองใช้ API นี้แล้วและมีข้อเสนอแนะ เรายินดีรับฟัง
- GitHub: อ่านคำอธิบาย ตั้งคำถามและเข้าร่วมการสนทนา
- การสนับสนุนนักพัฒนาซอฟต์แวร์: ถามคําถามและเข้าร่วมการสนทนาในที่เก็บข้อมูลการสนับสนุนนักพัฒนาซอฟต์แวร์ของ Privacy Sandbox
- เข้าร่วมกลุ่ม Shared Storage API และกลุ่ม Protected Audience API เพื่อรับประกาศล่าสุดเกี่ยวกับ Private Aggregation