บริการรวบรวมข้อมูล

บริการรวบรวมข้อมูลจะสร้างรายงานสรุปของข้อมูล Conversion แบบละเอียดและการวัดการเข้าถึงจากรายงานดิบแบบรวมได้ เทคโนโลยีโฆษณามีจุดแรกเข้าแบบรวมข้อมูลหลัก 2 จุดฝั่งไคลเอ็นต์เพื่อส่งรายงานไปยังบริการรวบรวมข้อมูลผ่าน Attribution Reporting API หรือ Private Aggregation API

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

ความพร้อมใช้งาน

ข้อเสนอ สถานะ
การรองรับบริการรวบรวมข้อมูลสําหรับ Amazon Web Services (AWS) ใน Attribution Reporting API, Private Aggregation API
คําอธิบาย		 ใช้งานได้
การรองรับบริการรวบรวมข้อมูลสําหรับ Google Cloud ใน Attribution Reporting API, Private Aggregation API
คําอธิบาย		 ใช้งานได้
การลงทะเบียนเว็บไซต์บริการรวมข้อมูลและการรวมหลายต้นทาง การลงทะเบียนเว็บไซต์รวมถึงการแมปเว็บไซต์กับบัญชีระบบคลาวด์ (AWS หรือ GCP) หากต้องการรวมหลายต้นทาง แหล่งที่มาเหล่านั้นต้องอยู่ในเว็บไซต์เดียวกัน
คำถามที่พบบ่อยเกี่ยวกับ GitHub
เอกสารประกอบของ Site Aggregation API 		ใช้งานได้
ค่า epsilon ของบริการรวมจะเก็บเป็นช่วงสูงสุด 64 เพื่ออำนวยความสะดวกในการทดสอบและแสดงความคิดเห็นเกี่ยวกับพารามิเตอร์ต่างๆ
ส่งความคิดเห็นเกี่ยวกับ ARA epsilon
ส่งความคิดเห็นเกี่ยวกับ Epsilon ของ PAA		 มีให้บริการ เราจะประกาศแจ้งล่วงหน้าให้ระบบนิเวศทราบก่อนที่จะอัปเดตค่าช่วงของ Epsilon
การกรองข้อมูลที่ส่งเข้ามามีความยืดหยุ่นมากขึ้นสําหรับการค้นหาบริการรวมข้อมูล
คําอธิบาย		 ใช้งานได้
กระบวนการสำหรับการกู้คืนงบประมาณหลังเกิดภัยพิบัติ (ข้อผิดพลาด การกำหนดค่าที่ไม่ถูกต้อง และอื่นๆ)
คำอธิบาย		 พร้อมใช้งาน
กลไกในการตรวจสอบเปอร์เซ็นต์ของรหัสที่แชร์ซึ่งเทคโนโลยีโฆษณากู้คืนโดยใช้การกู้คืนงบประมาณและระงับการกู้คืนในอนาคตสำหรับการกู้คืนที่มากเกินไปซึ่งวางแผนไว้สำหรับครึ่งปีแรก 2025
Accenture ดำเนินการในฐานะผู้ประสานงานบน AWS
บล็อกนักพัฒนาซอฟต์แวร์		 ใช้งานได้
บุคคลภายนอกที่ทำงานเป็นผู้ประสานงานใน Google Cloud
บล็อกนักพัฒนาซอฟต์แวร์		 ใช้งานได้
การสนับสนุนบริการรวมข้อมูลสำหรับการรายงานการแก้ไขข้อบกพร่องรวมบน Attribution Reporting API
คำอธิบาย		 ใช้งานได้

คําศัพท์และแนวคิดสําคัญ

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

术语 说明
汇总服务 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
可汇总的报告

可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。

详细了解可汇总的报告。
可汇总报告的会计核算 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。
可汇总报告的会计核算预算 对预算的引用，用于确保报告不会被处理多次。
可信执行环境 (TEE)

可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。

如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。
协调员

