หน้านี้ได้รับการแปลโดย Cloud Translation API

ภาพรวม Private Aggregation API

สร้างรายงานข้อมูลรวมโดยใช้ข้อมูลจากกลุ่มเป้าหมายที่ได้รับการคุ้มครองและข้อมูลจากหลายเว็บไซต์จากพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

เราสร้าง Private Aggregation API ขึ้นเพื่อรวบรวมและรายงานข้อมูลข้ามเว็บไซต์ในลักษณะที่รักษาความเป็นส่วนตัว เพื่อให้เว็บมีฟีเจอร์สําคัญที่ต้องใช้

สถานะการติดตั้งใช้งาน

ข้อเสนอ	สถานะ
ป้องกันไม่ให้รายงาน Private Aggregation API ไม่ถูกต้องด้วยการยืนยันรายงานสำหรับพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน คำอธิบาย	พร้อมใช้งานใน Chrome
ความพร้อมใช้งานของโหมดแก้ไขข้อบกพร่องการรวมข้อมูลส่วนตัวขึ้นอยู่กับการมีสิทธิ์ใช้ 3PC ปัญหาเกี่ยวกับ GitHub	พร้อมใช้งานใน Chrome M119
การลดความล่าช้าของรายงาน คำอธิบาย	พร้อมใช้งานใน Chrome M119
ระยะหมดเวลาของการมีส่วนร่วมในการรวบรวมข้อมูลส่วนตัวสำหรับพื้นที่เก็บข้อมูลที่แชร์ คำอธิบาย	พร้อมให้บริการใน M119
การรองรับ Private Aggregation API และบริการการรวมข้อมูลสําหรับ Google Cloud คําอธิบาย	พร้อมใช้งานใน Chrome M121
การถ่วงน้ำหนักสำหรับเพย์โหลดรายงานที่รวบรวมได้ คำอธิบาย	พร้อมใช้งานใน Chrome M119
โหมดแก้ไขข้อบกพร่องการรวบรวมข้อมูลส่วนตัวพร้อมใช้งานสําหรับการรายงาน auctionReportBuyers คําอธิบาย	พร้อมใช้งานใน Chrome M123
การรองรับการกรองรหัส คำอธิบาย	พร้อมใช้งานใน Chrome M128
การผสานข้อมูลที่ได้จากไคลเอ็นต์ คำอธิบาย	พร้อมใช้งานใน Chrome M129
ขีดจํากัดการมีส่วนร่วมต่อบริบท คําอธิบาย	คาดว่าจะพร้อมให้บริการในไตรมาสที่ 1 ปี 2025
งบประมาณที่มีชื่อ คำอธิบาย	คาดว่าจะพร้อมให้บริการในไตรมาสที่ 1 ปี 2025
การรายงานข้อผิดพลาดแบบรวม คําอธิบาย	คาดว่าจะพร้อมให้บริการในไตรมาสที่ 1 ปี 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 และพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน ทั้ง 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 ในอนาคต

กรณีการใช้งาน

การรวมข้อมูลส่วนตัวเป็น API อเนกประสงค์สําหรับการวัดผลข้ามเว็บไซต์ และพร้อมให้ใช้งานในเวิร์กเลต พื้นที่เก็บข้อมูลที่ใช้ร่วมกันและ Protected Audience API ขั้นตอนแรกคือตัดสินใจว่าต้องการรวบรวมข้อมูลใดโดยเฉพาะ จุดข้อมูลเหล่านั้นเป็นพื้นฐานของคีย์การรวม

มีพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

พื้นที่เก็บข้อมูลที่ใช้ร่วมกันช่วยให้คุณอ่านและเขียนข้อมูลข้ามเว็บไซต์ในสภาพแวดล้อมที่ปลอดภัยเพื่อป้องกันการรั่วไหล และ Private Aggregation API ช่วยให้คุณวัดข้อมูลข้ามเว็บไซต์ที่จัดเก็บไว้ในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันได้

