ภาพรวม 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

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

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

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

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

เช่น

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

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

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

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

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

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

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

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

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

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

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