ผู้ประสานงานคือหน่วยงานที่รับผิดชอบด้านการจัดการคีย์และการทําบัญชีรายงานสรุปได้ ผู้ประสานงานจะเก็บรักษารายการแฮชของการกำหนดค่าบริการรวบรวมข้อมูลที่ได้รับอนุมัติ และกำหนดค่าการเข้าถึงคีย์การถอดรหัส
共享 ID 计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。
举报来源

报告来源是接收可汇总报告的实体，也就是调用 Attribution Reporting API 的广告技术平台。可汇总报告的来源 将用户设备转到与报告关联的已知网址 来源。此报告来源应在注册期间指定。
贡献债券 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。
噪声和缩放 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。
证明

认证是一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务方案，证明会将广告技术平台运营的汇总服务中运行的代码与开放源代码进行匹配。

详细了解证明。

อ่านข้อมูลเพิ่มเติมเกี่ยวกับเบื้องหลังของบริการรวบรวมข้อมูลได้ในคำอธิบายและรายการข้อกำหนดฉบับเต็ม

Use Case การรวมข้อมูล

พิจารณาเส้นทางของนักพัฒนาซอฟต์แวร์ต่อไปนี้สําหรับการวัดโฆษณาและไลบรารีไคลเอ็นต์การวัดที่สอดคล้องกัน

กรณีการใช้งาน จุดแรกเข้า คำอธิบาย
การเพิ่มประสิทธิภาพการเสนอราคา Attribution Reporting API (Chrome และ Android) ใช้รายงานแบบรวมเพื่อส่งผ่านสัญญาณ Conversion เพื่อวัตถุประสงค์ในการเพิ่มประสิทธิภาพการเสนอราคา
การวัดผลข้ามแพลตฟอร์ม Attribution Reporting API (Chrome และ Android) ใช้ความสามารถในการวัดผลในเว็บและแอปต่างๆ เพื่อดูประสิทธิภาพใน Chrome และ Android
การรายงาน Conversion Attribution Reporting API (Chrome และ Android) สร้างการรายงาน Conversion แบบรวมที่ปรับให้เหมาะกับความต้องการแคมเปญของลูกค้า (รวมถึง CTC และ VTC)
การวัดการเข้าถึงแคมเปญ Shared Storage API และ Private Aggregation API (Chrome) ใช้ตัวแปรการแสดงโฆษณาข้ามเว็บไซต์เพื่อวัดการเข้าถึงของแคมเปญ
การรายงานข้อมูลประชากร Shared Storage API และ Private Aggregation API (Chrome) ใช้การแสดงโฆษณาข้ามเว็บไซต์และข้อมูลประชากรเพื่อวัดการเข้าถึงตามข้อมูลประชากร
การวิเคราะห์เส้นทาง Conversion Shared Storage API และ Private Aggregation API (Chrome) จัดเก็บการแสดงโฆษณาข้ามเว็บไซต์และตัวแปร Conversion เพื่อทําการวิเคราะห์เส้นทาง Conversion แบบรวม
Brand Lift และ Conversion Lift Shared Storage API และ Private Aggregation API (Chrome) การรายงานเกี่ยวกับกลุ่มทดสอบ/กลุ่มควบคุมและข้อมูลการสำรวจเพื่อวัด Brand Lift และส่วนเพิ่ม
การแก้ไขข้อบกพร่องของการประมูล Protected Audience API และ Private Aggregation API (Chrome) ใช้รายงานแบบรวมเพื่อแก้ไขข้อบกพร่อง
การกระจายราคาเสนอ Protected Audience API และ Private Aggregation API (Chrome) ใช้รายงานแบบรวมเพื่อบันทึกการแจกแจงมูลค่าการเสนอราคาสำหรับการประมูล

ขั้นตอนจากต้นทางถึงปลายทาง

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

