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

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

หน้านี้ถือว่าคุณเป็นผู้เชี่ยวชาญด้านเทคโนโลยีโฆษณา โดยจะครอบคลุมหัวข้อต่อไปนี้

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

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

ข้อเสนอ สถานะ
บริการงบประมาณด้านความเป็นส่วนตัวข้ามระบบคลาวด์
คำอธิบาย		 ใช้งานได้
การรองรับบริการรวบรวมข้อมูลสําหรับ 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
ส่งความคิดเห็นเกี่ยวกับ PAA epsilon		 มีให้บริการ เราจะแจ้งให้ระบบนิเวศทราบล่วงหน้าก่อนที่จะอัปเดตค่าช่วง epsilon
การกรองข้อมูลที่ส่งเข้ามาให้มีความยืดหยุ่นมากขึ้นสำหรับคำค้นหาบริการรวมข้อมูล
คำอธิบาย		 ใช้งานได้
กระบวนการกู้คืนงบประมาณหลังเกิดภัยพิบัติ (ข้อผิดพลาด การกำหนดค่าที่ไม่ถูกต้อง และอื่นๆ)
คำอธิบาย		 พร้อมใช้งาน
กลไกในการตรวจสอบเปอร์เซ็นต์ของรหัสที่แชร์ซึ่งเทคโนโลยีโฆษณากู้คืนโดยใช้การกู้คืนงบประมาณและระงับการกู้คืนในอนาคตสำหรับการกู้คืนที่มากเกินไปซึ่งวางแผนไว้สำหรับครึ่งปีแรก 2025
Accenture ดําเนินการในฐานะผู้ประสานงานรายหนึ่งใน AWS
บล็อกนักพัฒนาซอฟต์แวร์		 ใช้งานได้
บุคคลภายนอกที่ทำงานเป็นผู้ประสานงานใน Google Cloud
บล็อกนักพัฒนาซอฟต์แวร์		 ใช้งานได้
การรองรับบริการรวมข้อมูลสําหรับการรายงานการแก้ไขข้อบกพร่องแบบรวมใน Attribution Reporting API
คําอธิบาย		 ใช้งานได้
บริการคีย์การเข้ารหัสข้ามระบบคลาวด์
คำอธิบาย		 คาดว่าจะพร้อมให้บริการในช่วงครึ่งแรกของปี 2025

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

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

อภิธานศัพท์

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

Aggregatable reports are encrypted reports sent from individual user devices. These reports contain data about cross-site user behavior and conversions. Conversions (sometimes called attribution trigger events) and associated metrics are defined by the advertiser or ad tech. Each report is encrypted to prevent various parties from accessing the underlying data.

Learn more about aggregatable reports.

การบัญชีรายงานที่รวบรวมได้

分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系。

งบประมาณการบัญชีของรายงานที่รวบรวมได้

对预算的引用，用于确保不会对单个报告进行多次处理。

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

บริการที่ดำเนินการโดยเทคโนโลยีโฆษณาซึ่งประมวลผลรายงานที่รวบรวมได้เพื่อสร้างรายงานสรุป

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

การรับรอง

A mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in your ad tech-operated aggregation service with the open source code.

Read more about attestation.

การเชื่อมโยงการมีส่วนร่วม
ผู้ประสานงาน

Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.

เสียงรบกวนและการปรับขนาด

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

อ่านเพิ่มเติมเกี่ยวกับกลไกการเพิ่มสัญญาณรบกวนซึ่งดึงมาจากการแจกแจง Laplace

ที่มาของการรายงาน

接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。

รหัสที่แชร์

ค่าที่คำนวณแล้วซึ่งประกอบด้วย shared_info, reporting_origin, destination_site (สําหรับ Attribution Reporting API เท่านั้น), source_registration-time (สําหรับ Attribution Reporting API เท่านั้น), scheduled_report_time และเวอร์ชัน

รายงานหลายรายการที่ใช้แอตทริบิวต์เดียวกันในช่อง shared_info ควรมีรหัสที่แชร์เดียวกัน รหัสที่แชร์มีบทบาทสําคัญในบัญชีรายงานที่รวบรวมได้

อ่านเพิ่มเติมเกี่ยวกับเซิร์ฟเวอร์ที่เชื่อถือได้

รายงานสรุป

Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。

สภาพแวดล้อมการดำเนินการที่เชื่อถือได้ (TEE)

计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。

如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。

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. Aggregation Worker จะดึงข้อมูลรายงานแบบรวมเพื่อถอดรหัส
  5. เวิร์กเกอร์การรวมข้อมูลจะดึงข้อมูลคีย์การถอดรหัสจากผู้ประสานงาน
  6. Aggregation Worker จะถอดรหัสรายงานเพื่อรวบรวมข้อมูลและสร้างสัญญาณรบกวน
  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)

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

บริการส่วนหน้ามี API 2 รายการ ได้แก่

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

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

คิวงาน

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

คิวงานคือคิวข้อความที่มีคําของานสําหรับบริการรวบรวมข้อมูล บริการส่วนหน้าจะแทรกคําของานลงในคิว จากนั้นผู้ปฏิบัติงานการรวมข้อมูลจะดึงข้อมูลไปใช้ประมวลผล

Cloud Storage

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

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

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

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

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

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

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

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

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

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

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

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

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

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

การแก้ปัญหา

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

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