การวัด Unique Reach

คุณอาจต้องวัดจํานวนผู้ใช้ที่ไม่ซ้ำซึ่งเห็นเนื้อหา Private Aggregation API สามารถให้คำตอบ เช่น "ผู้ใช้ที่ไม่ซ้ำกันประมาณ 317 คนดู Content ID 861"

คุณสามารถตั้งค่า Flag ในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันเพื่อระบุว่าผู้ใช้เคยดูเนื้อหานั้นหรือไม่ ในการเข้าชมครั้งแรกที่ไม่มีการตั้งค่าสถานะ ระบบจะเรียกใช้การรวมข้อมูลส่วนตัว จากนั้นจึงตั้งค่าสถานะ ในการเข้าชมครั้งต่อๆ ไปของผู้ใช้ ซึ่งรวมถึงการเข้าชมข้ามเว็บไซต์ คุณสามารถตรวจสอบพื้นที่เก็บข้อมูลที่ใช้ร่วมกันและข้ามการส่งรายงานไปยังการรวมข้อมูลส่วนตัวได้หากตั้งค่า Flag ไว้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้การวัดเหล่านี้ได้ในเอกสารประกอบเกี่ยวกับการเข้าถึง

การวัดข้อมูลประชากร

คุณอาจต้องวัดข้อมูลประชากรของผู้ใช้ที่ดูเนื้อหาของคุณในเว็บไซต์ต่างๆ

การรวมข้อมูลส่วนตัวสามารถให้คําตอบ เช่น "ผู้ใช้ที่ไม่ซ้ำกันประมาณ 317 คนมีอายุ 18-45 ปีและมาจากเยอรมนี" ใช้พื้นที่เก็บข้อมูลที่ใช้ร่วมกันเพื่อเข้าถึงข้อมูลประชากรจากบริบทของบุคคลที่สาม ในอนาคต คุณสามารถสร้างรายงานที่มีการรวมข้อมูลส่วนตัวได้โดยการเข้ารหัสมิติข้อมูลกลุ่มอายุและประเทศในคีย์การรวม

การวัดความถี่ K+

คุณอาจต้องการวัดจํานวนผู้ใช้ที่เห็นเนื้อหาหรือโฆษณาอย่างน้อย K ครั้งในเบราว์เซอร์หนึ่งๆ สําหรับค่า K ที่เลือกไว้ล่วงหน้า

การรวมข้อมูลส่วนตัวสามารถให้คำตอบ เช่น "ผู้ใช้ประมาณ 89 คนเห็น Content ID 581 อย่างน้อย 3 ครั้ง" ตัวนับจะเพิ่มขึ้นในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันจากเว็บไซต์ต่างๆ และสามารถอ่านได้ภายในเวิร์กเลต เมื่อจํานวนถึง K แล้ว คุณจะส่งรายงานได้โดยใช้การรวมข้อมูลส่วนตัว

การระบุแหล่งที่มาแบบมัลติทัช

คำแนะนำนี้จะเผยแพร่ในเว็บไซต์สำหรับนักพัฒนาซอฟต์แวร์เพื่อให้นักเทคโนโลยีโฆษณาเข้าใจวิธีใช้ MTA ภายในพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน + การรวมข้อมูลส่วนตัว

เมื่อใช้ Protected Audience API

Protected Audience API รองรับ Use Case ของการกำหนดเป้าหมายใหม่และกลุ่มเป้าหมายที่กำหนดเอง และการรวมข้อมูลส่วนตัวช่วยให้คุณรายงานเหตุการณ์จากเวิร์กเลตผู้ซื้อและผู้ขายได้ API นี้สามารถใช้สําหรับงานต่างๆ เช่น การวัดการแจกแจงราคาเสนอในการประมูล

