Dịch vụ tổng hợp

Dịch vụ tổng hợp tạo báo cáo tóm tắt về dữ liệu chi tiết về lượt chuyển đổi và số liệu đo lường phạm vi tiếp cận từ các báo cáo tổng hợp thô. Là một công nghệ quảng cáo, bạn có thể sử dụng API Báo cáo phân bổ và API Tổng hợp riêng tư, hai điểm truy cập tổng hợp chính ở phía máy khách, để chuyển báo cáo đến Dịch vụ tổng hợp và nhận báo cáo tóm tắt để phản hồi.

Trang này giả định rằng bạn là một chuyên gia về công nghệ quảng cáo. Trang này trình bày về:

Trạng thái triển khai

Phạm vi cung cấp

Proposal Status
Cross Cloud Privacy Budget Service
Explainer		 Available
Aggregation Service support for Amazon Web Services (AWS) across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service support for Google Cloud across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service site enrollment and multi-origin aggregation. Site enrollment includes mapping of a site to cloud accounts (AWS, or GCP). To aggregate multiple origins, they must be of the same site.
FAQs on GitHub
Site aggregation API documentation 		Available
The Aggregation Service's epsilon value will be kept as a range of up to 64, to facilitate experimentation and feedback on different parameters.
Submit ARA epsilon feedback.
Submit PAA epsilon feedback.		 Available. We will provide advanced notice to the ecosystem before the epsilon range values are updated.
More flexible contribution filtering for Aggregation Service queries
Explainer		 Available
Process for budget recovery post-disasters (errors, misconfigurations, and so on)
Explainer		 Available
Mechanism to review the percentage of shared IDs recovered by an ad tech using budget recovery and suspend future recoveries for excessive recoveries planned for H1 2025
Accenture operating as one of the Coordinators on AWS
Developer Blog		 Available
Independent party operating as one of the Coordinators on Google Cloud
Developer blog		 Available
Aggregation Service support for Aggregate Debug Reporting on Attribution Reporting API
Explainer		 Available

Các thuật ngữ và khái niệm chính

Nếu bạn đang cân nhắc sử dụng Dịch vụ tổng hợp cho quy trình làm việc của mình, thì các thuật ngữ và khái niệm sau đây có thể cung cấp thông tin chi tiết về những gì quy trình tổng hợp mới này có thể mang lại cho nhóm của bạn.

Bảng chú giải thuật ngữ

Báo cáo tổng hợp

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.

Hạch toán báo cáo tổng hợp

A distributed ledger, located in both coordinators, that tracks the allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures no reports pass through the Aggregation Service beyond the allocated privacy budget.

Read more on how batching strategies relate to aggregatable reports.

Ngân sách hạch toán báo cáo tổng hợp

Tham chiếu đến ngân sách để đảm bảo các báo cáo riêng lẻ không được xử lý nhiều lần.

Dịch vụ tổng hợp

An ad tech-operated service that processes aggregatable reports to create a summary report.

Read more about the Aggregation Service backstory in our explainer and the full terms list.

Chứng thực

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.

Liên kết đóng góp
Điều phối viên

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.

Tiếng ồn và tỷ lệ

Độ nhiễu thống kê được thêm vào báo cáo tóm tắt trong quá trình tổng hợp để bảo vệ quyền riêng tư và đảm bảo báo cáo cuối cùng cung cấp thông tin đo lường ẩn danh.

Đọc thêm về cơ chế nhiễu cộng thêm, được lấy từ phân phối Laplace.

Nguồn gốc của báo cáo

The entity that receives aggregatable reports—in other words, you or an ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. The reporting origin is designated during enrollment.

Mã nhận dạng chung

A computed value that consists of shared_info, reporting_origin, destination_site (for Attribution Reporting API only), source_registration-time (for Attribution Reporting API only), scheduled_report_time, and version.

Multiple reports that share the same attributes in the shared_info field should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting.

Read more about Trusted Servers.

Báo cáo Tóm tắt

An Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data, and can contain detailed conversion data with noise added. Summary reports are made up of aggregate reports. They allow for greater flexibility and provide a richer data model than event-level reporting, particularly for some use-cases like conversion values.

Môi trường thực thi đáng tin cậy (TEE)

A secure configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the machine without fear of exposure. TEEs allow external parties to verify that the software does exactly what the software manufacturer claims it does—nothing more or less.

To learn more about TEEs used for the Privacy Sandbox proposals, read the Protected Audience API services explainer and the Aggregation Service explainer.

Trường hợp sử dụng tính năng tổng hợp

