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

Đề xuất Trạng thái
Dịch vụ tổng hợp hỗ trợ Amazon Web Services (AWS) trên Attribution Reporting API, Private Aggregation API
Nội dung giải thích		 Còn hàng
Hỗ trợ Dịch vụ tổng hợp cho Google Cloud trên Attribution Reporting API, API tổng hợp riêng tư
Công cụ giải thích		 Còn hàng
Đăng ký trang web Dịch vụ tổng hợp và tổng hợp nhiều nguồn gốc. Việc đăng ký trang web bao gồm việc liên kết một trang web với các tài khoản đám mây (AWS hoặc GCP). Để tổng hợp nhiều nguồn gốc, các nguồn gốc đó phải thuộc cùng một trang web.
Câu hỏi thường gặp trên GitHub
Tài liệu về API tổng hợp trang web 		Còn hàng
Giá trị epsilon của Dịch vụ tổng hợp sẽ được giữ ở mức tối đa là 64 để tạo điều kiện thử nghiệm và phản hồi về các thông số khác nhau.
Gửi ý kiến phản hồi về ARA epsilon.
Gửi ý kiến phản hồi về epsilon PAA.		 sức mạnh. Chúng tôi sẽ thông báo trước cho hệ sinh thái trước khi cập nhật các giá trị phạm vi epsilon.
Lọc khoản đóng góp linh hoạt hơn cho các truy vấn Dịch vụ tổng hợp
Người giải thích		 Còn hàng
Quy trình khôi phục ngân sách sau khi xảy ra sự cố (lỗi, cấu hình sai, v.v.)
Người giải thích		 Có sẵn
Cơ chế để xem xét tỷ lệ phần trăm mã nhận dạng được chia sẻ mà một công nghệ quảng cáo khôi phục bằng cách sử dụng tính năng khôi phục ngân sách và tạm ngưng các lần khôi phục trong tương lai đối với các lần khôi phục quá mức dự kiến cho nửa đầu năm 2025
Accenture hoạt động với vai trò là một trong những Điều phối viên trên AWS
Blog dành cho nhà phát triển		 Còn hàng
Một bên độc lập hoạt động với vai trò là một trong những Điều phối viên trên Google Cloud
Blog dành cho nhà phát triển		 Còn hàng
Dịch vụ tổng hợp hỗ trợ Báo cáo gỡ lỗi tổng hợp trên Attribution Reporting API
Nội dung giải thích		 Còn hàng

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:

Term Description
Aggregation Service An ad tech-operated service that processes aggregatable reports to create a summary report.
Aggregatable Reports

Báo cáo tổng hợp là báo cáo đã mã hoá được gửi từ thiết bị của người dùng riêng lẻ. Các báo cáo này chứa dữ liệu về hành vi và lượt chuyển đổi của người dùng trên nhiều trang web. Lượt chuyển đổi (đôi khi gọi là sự kiện kích hoạt phân bổ) và các chỉ số liên quan do nhà quảng cáo hoặc công nghệ quảng cáo xác định. Mỗi báo cáo đều được mã hoá để ngăn nhiều bên truy cập vào dữ liệu cơ bản.

Learn more about aggregatable reports.
Aggregatable Report Accounting A distributed ledger located in both coordinators that tracks allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures that no report passes through Aggregation Service beyond the allocated privacy budget. Read more on batching strategies on how it relates to aggregatable reports.
Aggregatable Report Accounting Budget References to the budget that ensures reports are not processed more than once.
Trusted Execution Environment (TEE)

A trusted execution environment is a special configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the computer. 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.
Coordinators

Điều phối viên là đơn vị chịu trách nhiệm quản lý khoá và kế toán báo cáo tổng hợp. Điều phối viên duy trì một danh sách gồm các hàm băm của các cấu hình dịch vụ tổng hợp được phê duyệt và định cấu hình quyền truy cập vào khoá giải mã.
Shared ID Computed value that consists of: shared_info, reporting_origin, destination_site (available for Attribution Reporting API only), source_registration-time (available for Attribution Reporting API only), scheduled_report_time, version. This means that multiple reports belong to the same shared ID should they share the same attributes of the shared_info field. This plays an important role within Aggregatable Report Accounting. Read more about Trusted Servers.
Summary Report

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.
Reporting Origin

Nguồn gốc báo cáo là thực thể nhận báo cáo tổng hợp, hay nói cách khác là công nghệ quảng cáo có tên Attribution Reporting API. Các báo cáo tổng hợp được gửi từ thiết bị của người dùng đến một URL nổi tiếng được liên kết với nguồn gốc báo cáo. Bạn phải chỉ định nguồn báo cáo này trong quá trình đăng ký.
Contribution Bonding Aggregatable reports may contain an arbitrary number of counter increments. For example, a report may contain a count of products that a user has viewed on an advertiser's site. The sum of increments in all aggregatable reports related to a single source event must not exceed a given limit, `L1=2^16`. Learn more in the aggregatable reports explainer.
Noise & Scaling A certain amount of statistical noise is added to summary reports as a part of the aggregation process that also functions to preserve privacy and ensure the final reports provide anonymized measurement information. Read more about additive noise mechanism, which is drawn from Laplace distribution.
Attestation

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

Read more about attestation.

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