จากเวิร์กเลต Protected Audience API คุณสามารถรวบรวมข้อมูลได้โดยตรงโดยใช้ contributeToHistogram() และรายงานข้อมูลตามทริกเกอร์โดยใช้ contributeToHistogramOnEvent() ซึ่งเป็นส่วนขยายพิเศษสําหรับ Protected Audience API

ฟังก์ชันที่ใช้ได้

ฟังก์ชันต่อไปนี้มีอยู่ในออบเจ็กต์ privateAggregation ที่มีอยู่ในชิ้นงานพื้นที่เก็บข้อมูลที่ใช้ร่วมกันและ 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 ที่ถูกต้องและน่าเชื่อถือ ซึ่งทำให้ผู้ไม่ประสงค์ดีปลอมแปลงรายงานได้ยาก
การป้องกันการเล่นรายงานซ้ำ: ตรวจหาและปฏิเสธการพยายามใช้รายงานเก่าซ้ำ เพื่อให้แน่ใจว่ารายงานแต่ละฉบับจะส่งผลต่อผลลัพธ์รวมเพียงครั้งเดียว

หมายเหตุ: มาตรการรักษาความปลอดภัยเหล่านี้จะแตกต่างกันไปตามบริบทที่ใช้ Private Aggregation API การยืนยันรายงานใช้ได้กับวิธีการเก็บข้อมูลแบบแชร์ run() และ selectURL() คุณจะไม่สามารถยืนยันรายงานได้หากใช้พื้นที่เก็บข้อมูลที่ใช้ร่วมกันจากภายในเฟรมที่มีการกำหนดเขตแดน หรือใช้การรวมข้อมูลส่วนตัวกับ Protected Audience API ดูข้อมูลเพิ่มเติมและเข้าร่วมการสนทนาเกี่ยวกับการใช้งานในอนาคตได้ที่คำอธิบายการยืนยันรายงาน

พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

เมื่อใช้พื้นที่เก็บข้อมูลที่ใช้ร่วมกันเพื่อเรียกใช้การดำเนินการที่ส่งรายงานแบบรวมได้ คุณจะตั้งค่ารหัสที่ไม่คาดเดาได้นอกเวิร์กเลตได้

รหัสนี้จะฝังอยู่ในรายงานที่สร้างจากชิ้นงาน คุณสามารถระบุค่านี้เมื่อเรียกใช้เมธอดพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน run() หรือ selectURL() ภายในออบเจ็กต์ตัวเลือกภายใต้คีย์ privateAggregationConfig

เช่น

sharedStorage.run('measurement-operation', {
  privateAggregationConfig: {
    contextId: 'exampleId123456789abcdeFGHijk'
  }
});

หลังจากตั้งค่ารหัสนี้แล้ว คุณจะใช้รหัสดังกล่าวเพื่อยืนยันว่ารายงานส่งมาจากการดำเนินการในระบบพื้นที่เก็บข้อมูลที่ใช้ร่วมกันได้ ระบบจะส่งรายงานเพียง 1 รายการต่อการดำเนินการกับพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน (แม้ว่าจะไม่มีการส่งข้อมูลก็ตาม) โดยไม่คำนึงถึงจํานวนการเรียกใช้ contributeToHistogram()

Private Aggregation API จะส่งรายงานที่รวบรวมได้โดยมีเวลาหน่วงแบบสุ่มสูงสุด 1 ชั่วโมง แต่การตั้งค่ารหัสบริบทเพื่อยืนยันรายงานจะช่วยลดเวลาหน่วงนี้ ในกรณีนี้ การเริ่มดำเนินการในระบบพื้นที่เก็บข้อมูลที่ใช้ร่วมกันจะมีความล่าช้าน้อยกว่า 5 วินาที

ตัวอย่างเวิร์กโฟลว์สำหรับการยืนยันรายงาน

ตัวอย่างเวิร์กโฟลว์ (ดังที่แสดงในแผนภาพด้านบน)

