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

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

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

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

提案 状态
针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明		 可用
跨 Attribution Reporting API、Private Aggregation API 为 Google Cloud 提供汇总服务支持
说明文档		 可用
汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。若要汇总多个源站，这些源站必须属于同一个网站。
GitHub 上的常见问题解答
网站汇总 API 文档 		可用
汇总服务的 epsilon 值将保持一个不超过 64 的范围，以方便对不同参数的实验和反馈。
提交 ARA 小数值反馈。
提交 PAA 小数值反馈。		 可用。在更新 epsilon 范围值之前，我们会提前通知整个生态系统。
为汇总服务查询提供更灵活的贡献过滤功能
解说		 可用
灾难后（错误、配置错误等）的预算恢复流程
解说		 提供
机制，用于审核广告技术平台使用预算挽回功能找回的共享 ID 所占百分比，以及针对 2025 年上半年计划恢复的过多账号恢复请求暂停未来恢复机制
Accenture 是 AWS 协调者之一
开发者博客		 可用
担任 Google Cloud 协调员之一的独立方
开发者博客		 可用
汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明		 可用

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

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

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

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

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

สภาพแวดล้อมการดำเนินการที่เชื่อถือได้ คือ การกำหนดค่าพิเศษของฮาร์ดแวร์และซอฟต์แวร์คอมพิวเตอร์ที่อนุญาตให้ ต้องยืนยันเวอร์ชันของซอฟต์แวร์ที่ทำงานบนคอมพิวเตอร์ TEE อนุญาตให้บุคคลภายนอกตรวจสอบได้ว่าซอฟต์แวร์ทํางานตามที่ผู้ผลิตซอฟต์แวร์กล่าวอ้างไว้ทุกประการ

ดูข้อมูลเพิ่มเติมเกี่ยวกับ TEE ที่ใช้สำหรับข้อเสนอ Privacy Sandbox ได้ที่คำอธิบายบริการ 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 รายงานสรุปประกอบด้วยข้อมูลผู้ใช้แบบรวมและอาจมีข้อมูล Conversion โดยละเอียดพร้อมด้วยข้อมูลรบกวน รายงานสรุปประกอบด้วยรายงานสรุป รายงานสรุปมีความยืดหยุ่นมากกว่าและมีโมเดลข้อมูลที่สมบูรณ์กว่าการรายงานระดับเหตุการณ์ โดยเฉพาะสําหรับกรณีการใช้งานบางรายการ เช่น ค่า Conversion
举报来源

ที่มาของการรายงานคือเอนทิตีที่ได้รับรายงานที่รวบรวมได้ ซึ่งก็คือเทคโนโลยีโฆษณา ซึ่งเรียกว่า Attribution Reporting API รายงานที่รวบรวมได้จะส่งมาจาก อุปกรณ์ของผู้ใช้ไปยัง URL ที่รู้จักกันดีซึ่งเชื่อมโยงกับการรายงาน คุณควรกำหนดแหล่งที่มาของการรายงานนี้ระหว่างการลงทะเบียน
贡献债券 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“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 โปรดดูส่วนเริ่มต้นใช้งาน หรือหากต้องการข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้งานบริการรวบรวมข้อมูลที่ติดตั้งใช้งานแล้ว ให้ไปที่ลิงก์นี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานบริการรวบรวมข้อมูล

การแก้ปัญหา

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

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