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

Đề xuất Trạng thái
Dịch vụ ngân sách quyền riêng tư trên nhiều đám mây
Giải thích		 Còn hàng
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
Dịch vụ tổng hợp hỗ trợ Google Cloud trên Attribution Reporting API, Private Aggregation API
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 trang web với 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ề epsilon ARA.
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 nội dung đóng góp linh hoạt hơn cho các truy vấn Dịch vụ tổng hợp
Giải thích		 Còn hàng
Quy trình khôi phục ngân sách sau thảm hoạ (lỗi, sai cấu hình, v.v.)
Nội dung 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 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

Báo cáo tổng hợp là các báo cáo được mã hoá được gửi từ thiết bị của từng người dùng. 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 được 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 được mã hoá để ngăn các bên khác nhau truy cập vào dữ liệu cơ bản.

Tìm hiểu thêm về báo cáo tổng hợp.

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

Sổ cái phân tán, nằm trong cả hai trình điều phối, theo dõi ngân sách quyền riêng tư được phân bổ và thực thi quy tắc "Không trùng lặp". Đây là cơ chế bảo đảm quyền riêng tư, nằm và chạy trong các trình điều phối, đảm bảo không có báo cáo nào đi qua Dịch vụ tổng hợp ngoài ngân sách quyền riêng tư được phân bổ.

Đọc thêm về mối quan hệ giữa chiến lược phân lô và báo cáo tổng hợp.

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

Một dịch vụ do công nghệ quảng cáo vận hành, xử lý các báo cáo tổng hợp để tạo báo cáo tóm tắt.

Đọ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.

Chứng thực

Cơ chế xác thực danh tính phần mềm, thường là bằng hàm băm mã hoá 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ã chạy trong dịch vụ tổng hợp do công nghệ quảng cáo của bạn vận hành với mã nguồn mở.

Đọc thêm về chứng thực.

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

Các pháp nhân chịu trách nhiệm quản lý khoá và hạch toán báo cáo tổng hợp. Trình điều phối duy trì danh sách hàm băm của các cấu hình dịch vụ tổng hợp đã phê duyệt và định cấu hình quyền truy cập vào khoá giải mã.

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

Pháp nhân nhận báo cáo tổng hợp – nói cách khác, bạn hoặc một công nghệ quảng cáo đã gọi API Báo cáo phân bổ. 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 phổ biến được liên kết với nguồn báo cáo. Nguồn gốc báo cáo được chỉ định trong quá trình đăng ký.

Mã nhận dạng chung

Một giá trị được tính toán bao gồm shared_info, reporting_origin, destination_site (chỉ dành cho Attribution Reporting API), source_registration-time (chỉ dành cho Attribution Reporting API), scheduled_report_time và phiên bản.

Nhiều báo cáo có cùng thuộc tính trong trường shared_info phải có cùng một mã nhận dạng dùng chung. Mã nhận dạng dùng chung đóng vai trò quan trọng trong tính năng Hạch toán báo cáo tổng hợp.

Đọc thêm về Máy chủ đáng tin cậy.

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

Loại báo cáo Attribution Reporting API và Private Aggregation API. Báo cáo tóm tắt bao gồm dữ liệu người dùng tổng hợp và có thể chứa dữ liệu chuyển đổi chi tiết kèm theo nhiễu. Báo cáo tóm tắt được tạo thành từ các báo cáo tổng hợp. Các báo cáo này cho phép linh hoạt hơn và cung cấp 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.

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

Cấu hình bảo mật của phần cứng và phần mềm máy tính cho phép các bên bên ngoài xác minh chính xác các phiên bản phần mềm đang chạy trên máy mà không sợ bị lộ. TEE 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ố.

Để 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.

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