Dịch vụ tổng hợp

Dịch vụ tổng hợp tạo các báo cáo tóm tắt về dữ liệu chuyển đổi chi tiết và các phép đo phạm vi tiếp cận từ các báo cáo tổng hợp thô. Công nghệ quảng cáo có 2 điểm truy cập chính ở phía máy khách để gửi báo cáo phễu cho Dịch vụ tổng hợp, thông qua Attribution Reporting API hoặc API Tổng hợp riêng tư.

Trạng thái triển khai

Phạm vi cung cấp

Proposal Status
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 trong quy trình công nghệ quảng cáo, thì các thuật ngữ và khái niệm sau đây sẽ cung cấp thêm 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:

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

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

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

Môi trường thực thi đáng tin cậy là cấu hình đặc biệt của phần cứng và phần mềm máy tính cho phép các bên xác minh phiên bản chính xác của phần mềm đang chạy trên máy tính. TEEs cho phép các bên bên ngoài xác minh rằng phần mềm thực hiện chính xác những gì nhà sản xuất phần mềm tuyên bố rằng điều đó hoàn toàn có thể.

Để tìm hiểu thêm về TEE được dùng cho các đề xuất về Hộp cát về quyền riêng tư, hãy đọc tài liệu giải thích về các dịch vụ Protected Audience API và tài liệu giải thích về Dịch vụ tổng hợp.
协调员

协调者是负责密钥管理和可汇总报告的会计核算的实体。协调者维护已获批准的汇总服务配置的哈希列表，并配置对解密密钥的访问权限。
共享 ID 计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告

Báo cáo tóm tắt là một loại báo cáo Attribution Reporting API và API Tổng hợp riêng tư. Báo cáo tổng quan bao gồm dữ liệu người dùng tổng hợp và có thể chứa dữ liệu chi tiết về lượt chuyển đổi, cùng với dữ liệu nhiễu. Báo cáo tóm tắt bao gồm các báo cáo tổng hợp. Báo cáo tóm tắt cho phép linh hoạt hơn và có mô hình dữ liệu phong phú hơn so với báo cáo ở cấp sự kiện, đặc biệt là đối với một số trường hợp sử dụng như giá trị lượt chuyển đổi.
举报来源

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

Chứng thực là một cơ chế xác thực danh tính phần mềm, thường bằng hàm băm mật mã hoặc chữ ký. Đối với đề xuất dịch vụ tổng hợp, quy trình chứng thực sẽ so khớp mã đang chạy trong dịch vụ tổng hợp do công nghệ quảng cáo điều hành với mã nguồn mở.

详细了解证明。