ระบบจะเรียกใช้การดำเนินการพื้นที่เก็บข้อมูลที่ใช้ร่วมกันด้วยการกำหนดค่าการรวมข้อมูลส่วนตัว โดยระบุรหัสบริบทและสร้างรายงานที่รวบรวมได้
รหัสบริบทจะฝังอยู่ในรายงานแบบรวมที่สร้างขึ้นซึ่งส่งไปยังเซิร์ฟเวอร์
เซิร์ฟเวอร์จะรวบรวมรายงานที่รวบรวมได้ซึ่งสร้างขึ้น
กระบวนการในเซิร์ฟเวอร์จะตรวจสอบรหัสบริบทในรายงานที่รวบรวมข้อมูลได้แต่ละรายการเทียบกับรหัสบริบทที่เก็บไว้เพื่อให้แน่ใจว่าถูกต้องก่อนที่จะจัดกลุ่มรายงานและส่งไปยังบริการรวบรวมข้อมูล

การยืนยันรหัสบริบท

รายงานขาเข้าไปยังเซิร์ฟเวอร์รวบรวมข้อมูลสามารถยืนยันได้หลายวิธีก่อนที่จะส่งไปยังบริการรวบรวมข้อมูล รายงานที่มีรหัสบริบทไม่ถูกต้องอาจถูกปฏิเสธได้ในกรณีต่อไปนี้

ไม่ทราบ: หากมีรายงานเข้ามาพร้อมรหัสบริบทที่ระบบของคุณไม่ได้สร้าง คุณสามารถทิ้งรายงานได้ วิธีนี้จะช่วยป้องกันไม่ให้ผู้ไม่รู้จักหรือผู้ไม่ประสงค์ดีแทรกข้อมูลลงในไปป์ไลน์การรวม
รายการที่ซ้ำกัน: หากคุณได้รับรายงาน 2 รายการ (หรือมากกว่า) ที่มีรหัสบริบทเดียวกัน หมายความว่าคุณต้องเลือกรายงานที่จะทิ้ง
แจ้งว่าไม่เหมาะสมในการตรวจจับสแปม:
- หากตรวจพบกิจกรรมที่น่าสงสัยจากผู้ใช้ เช่น การเปลี่ยนแปลงอย่างฉับพลันในกิจกรรมของผู้ใช้ขณะประมวลผลรายงาน คุณสามารถทิ้งรายงานได้
- คุณสามารถจัดเก็บรายงานไว้พร้อมกับรหัสบริบทและสัญญาณที่เกี่ยวข้อง (เช่น User Agent, แหล่งที่มาของอ้างอิง ฯลฯ) ต่อมา เมื่อวิเคราะห์พฤติกรรมของผู้ใช้และระบุตัวบ่งชี้สแปมใหม่ คุณจะประเมินรายงานที่เก็บไว้อีกครั้งได้โดยอิงตามรหัสบริบทและสัญญาณที่เกี่ยวข้อง ซึ่งจะช่วยให้คุณทิ้งรายงานจากผู้ใช้ที่แสดงกิจกรรมที่น่าสงสัยได้ แม้ว่าจะไม่มีการแจ้งว่าน่าสงสัยในตอนแรกก็ตาม

มีส่วนร่วมและแชร์ความคิดเห็น

Private Aggregation API อยู่ระหว่างการพูดคุยและอาจมีการเปลี่ยนแปลงในอนาคต หากคุณลองใช้ API นี้แล้วและมีข้อเสนอแนะ เรายินดีรับฟัง

GitHub: อ่านคำอธิบาย ตั้งคำถามและเข้าร่วมการสนทนา
การสนับสนุนนักพัฒนาแอป: ถามคําถามและเข้าร่วมการสนทนาในที่เก็บข้อมูลการสนับสนุนนักพัฒนาแอป Privacy Sandbox
เข้าร่วมกลุ่ม Shared Storage API และกลุ่ม Protected Audience API เพื่อรับการประกาศล่าสุดเกี่ยวกับการเก็บรวบรวมข้อมูลส่วนตัว