ขั้นตอนบริการรวมข้อมูลจากต้นทางถึงปลายทาง

  1. ดึงข้อมูลคีย์สาธารณะเพื่อสร้างรายงานที่เข้ารหัส
  2. รายงานที่เข้ารหัสซึ่งรวบรวมได้ซึ่งส่งไปยังเซิร์ฟเวอร์เทคโนโลยีโฆษณาเพื่อรวบรวม เปลี่ยนรูปแบบ และจัดกลุ่ม
  3. เซิร์ฟเวอร์เทคโนโลยีโฆษณาจะจัดกลุ่มรายงาน (รูปแบบ avro) และส่งไปยังบริการรวบรวมข้อมูลที่ติดตั้งใช้งาน (ต้องดำเนินการโดยเทคโนโลยีโฆษณา)
  4. เรียกข้อมูลรายงานรวมเพื่อถอดรหัส
  5. เรียกข้อมูลคีย์การถอดรหัสจากผู้ประสานงาน
  6. บริการรวมข้อมูลจะถอดรหัสรายงานเพื่อรวบรวมข้อมูลและสร้างสัญญาณรบกวน
  7. บริการบัญชีของรายงานที่รวบรวมได้จะตรวจสอบว่ายังมีงบประมาณความเป็นส่วนตัวเหลืออยู่หรือไม่เพื่อสร้างรายงานสรุปสําหรับรายงานที่รวบรวมได้
  8. ส่งรายงานสรุปขั้นสุดท้าย

จากแผนภาพนี้ คุณจะเห็นว่าบริการรวบรวมข้อมูลมีความสัมพันธ์โดยรวมอย่างไรกับ API การวัดผลไคลเอ็นต์หลักอย่าง Attribution Reporting API, Private Aggregation API และผู้ประสานงาน

ขั้นตอนเริ่มต้นด้วย Measurement API ต่างๆ เช่น Attribution Reporting API หรือ Private Aggregation API ที่สร้างรายงานจากอินสแตนซ์เบราว์เซอร์หลายรายการ Chrome จะนำคีย์สาธารณะจากบริการโฮสติ้งคีย์ใน Coordinator มาใช้เข้ารหัสรายงานก่อนที่จะส่งไปยังต้นทางการรายงานของเทคโนโลยีโฆษณา คีย์สาธารณะจะหมุนเวียนทุก 7 วัน

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

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

ปลายทางแหล่งที่มาของการรายงานเทคโนโลยีโฆษณาที่รวบรวมรายงานจะโฮสต์โดยเทคโนโลยีโฆษณา และบริการรวบรวมข้อมูลจะติดตั้งใช้งานในระบบคลาวด์ของเทคโนโลยีโฆษณา

การรวมรายงานที่รวมได้

ขั้นตอนการรายงานจะไม่สมบูรณ์หากไม่มีความช่วยเหลือจากเซิร์ฟเวอร์ต้นทางการรายงานที่กําหนด นี่คือต้นทางที่เทคโนโลยีโฆษณาจะส่งในกระบวนการลงทะเบียน การดำเนินการหลักที่แหล่งที่มาของการรายงานมีหน้าที่รับผิดชอบคือรวบรวม เปลี่ยนรูปแบบ และจัดกลุ่มรายงานที่รวบรวมได้ และเตรียมรายงานดังกล่าวเพื่อส่งไปยังบริการรวบรวมข้อมูลของเทคโนโลยีโฆษณาที่ติดตั้งใช้งานใน Google Cloud หรือ Amazon Web Services อ่านเพิ่มเติมเกี่ยวกับวิธีเตรียมรายงานที่รวบรวมได้

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

คอมโพเนนต์ระบบคลาวด์

บริการรวบรวมข้อมูลประกอบด้วยคอมโพเนนต์บริการระบบคลาวด์ต่างๆ สคริปต์ Terraform ที่ระบุจะจัดสรรและกําหนดค่าคอมโพเนนต์บริการระบบคลาวด์ที่จําเป็นทั้งหมด

คอมโพเนนต์ระบบคลาวด์ของบริการรวมข้อมูล

บริการ Frontend

บริการระบบคลาวด์ที่มีการจัดการ: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

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

บริการฟรอนต์เอนด์มี API 2 รายการ ได้แก่

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

ดูเอกสารประกอบของ Aggregation Service API

คิวงาน

บริการระบบคลาวด์ที่มีการจัดการ: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

คิวงานคือคิวข้อความที่จัดเก็บคําของานสําหรับบริการรวบรวมข้อมูล บริการส่วนหน้าจะแทรกข้อความคําของานลงในคิว จากนั้น Aggregation Worker จะใช้ข้อความดังกล่าวเพื่อประมวลผลคําของาน