Hãy xem xét các hành trình sau đây của nhà phát triển để đo lường quảng cáo và thư viện ứng dụng đo lường tương ứng.

Trường hợp sử dụng Điểm mục nhập Mô tả
Tối ưu hoá chiến lược đặt giá thầu Attribution Reporting API (Chrome và Android) Sử dụng báo cáo tổng hợp để nhập các tín hiệu lượt chuyển đổi cho mục đích tối ưu hoá chiến lược đặt giá thầu.
Đo lường trên nhiều nền tảng Attribution Reporting API (Chrome và Android) Sử dụng các tính năng đo lường trên web và ứng dụng để nắm được hiệu suất trên Chrome và Android.
Báo cáo lượt chuyển đổi Attribution Reporting API (Chrome và Android) Tạo báo cáo lượt chuyển đổi tổng hợp phù hợp với nhu cầu của khách hàng về chiến dịch (bao gồm cả CTC và VTC).
Đo lường phạm vi tiếp cận của chiến dịch Shared Storage API (API Bộ nhớ dùng chung) và Private Aggregation API (API tổng hợp riêng tư) (Chrome) Sử dụng các biến chế độ xem quảng cáo trên nhiều trang web để đo lường phạm vi tiếp cận của chiến dịch.
Báo cáo nhân khẩu học Shared Storage API (API Bộ nhớ dùng chung) và Private Aggregation API (API tổng hợp riêng tư) (Chrome) Sử dụng chế độ xem quảng cáo trên nhiều trang web và thông tin nhân khẩu học để đo lường phạm vi tiếp cận theo nhân khẩu học.
Phân tích lộ trình chuyển đổi Shared Storage API (API Bộ nhớ dùng chung) và Private Aggregation API (API tổng hợp riêng tư) (Chrome) Lưu trữ lượt xem quảng cáo và biến lượt chuyển đổi trên nhiều trang web để thực hiện phân tích đường dẫn chuyển đổi tổng hợp.
Mức tăng thương hiệu và mức tăng lượt chuyển đổi Shared Storage API (API Bộ nhớ dùng chung) và Private Aggregation API (API tổng hợp riêng tư) (Chrome) Báo cáo về nhóm thử nghiệm/nhóm đối chứng và thông tin thăm dò ý kiến để đo lường mức tăng thương hiệu và mức độ gia tăng.
Gỡ lỗi phiên đấu giá Protected Audience API và Private Aggregation API (Chrome) Sử dụng báo cáo tổng hợp để gỡ lỗi.
Phân phối giá thầu Protected Audience API và Private Aggregation API (Chrome) Sử dụng báo cáo tổng hợp để ghi lại mức phân phối giá trị giá thầu cho các phiên đấu giá.

Quy trình toàn diện

Sơ đồ sau đây cho thấy Dịch vụ tổng hợp đang hoạt động. Chúng ta sẽ tập trung vào quy trình toàn diện từ thời điểm nhận báo cáo từ web và thiết bị di động cho đến thời điểm tạo báo cáo tóm tắt trong Dịch vụ tổng hợp.

Quy trình Dịch vụ tổng hợp toàn diện
Quy trình Dịch vụ tổng hợp toàn diện
  1. Tìm nạp khoá công khai để tạo báo cáo đã mã hoá.
  2. Các báo cáo tổng hợp đã mã hoá được gửi đến máy chủ công nghệ quảng cáo để thu thập, chuyển đổi và phân lô.
  3. Máy chủ công nghệ quảng cáo phân lô các báo cáo (ở định dạng avro) rồi gửi các báo cáo đó đến Dịch vụ tổng hợp. (Bạn phải hoàn tất bước này.)
  4. Worker tổng hợp truy xuất các báo cáo tổng hợp để giải mã.
  5. Worker tổng hợp truy xuất khoá giải mã từ Trình điều phối.
  6. Aggregation Worker giải mã các báo cáo để tổng hợp và tạo nhiễu.
  7. Dịch vụ kế toán báo cáo tổng hợp sẽ kiểm tra xem có đủ ngân sách quyền riêng tư để tạo báo cáo tóm tắt cho các báo cáo tổng hợp đã cho hay không.
  8. Gửi báo cáo tóm tắt cuối cùng.

Sơ đồ này cho thấy mối quan hệ cấp cao mà Dịch vụ tổng hợp có với các API đo lường ứng dụng chính: API Báo cáo phân bổ, API Tổng hợp riêng tư và Trình điều phối.

