Layanan Agregasi

Layanan Agregasi menghasilkan laporan ringkasan data konversi mendetail dan pengukuran jangkauan dari laporan gabungan mentah. Sebagai teknologi iklan, Anda dapat menggunakan Attribution Reporting API dan Private Aggregation API, dua titik entri agregat utama di sisi klien, untuk menyalurkan laporan ke Layanan Agregasi dan menerima laporan ringkasan sebagai respons.

Halaman ini mengasumsikan bahwa Anda adalah pakar teknologi iklan. Halaman ini membahas:

• Status penerapan
• Istilah dan konsep utama
• Kasus penggunaan agregasi
• Alur menyeluruh
• Penggabungan laporan gabungan
• Komponen cloud

Status penerapan

• Layanan Agregasi kini telah dipindahkan ke ketersediaan umum.
• Layanan Agregasi dapat digunakan dengan Attribution Reporting API dan Private Aggregation API untuk Protected Audience API dan Shared Storage API.

Ketersediaan

提案	状态
跨云隐私预算服务 说明	可用
针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持 说明	可用
针对 Attribution Reporting API、Private Aggregation API 的 Google Cloud 汇总服务支持 说明	可用
汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。如需汇总多个来源，这些来源必须属于同一网站。 GitHub 上的常见问题解答 Site aggregation API 文档	可用
汇总服务的 epsilon 值将保持在 64 以内的范围内，以便对不同的参数进行实验和反馈。 提交 ARA 小数值反馈。 提交 PAA 小数值反馈。	可用。在更新 epsilon 范围值之前，我们会提前通知生态系统。
为汇总服务查询提供了更灵活的贡献过滤功能 解说	可用
灾难发生后（错误、配置错误等）预算恢复流程 说明	已推出 机制，用于查看广告技术平台使用预算恢复功能恢复的共享 ID 的百分比，并暂停计划在 2025 年上半年过度恢复的未来恢复
Accenture 是 AWS 协调者之一 开发者博客	可用
作为 Google Cloud 协调者之一的独立方 开发者博客	可用
汇总服务支持 Attribution Reporting API 上的汇总调试报告 说明	可用
跨云加密密钥服务 解说	预计 2025 年上半年

Istilah dan konsep utama

Jika Anda mempertimbangkan Layanan Agregasi untuk alur kerja Anda, istilah dan konsep berikut dapat memberikan insight tentang manfaat alur agregasi baru ini bagi tim Anda.

Glosarium istilah

Laporan Gabungan

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

详细了解可汇总的报告。

Akuntansi Laporan Gabungan

分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系。

Anggaran Akuntansi Laporan Gabungan

对预算的引用，用于确保不会对单个报告进行多次处理。

Layanan Agregasi

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

如需详细了解汇总服务的背景信息，请参阅我们的说明文档和完整条款列表。

Pengesahan

一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务提案，认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。

详细了解认证。

Bonding Kontribusi

Koordinator

负责密钥管理和汇总报告会计核算的实体。协调者会维护已获批准的汇总服务配置的哈希列表，并配置对解密密钥的访问权限。

Derau dan Penskalaan

在汇总过程中向摘要报告添加的统计噪声，用于保护隐私并确保最终报告提供匿名化衡量信息。

详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。

Asal Pelaporan

接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。

ID bersama

Nilai yang dihitung yang terdiri dari shared_info, reporting_origin, destination_site (khusus Attribution Reporting API), source_registration-time (khusus Attribution Reporting API), scheduled_report_time, dan versi.

Beberapa laporan yang memiliki atribut yang sama di kolom shared_info harus memiliki ID bersama yang sama. ID bersama memainkan peran penting dalam Akuntansi Laporan Agregat.

Baca selengkapnya tentang Server Tepercaya.

Laporan Ringkasan

Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。

Trusted Execution Environment (TEE)

计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。

如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。

Kasus penggunaan agregasi

Pertimbangkan perjalanan developer berikut untuk pengukuran iklan dan library klien pengukuran yang sesuai.

Kasus penggunaan	Titik entri	Deskripsi
Pengoptimalan bidding	Attribution Reporting API (Chrome & Android)	Gunakan laporan gabungan untuk menyerap sinyal konversi untuk tujuan pengoptimalan bidding.
Pengukuran lintas platform	Attribution Reporting API (Chrome & Android)	Gunakan kemampuan pengukuran lintas web dan aplikasi untuk mendapatkan visibilitas terkait performa di Chrome & Android.
Pelaporan konversi	Attribution Reporting API (Chrome & Android)	Buat pelaporan konversi gabungan yang disesuaikan dengan kebutuhan kampanye pelanggan (termasuk CTC dan VTC).
Pengukuran jangkauan kampanye	Shared Storage API & Private Aggregation API (Chrome)	Gunakan variabel penayangan iklan lintas situs untuk mengukur jangkauan kampanye.
Pelaporan demografi	Shared Storage API & Private Aggregation API (Chrome)	Gunakan penayangan iklan lintas situs dan informasi demografis untuk mengukur jangkauan menurut demografi.
Analisis jalur konversi	Shared Storage API & Private Aggregation API (Chrome)	Menyimpan variabel konversi dan tampilan iklan lintas situs untuk melakukan analisis jalur konversi gabungan.
Brand Lift dan Conversion Lift	Shared Storage API & Private Aggregation API (Chrome)	Pelaporan tentang grup pengujian/kontrol dan informasi polling untuk mengukur brand lift dan inkrementalitas.
Proses debug lelang	Protected Audience API & Private Aggregation API (Chrome)	Gunakan laporan gabungan untuk proses debug.
Distribusi bid	Protected Audience API & Private Aggregation API (Chrome)	Gunakan laporan gabungan untuk mencatat distribusi nilai bid untuk lelang.

