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
| Proposal | Status |
|---|---|
| Dukungan Layanan Agregasi untuk Amazon Web Services (AWS) di Attribution Reporting API, Private Aggregation API
Penjelasan |
Tersedia |
| Dukungan Layanan Agregasi untuk Google Cloud di Attribution Reporting API, Private Aggregation API Penjelasan |
Tersedia |
| Pendaftaran situs Layanan Agregasi dan agregasi multi-asal. Pendaftaran situs mencakup pemetaan situs ke akun cloud (AWS, atau GCP). Untuk menggabungkan beberapa origin, origin tersebut harus berasal dari situs yang sama.
FAQ di GitHub Dokumentasi API agregasi situs |
Tersedia |
| Nilai epsilon Layanan Agregasi akan dipertahankan dalam rentang hingga 64 untuk memfasilitasi eksperimen dan masukan terkait parameter yang berbeda.
Mengirim masukan epsilon ARA. Kirim masukan epsilon PAA. |
Tersedia. Kami akan memberikan pemberitahuan awal kepada ekosistem sebelum nilai rentang epsilon diperbarui. |
| Pemfilteran kontribusi yang lebih fleksibel untuk kueri Layanan Agregasi
Penjelasan |
Tersedia |
| Proses pemulihan anggaran pasca-bencana (error, kesalahan konfigurasi, dan sebagainya)
Penjelasan |
Mekanisme yang Tersedia untuk meninjau persentase ID bersama yang dipulihkan oleh teknologi iklan menggunakan pemulihan anggaran dan menangguhkan pemulihan pada masa mendatang untuk pemulihan berlebihan yang direncanakan untuk Semester 1 2025 |
| Accenture beroperasi sebagai salah satu Koordinator di Blog Developer AWS |
Tersedia |
| Pihak independen yang beroperasi sebagai salah satu Koordinator di blog Developer Google Cloud |
Tersedia |
| Dukungan Layanan Agregasi untuk Pelaporan Debug Gabungan di Attribution Reporting API
Penjelasan |
Tersedia |
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:
| 术语 | 说明 |
|---|---|
| 汇总服务 | 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。 |
| 可汇总的报告 |
可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。 详细了解可汇总的报告。 |
| 可汇总报告的会计核算 | 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。 |
| 可汇总报告的会计核算预算 | 对预算的引用，用于确保报告不会被处理多次。 |
| 可信执行环境 (TEE) |
可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。 如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。 |
| 协调员 |
协调者是负责密钥管理和可汇总报告的会计核算的实体。协调者维护已获批准的汇总服务配置的哈希列表，并配置对解密密钥的访问权限。 |
| 共享 ID |
计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。
这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。
详细了解可信服务器。
|
| 汇总报告 |
摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。 |
| 举报来源 |
报告来源是接收可汇总报告的实体，也就是调用 Attribution Reporting API 的广告技术平台。可汇总报告的来源 将用户设备转到与报告关联的已知网址 来源。此报告来源应在注册期间指定。 |
| 贡献债券 | 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。 |
| 噪声和缩放 | 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。 |
| 证明 |
认证是一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务方案，证明会将广告技术平台运营的汇总服务中运行的代码与开放源代码进行匹配。 详细了解证明。 |
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.