Quy trình này bắt đầu bằng các API Đo lường, chẳng hạn như Attribution Reporting API (API Báo cáo phân bổ) hoặc Private Aggregation API (API Tổng hợp riêng tư), tạo báo cáo từ nhiều phiên bản trình duyệt. Chrome lấy khoá công khai từ Dịch vụ lưu trữ khoá trong Trình điều phối để mã hoá các báo cáo trước khi gửi các báo cáo đó đến nguồn báo cáo công nghệ quảng cáo của bạn. Các khoá công khai được xoay vòng 7 ngày một lần.

Bạn nên định cấu hình nguồn báo cáo công nghệ quảng cáo để thu thập và chuyển đổi các báo cáo đến thành định dạng avro, đồng thời gửi các báo cáo đó đến Dịch vụ tổng hợp như mô tả trong phần chiến lược phân lô.

Khi đã có một lô dữ liệu, bạn sẽ gửi yêu cầu theo lô đến Dịch vụ tổng hợp. Dịch vụ tổng hợp tìm nạp khoá giải mã từ Dịch vụ lưu trữ khoá, giải mã báo cáo, tổng hợp và làm nhiễu báo cáo để tạo báo cáo tóm tắt. Xin lưu ý rằng điều này phụ thuộc vào việc bạn có đủ ngân sách quyền riêng tư để tạo các chiến dịch đó hay không.

Bạn lưu trữ điểm cuối nguồn gốc báo cáo công nghệ quảng cáo nơi các báo cáo được thu thập và Dịch vụ tổng hợp được triển khai trong đám mây công nghệ quảng cáo của bạn.

Báo cáo tổng hợp theo lô

Quy trình báo cáo sẽ không hoàn chỉnh nếu không có sự trợ giúp của máy chủ nguồn gốc báo cáo được chỉ định. Đây là nguồn gốc mà bạn đã gửi trong quá trình đăng ký. Nguồn gốc báo cáo chịu trách nhiệm thu thập, chuyển đổi và phân lô các báo cáo tổng hợp mà nó nhận được, đồng thời chuẩn bị các báo cáo đó để gửi đến Dịch vụ tổng hợp của bạn trong Google Cloud hoặc Amazon Web Services. Đọc thêm về cách chuẩn bị báo cáo tổng hợp.

Giờ đây, khi bạn đã nắm được khái niệm chung, chúng ta có thể xem xét kỹ hơn các thành phần được triển khai trong Dịch vụ tổng hợp.

Thành phần trên đám mây

Dịch vụ tổng hợp bao gồm một số thành phần dịch vụ đám mây. Bạn sử dụng các tập lệnh Terraform được cung cấp để cấp phép và định cấu hình tất cả các thành phần dịch vụ đám mây cần thiết.

Các thành phần đám mây của Dịch vụ tổng hợp
Các thành phần đám mây của Dịch vụ tổng hợp

Dịch vụ giao diện người dùng

Dịch vụ đám mây được quản lý: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

Dịch vụ giao diện người dùng là một cổng không máy chủ, là điểm truy cập chính cho các lệnh gọi API tổng hợp để tạo công việc và truy xuất trạng thái công việc. Lớp này chịu trách nhiệm nhận yêu cầu từ người dùng Dịch vụ tổng hợp, xác thực các tham số đầu vào và bắt đầu quy trình lên lịch công việc tổng hợp.

Dịch vụ giao diện người dùng có hai API:

Điểm cuối Mô tả
createJob API này kích hoạt một công việc của Dịch vụ tổng hợp. Để kích hoạt công việc, bạn cần cung cấp thông tin như mã công việc, thông tin chi tiết về bộ nhớ đầu vào, thông tin chi tiết về bộ nhớ đầu ra, nguồn gốc báo cáo, v.v.
getJob API này trả về trạng thái của công việc có mã công việc được chỉ định. Thuộc tính này cung cấp thông tin về trạng thái của công việc, chẳng hạn như "Đã nhận", "Đang tiến hành" hoặc "Đã hoàn tất". Nếu công việc đã hoàn tất, công việc đó cũng sẽ trả về kết quả công việc, bao gồm cả mọi thông báo lỗi gặp phải trong quá trình thực thi công việc.

Hãy xem Tài liệu về API Dịch vụ tổng hợp.

Hàng đợi công việc

Dịch vụ đám mây được quản lý: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

Hàng đợi công việc là một hàng đợi thông báo chứa các yêu cầu công việc cho Dịch vụ tổng hợp. Dịch vụ giao diện người dùng chèn các yêu cầu công việc vào hàng đợi, sau đó Trình chạy tổng hợp sẽ xử lý các yêu cầu đó.