Alur menyeluruh

Diagram berikut menunjukkan cara kerja Layanan Agregasi. Kita akan berfokus pada alur menyeluruh dari saat laporan diterima dari perangkat web dan seluler, hingga saat laporan ringkasan dibuat di Layanan Agregasi.

Alur Layanan Agregasi menyeluruh

1. Ambil kunci publik untuk membuat laporan terenkripsi.
2. Laporan gabungan terenkripsi dikirim ke server teknologi iklan untuk dikumpulkan, diubah, dan dikelompokkan.
3. Server teknologi iklan mengelompokkan laporan (dalam format avro) dan mengirimkannya ke Layanan Agregasi. (Anda harus menyelesaikannya.)
4. Pekerja Agregasi mengambil laporan gabungan untuk didekripsi.
5. Pekerja Agregasi mengambil kunci dekripsi dari Koordinator.
6. Aggregation Worker mendekripsi laporan untuk agregasi dan derau.
7. Layanan Akuntansi Laporan Gabungan memeriksa apakah ada anggaran privasi yang memadai untuk membuat laporan ringkasan untuk laporan gabungan yang diberikan.
8. Kirim laporan ringkasan akhir.

Diagram ini menunjukkan hubungan tingkat tinggi yang dimiliki Layanan Agregasi dengan API pengukuran klien utama: Attribution Reporting API, Private Aggregation API, dan Koordinator.

Alur ini dimulai dengan Measurement API, seperti Attribution Reporting API atau Private Aggregation API, yang membuat laporan dari beberapa instance browser. Chrome mendapatkan kunci publik dari Layanan Hosting Kunci di Koordinator untuk mengenkripsi laporan sebelum mengirimkannya ke asal pelaporan teknologi iklan Anda. Kunci publik dirotasi setiap tujuh hari.

Asal pelaporan teknologi iklan Anda harus dikonfigurasi untuk mengumpulkan dan mengonversi laporan masuk ke format avro, serta mengirimkannya ke Layanan Agregasi seperti yang dijelaskan dalam strategi pengelompokan.

Jika sudah siap, Anda dapat mengirim permintaan batch ke Layanan Agregasi. Layanan Agregasi mengambil kunci dekripsi dari Layanan Hosting Kunci, mendekripsi laporan, serta menggabungkan dan menambahkan derau untuk membuat laporan ringkasan. Perhatikan bahwa hal ini bergantung pada ketersediaan anggaran privasi yang memadai untuk membuatnya.

Anda menghosting endpoint asal pelaporan teknologi iklan tempat laporan dikumpulkan, dan Layanan Agregasi di-deploy di cloud teknologi iklan Anda.

Pengelompokan laporan gabungan

Alur pelaporan tidak akan lengkap tanpa bantuan server asal pelaporan yang ditetapkan. Ini adalah origin yang akan Anda kirimkan dalam proses pendaftaran. Asal pelaporan bertanggung jawab untuk mengumpulkan, mengubah, dan mengelompokkan laporan agregat yang diterimanya, serta menyiapkannya untuk dikirim ke Layanan Agregasi Anda di Google Cloud atau Amazon Web Services. Baca selengkapnya tentang cara menyiapkan laporan gabungan.

Setelah Anda memiliki konsep umum, kita dapat mempelajari lebih lanjut komponen yang di-deploy di Layanan Agregasi Anda.

Komponen cloud

Layanan Agregasi terdiri dari beberapa komponen layanan cloud. Anda menggunakan skrip Terraform yang disediakan untuk menyediakan dan mengonfigurasi semua komponen layanan cloud yang diperlukan.

Komponen cloud Layanan Agregasi.

Layanan Frontend

Layanan Cloud Terkelola: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

Layanan Frontend adalah gateway serverless yang merupakan titik entri utama untuk panggilan Aggregation API guna pembuatan tugas dan pengambilan status tugas. Layanan ini bertanggung jawab untuk menerima permintaan dari pengguna Layanan Agregasi, memvalidasi parameter input, dan memulai proses penjadwalan tugas agregasi.

Layanan Frontend memiliki dua API yang tersedia:

Endpoint	Deskripsi
createJob	API ini memicu tugas Layanan Agregasi. Untuk memicu tugas, Anda memerlukan informasi seperti ID tugas, detail penyimpanan input, detail penyimpanan output, asal pelaporan, dan lainnya.
getJob	API ini menampilkan status tugas yang memiliki ID tugas yang ditentukan. Status ini memberikan informasi tentang status tugas, seperti "Diterima", "Sedang Berlangsung", atau "Selesai". Jika selesai, tugas juga akan menampilkan hasil tugas, termasuk pesan error yang ditemukan selama eksekusi tugas.

Lihat Dokumentasi Aggregation Service API.

Antrean Tugas

Layanan Cloud Terkelola: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

Antrean Tugas adalah antrean pesan yang berisi permintaan tugas untuk Layanan Agregasi. Layanan Frontend menyisipkan permintaan tugas ke dalam antrean, yang kemudian digunakan oleh Aggregation Workers yang memprosesnya.

Penyimpanan cloud

Layanan Cloud Terkelola: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

File input dan output yang digunakan oleh Layanan Agregasi, seperti file laporan terenkripsi dan laporan ringkasan output, disimpan di penyimpanan cloud.

Database Metadata Lowongan

Layanan Cloud Terkelola: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

Database Metadata Tugas digunakan untuk menyimpan dan melacak status tugas agregasi. Laporan ini mencatat metadata seperti waktu pembuatan, waktu yang diminta, waktu diperbarui, dan status seperti Diterima, Sedang Berlangsung, atau Selesai. Aggregation Workers memperbarui Database Metadata Tugas saat tugas berlangsung.

Pekerja Agregasi

Layanan Cloud Terkelola: Compute Engine dengan Confidential Space (Google Cloud) / Amazon Web Services EC2 dengan Nitro Enclave (Amazon Web Services)

Pekerja Agregasi memproses permintaan tugas di Antrean Tugas, dan mendekripsi input terenkripsi menggunakan kunci yang diambil dari Layanan Pembuatan dan Distribusi Kunci (KGDS) di Koordinator. Untuk meminimalkan latensi pemrosesan tugas, Pekerja Agregasi meng-cache kunci dekripsi selama 8 jam, dan menggunakannya di seluruh tugas yang diproses.

Pekerja Agregasi beroperasi dalam instance Trusted Execution Environment (TEE). Pekerja hanya menangani satu tugas dalam satu waktu. Anda dapat mengonfigurasi beberapa pekerja untuk memproses tugas secara paralel dengan menetapkan konfigurasi penskalaan otomatis. Jika digunakan, penskalaan otomatis akan menyesuaikan jumlah pekerja secara dinamis sesuai dengan jumlah pesan dalam antrean tugas. Anda dapat mengonfigurasi jumlah pekerja minimum dan maksimum untuk penskalaan otomatis melalui file lingkungan Terraform. Informasi selengkapnya tentang penskalaan otomatis dapat ditemukan dalam skrip Terraform ini: Amazon Web Services atau Google Cloud.

Pekerja Agregasi memanggil Layanan Akuntansi Laporan Agregat untuk akuntansi laporan agregat. Layanan ini memastikan bahwa tugas hanya dijalankan jika batas anggaran privasi belum terlampaui. (Lihat aturan"Tidak ada duplikat".) Jika anggaran tersedia, laporan ringkasan akan dibuat menggunakan agregat yang berisi derau. Baca detail tambahan terkait pencatatan laporan gabungan.

Pekerja Agregasi memperbarui metadata tugas di Database Metadata Tugas. Informasi ini mencakup kode pengembalian tugas dan penghitung error laporan jika terjadi kegagalan laporan sebagian. Pengguna dapat mengambil status menggunakan API pengambilan status tugas getJob.

Lihat penjelasan ini untuk deskripsi Layanan Agregasi yang lebih mendetail.

Langkah berikutnya

Setelah melihat sorotan Layanan Agregasi, sekarang saatnya Anda men-deploy instance Layanan Agregasi Anda sendiri melalui Google Cloud atau Amazon Web Services. Lihat bagian memulai, atau ikuti link ini untuk mempelajari lebih lanjut cara mengoperasikan Layanan Agregasi.

Pemecahan masalah

Lihat dokumen Kode error dan mitigasi umum untuk mengetahui deskripsi mendetail tentang pesan error, penyebab error yang Anda alami, dan langkah berikutnya untuk mitigasi.

Mendapatkan dukungan dan memberikan masukan

• Untuk pertanyaan, masukan, dan permintaan fitur produk, buat masalah di repositori GitHub kami.
• Untuk meminta dukungan pemecahan masalah teknis jika Anda mengalami error saat men-deploy, memelihara, atau menjalankan tugas dengan Layanan Agregasi, gunakan Formulir Dukungan Teknis ini.
• Periksa Dasbor Status Publik untuk mengetahui masalah umum.