Layanan Agregasi membuat laporan ringkasan data konversi mendetail dan pengukuran jangkauan dari laporan gabungan mentah. Teknologi iklan memiliki dua titik entri agregat utama di sisi klien untuk menyalurkan laporan ke Layanan Agregasi, baik melalui Attribution Reporting API maupun Private Aggregation API.
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 上的常见问题解答 网站汇总 API 文档 |
可用 |
| 汇总服务的 epsilon 值将保持一个不超过 64 的范围，以方便对不同参数的实验和反馈。
提交 ARA 小数值反馈。 提交 PAA 小数值反馈。 |
可用。在更新 epsilon 范围值之前，我们会提前通知整个生态系统。 |
| 为汇总服务查询提供更灵活的贡献过滤功能
解说 |
可用 |
| 灾难后（错误、配置错误等）的预算恢复流程
解说 |
提供 机制，用于审核广告技术平台使用预算挽回功能找回的共享 ID 所占百分比，以及针对 2025 年上半年计划恢复的过多账号恢复请求暂停未来恢复机制 |
| Accenture 是 AWS 协调者之一
开发者博客 |
可用 |
| 担任 Google Cloud 协调员之一的独立方
开发者博客 |
可用 |
| 汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明 |
可用 |
Istilah dan konsep utama
Jika Anda mempertimbangkan untuk menggunakan Layanan Agregasi dalam alur kerja teknologi iklan, istilah dan konsep berikut akan memberikan lebih banyak insight tentang manfaat alur agregasi baru ini bagi tim Anda:
| 术语 | 说明 |
|---|---|
| 汇总服务 | 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。 |
| 可汇总的报告 |
Laporan agregat adalah laporan terenkripsi yang dikirim dari setiap perangkat pengguna. Laporan ini berisi data tentang konversi dan perilaku pengguna lintas situs. Konversi (terkadang disebut peristiwa pemicu atribusi) dan metrik terkait ditentukan oleh pengiklan atau teknologi iklan. Setiap laporan dienkripsi untuk mencegah berbagai pihak agar tidak mengakses data pokok. 详细了解可汇总的报告。 |
| 可汇总报告的会计核算 | 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。 |
| 可汇总报告的会计核算预算 | 对预算的引用，用于确保报告不会被处理多次。 |
| 可信执行环境 (TEE) |
{i>Trusted execution environment<i} adalah konfigurasi khusus dari perangkat keras dan perangkat lunak komputer yang memungkinkan pihak untuk memverifikasi versi yang tepat dari perangkat lunak yang berjalan di komputer. TEEs memungkinkan pihak eksternal untuk memverifikasi bahwa perangkat lunak itu melakukan apa yang sesuai dengan klaim produsen perangkat lunak—tidak lebih atau kurang. Untuk mempelajari TEE yang digunakan untuk proposal Privacy Sandbox lebih lanjut, baca penjelasan layanan Protected Audience API dan penjelasan Layanan Agregasi. |
| 协调员 |
Koordinator adalah entitas yang bertanggung jawab atas pengelolaan kunci dan akuntansi laporan agregat. Koordinator mengelola daftar hash konfigurasi layanan agregasi yang disetujui dan mengonfigurasi akses ke kunci dekripsi. |
| 共享 ID |
计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。
这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。
详细了解可信服务器。
|
| 汇总报告 |
Laporan ringkasan adalah jenis laporan Attribution Reporting API dan Private Aggregation API. Laporan ringkasan menyertakan data pengguna gabungan dan dapat berisi data konversi mendetail, dengan derau yang ditambahkan. Laporan ringkasan terdiri dari laporan gabungan. Laporan ringkasan memungkinkan fleksibilitas yang lebih besar dan model data yang lebih beragam daripada pelaporan tingkat peristiwa, terutama untuk beberapa kasus penggunaan seperti nilai konversi. |
| 举报来源 |
Asal pelaporan adalah entitas yang menerima laporan agregat—dengan kata lain, teknologi iklan yang disebut Attribution Reporting API. Laporan agregat dikirim dari perangkat pengguna ke URL terkenal yang terkait dengan origin pelaporan. Asal pelaporan ini harus ditetapkan selama pendaftaran. |
| 贡献债券 | 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。 |
| 噪声和缩放 | 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。 |
| 证明 |
Pengesahan adalah mekanisme untuk mengautentikasi identitas software, biasanya dengan hash kriptografi atau tanda tangan. Untuk proposal layanan agregasi, pengesahan cocok dengan kode yang berjalan di layanan agregasi yang dioperasikan teknologi iklan dengan kode open source. 详细了解证明。 |
Baca selengkapnya tentang latar belakang Layanan Agregasi di penjelasan dan daftar istilah lengkap kami.
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 tampilan iklan lintas situs dan variabel konversi 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 menerima laporan dari web dan seluler hingga membuat laporan ringkasan di Layanan Agregasi.
- Mengambil kunci publik untuk membuat laporan terenkripsi.
- Laporan gabungan terenkripsi yang dikirim ke server teknologi iklan untuk dikumpulkan, diubah, dan dikelompokkan.
- Server teknologi iklan mengelompokkan laporan (format avro) dan mengirimnya ke Layanan Agregasi yang di-deploy. (Harus diselesaikan oleh teknologi iklan).
- Mengambil laporan gabungan untuk didekripsi.
- Mengambil kunci dekripsi dari koordinator.
- Layanan Agregasi mendekripsi laporan untuk agregasi dan derau.
- Layanan akuntansi laporan agregat memeriksa apakah ada anggaran privasi yang tersisa untuk membuat laporan ringkasan untuk laporan agregat tertentu.
- Kirim laporan ringkasan akhir.
Dari diagram, Anda dapat melihat keseluruhan hubungan yang dimiliki Layanan Agregasi dengan API pengukuran klien utama Attribution Reporting API, Private Aggregation API, dan koordinator.
Alur ini dimulai dengan berbagai Measurement API seperti Attribution Reporting API atau Private Aggregation API yang membuat laporan dari beberapa instance browser. Chrome mengambil kunci publik dari Layanan Hosting Kunci di Koordinator untuk mengenkripsi laporan sebelum dikirim ke asal pelaporan teknologi iklan. Kunci publik dirotasi setiap tujuh hari.
Setelah asal pelaporan teknologi iklan menerima laporan ini, asal pelaporan harus dikonfigurasi untuk mengumpulkan dan mengonversi laporan tersebut ke format avro dan dikirim ke instance Layanan Agregasi yang di-deploy. Lihat strategi pengelompokan.
Setelah teknologi iklan siap untuk dikelompokkan, teknologi iklan akan membuat permintaan batch ke Layanan Agregasi tempat laporan didekripsi dengan mengambil kunci dekripsi dari Layanan Hosting Kunci, serta digabungkan dan di-noise untuk membuat laporan ringkasan. Perhatikan bahwa hal ini bergantung pada apakah ada anggaran privasi yang cukup untuk membuat laporan ringkasan akhir.
Endpoint asal pelaporan teknologi iklan tempat laporan dikumpulkan dihosting oleh teknologi iklan, dan Layanan Agregasi di-deploy di cloud teknologi iklan.
Pengelompokan laporan gabungan
Alur pelaporan tidak akan lengkap tanpa bantuan server asal pelaporan yang ditetapkan. Ini adalah asal yang akan dikirimkan teknologi iklan dalam proses pendaftaran. Tindakan utama yang menjadi tanggung jawab asal pelaporan adalah mengumpulkan, mengubah, dan mengelompokkan laporan agregat yang diterima serta menyiapkannya untuk dikirim ke Layanan Agregasi yang di-deploy oleh teknologi iklan di Google Cloud atau Amazon Web Services. Baca selengkapnya tentang cara menyiapkan laporan gabungan.
Setelah Anda memiliki konsep umum, pelajari lebih lanjut komponen yang akan di-deploy di Layanan Agregasi.
Komponen cloud
Layanan Agregasi terdiri dari berbagai komponen layanan cloud. Skrip Terraform yang disediakan menyediakan dan mengonfigurasi semua komponen layanan cloud yang diperlukan.
Layanan Frontend
Layanan Cloud Terkelola: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
Layanan Frontend adalah gateway serverless yang berfungsi sebagai titik entri 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.
Ada dua API yang tersedia di Layanan Frontend:
| Endpoint | Deskripsi |
|---|---|
createJob |
API ini memicu tugas Layanan Agregasi. Tugas ini memerlukan informasi untuk memicu tugas seperti ID tugas, detail penyimpanan input, detail penyimpanan output, asal pelaporan, dan lainnya. |
getJob |
API ini menampilkan status tugas untuk ID tugas yang ditentukan. Status ini memberikan informasi tentang status tugas, seperti "Diterima", "Sedang Berlangsung", atau "Selesai". Selain itu, jika tugas selesai, tugas 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)
Job Queue adalah antrean pesan yang menyimpan permintaan tugas untuk Layanan Agregasi. Layanan Frontend menyisipkan pesan permintaan tugas ke dalam antrean, yang kemudian digunakan oleh Aggregation Worker untuk memproses permintaan tugas.
Penyimpanan cloud
Layanan Cloud Terkelola: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) Cloud storage digunakan untuk menyimpan file input dan output yang digunakan oleh Layanan Agregasi (contoh: file laporan terenkripsi, laporan ringkasan output, dll.).
Database Metadata Tugas
Layanan Cloud Terkelola: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
Database Metadata Tugas menyimpan dan melacak status tugas agregasi. Database mencatat metadata seperti waktu pembuatan, waktu yang diminta, waktu diperbarui, dan status (contoh: Diterima, Sedang Berlangsung, Selesai, dll.). Aggregation Worker 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)
Aggregation Worker memproses permintaan tugas yang dimulai oleh permintaan tugas di Antrean Tugas, mendekripsi input terenkripsi menggunakan kunci yang diambil dari Key Generation and Distribution Service (KGDS) di Koordinator. Untuk meminimalkan latensi pemrosesan tugas, kunci dekripsi di-cache di Aggregation Worker selama 8 jam, yang dapat digunakan di seluruh tugas yang diproses oleh instance pekerja tersebut.
Pekerja beroperasi dalam instance Trusted Execution Environment (TEE). Setiap pekerja hanya menangani satu tugas dalam satu waktu. Teknologi iklan dapat mengonfigurasi beberapa pekerja untuk memproses tugas secara paralel dengan menetapkan konfigurasi penskalaan otomatis. Melalui penskalaan otomatis, jumlah pekerja disesuaikan secara dinamis dengan jumlah pesan yang tersisa di antrean tugas. Jumlah pekerja minimum dan maksimum untuk penskalaan otomatis dapat dikonfigurasi melalui file lingkungan Terraform. Informasi selengkapnya tentang penskalaan otomatis dapat ditemukan dalam skrip terraform berikut. [Amazon Web Services / Google Cloud]
Pekerja Agregasi memanggil layanan Akuntansi Laporan Agregat untuk akuntansi laporan agregat. Layanan akuntansi laporan gabungan akan memastikan bahwa tugas hanya dijalankan selama belum melampaui batas anggaran privasi. (Lihat aturan"Tidak ada duplikat"). Jika anggaran tersedia, laporan ringkasan akan dibuat menggunakan agregat yang berisi derau. Baca detail tambahan terkait pencatatan laporan gabungan.
Worker Agregasi memperbarui metadata tugas di Database Metadata Tugas, termasuk kode return tugas yang sesuai dan penghitung error laporan jika terjadi kegagalan laporan sebagian. Pengguna dapat mengambil status menggunakan API pengambilan status tugas (getJob).
Untuk deskripsi Layanan Agregasi yang lebih mendetail, lihat penjelasan kami.
Langkah berikutnya
Setelah Anda mendapatkan sorotan Layanan Agregasi, sekarang saatnya Anda men-deploy instance Layanan Agregasi Anda sendiri melalui Google Cloud atau Amazon Web Services. Lihat bagian memulai atau jika Anda memerlukan informasi selengkapnya tentang cara mengoperasikan Layanan Agregasi yang di-deploy, ikuti link ini untuk mempelajari lebih lanjut cara mengoperasikan Layanan Agregasi.
Pemecahan masalah
Lihat dokumen Kode error umum dan mitigasi untuk mengetahui deskripsi pesan error yang lebih mendetail, 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.