Hãy đọc thêm về cốt truyện của Dịch vụ tổng hợp trong tài liệu giải thích của chúng tôi và danh sách điều khoản đầy đủ.

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 chuyển đổi cho mục đích tối ưu hoá giá thầu.
Đo lường trên nhiều nền tảng API Báo cáo phân bổ (Chrome và Android) Sử dụng khả năng đo lường trên nhiều ứng dụng và web để xem thông tin về hiệu suất trên Chrome và Android.
Báo cáo lượt chuyển đổi API Báo cáo phân bổ (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 API Bộ nhớ dùng chung và 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 API Bộ nhớ dùng chung và API Tổng hợp riêng tư (Chrome) Lưu trữ chế độ 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 API Bộ nhớ dùng chung và 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ơ đồ dưới đâ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ừ việc nhận báo cáo từ web và thiết bị di động đến việc 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

  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ô báo cáo (định dạng avro) và gửi đến Dịch vụ tổng hợp đã triển khai. (Phải do công nghệ quảng cáo hoàn thành).
  4. Truy xuất các báo cáo tổng hợp để giải mã.
  5. Truy xuất khoá giải mã từ trình điều phối.
  6. Dịch vụ tổng hợp 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 trong báo cáo tổng hợp sẽ kiểm tra xem còn ngân sách quyền riêng tư nào để tạo báo cáo tóm tắt cho các báo cáo tổng hợp đã cung cấp hay không.
  8. Gửi báo cáo tóm tắt cuối cùng.

Từ sơ đồ, bạn có thể thấy mối quan hệ tổng thể giữa Dịch vụ tổng hợp 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à các trình điều phối.

Quy trình này bắt đầu bằng nhiều API Đo lường như API Báo cáo phân bổ hoặc 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 Điều phối viên để mã hoá báo cáo trước khi gửi đến nguồn gốc báo cáo của công nghệ quảng cáo. Các khoá công khai được xoay vòng 7 ngày một lần.

Sau khi nhận được các báo cáo này, nguồn gốc báo cáo của công nghệ quảng cáo phải được định cấu hình để thu thập và chuyển đổi các báo cáo đó sang định dạng avro rồi gửi đến phiên bản Dịch vụ tổng hợp đã triển khai. Hãy xem chiến lược gộp nhóm.

Sau khi công nghệ quảng cáo đã sẵn sàng để phân lô, công nghệ quảng cáo sẽ tạo một yêu cầu hàng loạt đến Dịch vụ tổng hợp. Trong đó, các báo cáo được giải mã bằng cách truy xuất khoá giải mã từ Dịch vụ lưu trữ khoá, đồng thời tổng hợp và gây nhiễu để 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 có đủ ngân sách quyền riêng tư để tạo báo cáo tóm tắt cuối cùng hay không.

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

Phân lô các báo cáo tổng hợp

Quy trình báo cáo sẽ không hoàn tất 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à công nghệ quảng cáo đã gửi trong quá trình đăng ký. Các hành động chính mà nguồn gốc báo cáo chịu trách nhiệm là thu thập, chuyển đổi và phân lô các báo cáo tổng hợp đã nhận được, đồng thời chuẩn bị để gửi các báo cáo đó đến Dịch vụ tổng hợp đã triển khai của công nghệ quảng cáo 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 đã có khái niệm chung, hãy tìm hiểu kỹ hơn về các thành phần sẽ được triển khai trong Dịch vụ tổng hợp.

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

Dịch vụ tổng hợp bao gồm nhiều thành phần của dịch vụ đám mây. Cung cấp tập lệnh Terraform được cung cấp và định cấu hình tất cả thành phần dịch vụ đám mây cần thiết.

Các thành phần trê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ý: Hàm đám mây (Google Cloud) / Cổng API (Dịch vụ web Amazon)

Dịch vụ giao diện người dùng là một cổng vào không máy chủ đóng vai trò là điểm truy cập 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.

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

Đ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. Tệp này cần thông tin để kích hoạt một công việc, chẳng hạn 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 một công việc cho một mã công việ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". Ngoài ra, nếu công việc đã hoàn tất, nó sẽ hiển thị kết quả công việc, bao gồm 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 của 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 (Dịch vụ web của Amazon)

Hàng đợi công việc là một hàng đợi thông báo lưu trữ 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 thông báo yêu cầu công việc vào hàng đợi, sau đó Aggregation Worker (Trình chạy tổng hợp) sẽ sử dụng thông báo này để xử lý yêu cầu công việc.

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

Dịch vụ đám mây được quản lý: Google Cloud Storage (Google Cloud) / Amazon S3 (Dịch vụ web của Amazon) Bộ nhớ trên đám mây được dùng để lưu trữ các tệp đầu vào và đầu ra mà Dịch vụ tổng hợp sử dụng (ví dụ: tệp báo cáo đã mã hoá, báo cáo tóm tắt đầu ra, v.v.).

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 (Dịch vụ web của Amazon)

Cơ sở dữ liệu siêu dữ liệu công việc lưu trữ và theo dõi trạng thái của các công việc tổng hợp. Cơ sở dữ liệu 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 (ví dụ: Đã nhận, Đang tiến hành, Đã hoàn tất, v.v.). Trình chạy tổng hợp sẽ cập nhật Cơ sở dữ liệu siêu dữ liệu công việc khi công việc diễn ra.

Worker tổng hợp

Dịch vụ đám mây được quản lý: Công cụ điện toán với Không gian bảo mật (Google Cloud) / Dịch vụ web của Amazon EC2 với Nitro Enclave (Dịch vụ web của Amazon)

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

Worker này 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. Công nghệ quảng cáo có thể định cấu hình nhiều worker để xử lý song song các công việc bằng cách đặt cấu hình tự động điều chỉnh tỷ lệ. Thông qua tính năng tự động mở rộng quy mô, số lượng worker được điều chỉnh linh động theo số lượng thông báo còn lại 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 thông qua tệp môi trường Terraform. Bạn có thể xem thêm thông tin về phương thức tự động cấp tài nguyên bổ sung trong các tập lệnh terraform sau đây. [Amazon Web Services / Google Cloud]

Aggregation Worker gọi dịch vụ Aggregatable Report Accounting (Hạch toán báo cáo tổng hợp) để hạch toán báo cáo tổng hợp. Dịch vụ kế toán báo cáo tổng hợp sẽ đảm bảo rằng các công việc chỉ chạy miễn là 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ề chức năng kế toán trong 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, bao gồm cả mã trả về công việc thích hợp và bộ đếm lỗi báo cáo trong trường hợp báo cáo một phần không thành công. Người dùng có thể tìm nạp trạng thái bằng cách sử dụng API truy xuất trạng thái công việc (getJob).

Để xem nội dung mô tả chi tiết hơn về Dịch vụ tổng hợp, hãy tham khảo tài liệu giải thích của chúng tôi.

Các bước tiếp theo

Giờ đây, khi bạn đã nhận được các điểm nổi bật của Dịch vụ tổng hợp, đã đến lúc bạn 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 sử dụng hoặc nếu bạn cần thêm thông tin về cách vận hành Dịch vụ tổng hợp đã triển khai, hãy truy cập vào đường liên kết này để tìm hiểu thêm về cách vận hành 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 hơn về thông báo lỗi, nguyên nhân có thể gây ra lỗi mà bạn gặp phải và các bước tiếp theo để giảm thiểu.

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