Cloud Storage

บริการระบบคลาวด์ที่มีการจัดการ: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) ใช้พื้นที่เก็บข้อมูลระบบคลาวด์เพื่อจัดเก็บไฟล์อินพุตและเอาต์พุตที่บริการรวบรวมข้อมูลใช้ (เช่น ไฟล์รายงานที่เข้ารหัส รายงานสรุปเอาต์พุต ฯลฯ)

ฐานข้อมูลข้อมูลเมตาของงาน

บริการระบบคลาวด์ที่มีการจัดการ: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

ฐานข้อมูลข้อมูลเมตาของงานจะจัดเก็บและติดตามสถานะงานการรวม ฐานข้อมูลจะบันทึกข้อมูลเมตา เช่น เวลาสร้าง เวลาขอ เวลาอัปเดต และสถานะ (เช่น ได้รับ อยู่ระหว่างดำเนินการ เสร็จสิ้น ฯลฯ) Aggregation Worker จะอัปเดตฐานข้อมูลข้อมูลเมตาของงานเมื่องานดำเนินการ

ผู้ปฏิบัติงานการรวมข้อมูล

บริการระบบคลาวด์ที่มีการจัดการ: Compute Engine ที่มีพื้นที่เก็บข้อมูลลับ (Google Cloud) / Amazon Web Services EC2 ที่มี Nitro Enclave (Amazon Web Services)

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

เวิร์กเกอร์จะทํางานภายในอินสแตนซ์ Trusted Execution Environment (TEE) ผู้ปฏิบัติงานแต่ละคนจะจัดการงานได้ครั้งละ 1 งานเท่านั้น เทคโนโลยีโฆษณาสามารถกําหนดค่าผู้ปฏิบัติงานหลายรายให้ประมวลผลงานพร้อมกันได้โดยการตั้งค่าการปรับขนาดอัตโนมัติ การปรับขนาดอัตโนมัติจะปรับจำนวนผู้ปฏิบัติงานตามจำนวนข้อความที่เหลืออยู่ในคิวงาน คุณสามารถกำหนดค่าจำนวนผู้ปฏิบัติงานขั้นต่ำและสูงสุดสำหรับการปรับขนาดอัตโนมัติผ่านไฟล์สภาพแวดล้อม Terraform ดูข้อมูลเพิ่มเติมเกี่ยวกับการปรับขนาดอัตโนมัติได้ในสคริปต์ Terraform ต่อไปนี้ [Amazon Web Services / Google Cloud]

Aggregation Worker จะเรียกใช้บริการการบัญชีรายงานแบบรวมสำหรับการบัญชีรายงานแบบรวม บริการบัญชีรายงานแบบรวมจะตรวจสอบว่าระบบจะเรียกใช้งานเฉพาะในกรณีที่ยังไม่ใช้งบประมาณความเป็นส่วนตัวเกินขีดจํากัดเท่านั้น (ดูกฎ"ไม่ซ้ำกัน") หากมีงบประมาณ ระบบจะสร้างรายงานสรุปโดยใช้ข้อมูลสรุปรวมที่มีสัญญาณรบกวน อ่านรายละเอียดเพิ่มเติมเกี่ยวกับการบัญชีรายงานแบบรวม

Aggregation Worker จะอัปเดตข้อมูลเมตาของงานในฐานข้อมูลข้อมูลเมตาของงาน รวมถึงรหัสผลลัพธ์ของงานที่เหมาะสมและตัวนับข้อผิดพลาดของรายงานในกรณีที่รายงานบางส่วนไม่สำเร็จ ผู้ใช้สามารถดึงข้อมูลสถานะได้โดยใช้ API การดึงข้อมูลสถานะงาน (getJob)

ดูคำอธิบายโดยละเอียดของบริการรวบรวมข้อมูลได้ที่คำอธิบาย

ขั้นตอนถัดไป

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

การแก้ปัญหา

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

รับการสนับสนุนและแสดงความคิดเห็น