Bộ nhớ trên đám mây

Dịch vụ đám mây được quản lý: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

Các tệp đầu vào và đầu ra mà Dịch vụ tổng hợp sử dụng, chẳng hạn như tệp báo cáo đã mã hoá và báo cáo tóm tắt đầu ra, được lưu trữ trong bộ nhớ trên đám mây.

Cơ sở dữ liệu siêu dữ liệu công việc

Dịch vụ đám mây được quản lý: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

Cơ sở dữ liệu siêu dữ liệu công việc dùng để lưu trữ và theo dõi trạng thái của các công việc tổng hợp. Tệp này ghi lại siêu dữ liệu như thời gian tạo, thời gian yêu cầu, thời gian cập nhật và trạng thái như Đã nhận, Đang tiến hành hoặc Đã hoàn tất. Aggregation Worker (Trình chạy tổng hợp) cập nhật Cơ sở dữ liệu siêu dữ liệu công việc khi công việc tiến triển.

Worker tổng hợp

Dịch vụ đám mây được quản lý: Compute Engine có Không gian bảo mật (Google Cloud) / Amazon Web Services EC2 có Nitro Enclave (Amazon Web Services)

Worker tổng hợp xử lý các yêu cầu công việc trong Job Queue (hàng đợi công việc) và giải mã dữ liệu đầu vào đã mã hoá bằng các khoá mà worker này tìm nạp từ Dịch vụ tạo và phân phối khoá (KGDS) trong Trình điều phối. Để giảm thiểu độ trễ trong quá trình xử lý công việc, Worker tổng hợp sẽ lưu khoá giải mã vào bộ nhớ đệm trong khoảng thời gian 8 giờ và sử dụng khoá đó trên các công việc mà chúng xử lý.

Worker tổng hợp hoạt động trong một thực thể Môi trường thực thi đáng tin cậy (TEE). Mỗi worker chỉ xử lý một công việc tại một thời điểm. Bạn có thể định cấu hình nhiều worker để xử lý các công việc song song bằng cách thiết lập cấu hình tự động mở rộng quy mô. Nếu được sử dụng, tính năng tự động mở rộng sẽ tự động điều chỉnh số lượng worker theo số lượng thông báo trong hàng đợi công việc. Bạn có thể định cấu hình số lượng worker tối thiểu và tối đa để tự động mở rộng quy mô thông qua tệp môi trường Terraform. Bạn có thể tìm thêm thông tin về tính năng tự động điều chỉnh quy mô trong các tập lệnh Terraform sau: Amazon Web Services hoặc Google Cloud.

Worker tổng hợp gọi Dịch vụ kế toán báo cáo tổng hợp để kế toán báo cáo tổng hợp. Dịch vụ này đảm bảo rằng các công việc chỉ chạy nếu chưa vượt quá hạn mức ngân sách quyền riêng tư. (Xem quy tắc"Không có nội dung trùng lặp".) Nếu có ngân sách, hệ thống sẽ tạo báo cáo tóm tắt bằng cách sử dụng các dữ liệu tổng hợp có nhiễu. Đọc thêm thông tin chi tiết về kế toán báo cáo tổng hợp.

Worker tổng hợp cập nhật siêu dữ liệu công việc trong Cơ sở dữ liệu siêu dữ liệu công việc. Thông tin này bao gồm mã trả về công việc và bộ đếm lỗi báo cáo trong trường hợp báo cáo không thành công một phần. Người dùng có thể tìm nạp trạng thái bằng API truy xuất trạng thái công việc getJob.

Hãy xem nội dung giải thích này để biết thông tin mô tả chi tiết hơn về Dịch vụ tổng hợp.

Các bước tiếp theo

Giờ đây, khi đã nắm được những điểm nổi bật của Dịch vụ tổng hợp, bạn có thể triển khai phiên bản Dịch vụ tổng hợp của riêng mình thông qua Google Cloud hoặc Amazon Web Services. Hãy xem phần bắt đầu hoặc truy cập vào đường liên kết này để tìm hiểu thêm về cách sử dụng Dịch vụ tổng hợp.

Khắc phục sự cố

Hãy tham khảo tài liệu Các mã lỗi thường gặp và biện pháp giảm thiểu để biết nội dung mô tả chi tiết về thông báo lỗi, nguyên nhân có thể gây ra lỗi mà bạn đang gặp phải và các bước tiếp theo để giảm thiểu lỗi.

Yêu cầu hỗ trợ và đưa ra ý kiến phản hồi