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ô. Công nghệ quảng cáo có 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, thông qua API Báo cáo phân bổ 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ể cung cấp 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

A coordinator is an entity responsible for key management and aggregatable report accounting. The coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.
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

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ở.

Read more about attestation.

Đọc thêm về câu chuyện đằng sau Dịch vụ tổng hợp trong bài viết giải thích và danh sách đầy đủ các điều khoản.

Các 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 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ừ 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 tất).
  4. Truy xuất 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ụ hạch toán 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 đã cho 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 Trình điều phối để mã hoá các báo cáo trước khi gửi đến nguồn 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 nguồn báo cáo của công nghệ quảng cáo nhận được các báo cáo này, nguồn báo 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 thực thể Dịch vụ tổng hợp đã triển khai. Hãy xem chiến lược tạo lô.

Khi đã sẵn sàng phân lô, công nghệ quảng cáo sẽ tạo một yêu cầu phân lô đến Dịch vụ tổng hợp. Tại đây, 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á, sau đó được tổng hợp và làm 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.

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à 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, bạn đã nắm được khái niệm chung, hãy xem xét kỹ hơn các thành phần sẽ đượ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 nhiều thành phần dịch vụ đám mây. Các tập lệnh Terraform được cung cấp sẽ 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

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ủ đó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. Công cụ này yêu cầu 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 đượ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, công việc đó sẽ hiển thị 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 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 (Amazon Web Services) Lưu trữ 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 (Amazon Web Services)

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.). Aggregation Worker (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 đang diễn ra.

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 do yêu cầu công việc khởi tạo trong Job Queue (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 Trình điều phối. Để 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 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ý 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ô. 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 quy mô thông qua tệp môi trường Terraform. Bạn có thể xem 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 / 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ề 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, 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 API truy xuất trạng thái công việc (getJob).

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

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 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ề việc 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 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