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:
| Istilah | Deskripsi |
|---|---|
| Layanan Agregasi | Layanan yang dioperasikan teknologi iklan yang memproses laporan agregat untuk membuat laporan ringkasan. |
| Laporan Gabungan |
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. Pelajari laporan gabungan lebih lanjut. |
| Akuntansi Laporan Gabungan | Ledger terdistribusi yang terletak di kedua koordinator yang melacak anggaran privasi yang dialokasikan dan menerapkan aturan 'Tidak Ada Duplikat'. Ini adalah mekanisme perlindungan privasi, yang terletak dan dijalankan dalam koordinator, yang memastikan bahwa tidak ada laporan yang melewati Layanan Agregasi di luar anggaran privasi yang dialokasikan. Baca selengkapnya tentang strategi pengelompokan dan kaitannya dengan laporan gabungan. |
| Anggaran Akuntansi Laporan Agregat | Referensi ke anggaran yang memastikan laporan tidak diproses lebih dari sekali. |
| Trusted Execution Environment (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 |
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 Bersama |
Nilai komputasi yang terdiri dari: shared_info, reporting_origin, destination_site (hanya tersedia untuk Attribution Reporting API), source_registration-time (hanya tersedia untuk Attribution Reporting API), scheduled_report_time, version.
Artinya, beberapa laporan termasuk dalam ID bersama yang sama jika memiliki atribut yang sama di kolom shared_info. Hal ini berperan penting dalam Akuntansi Laporan Agregat.
Baca selengkapnya tentang Server Tepercaya.
|
| Laporan Ringkasan |
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 |
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. |
| Ikatan Kontribusi | Laporan agregat dapat berisi jumlah inkremental penghitung. Misalnya, laporan dapat berisi jumlah produk yang telah dilihat pengguna di situs pengiklan. Jumlah peningkatan di semua laporan agregat yang terkait dengan peristiwa sumber tunggal tidak boleh melebihi batas yang diberikan, `L1=2^16`. Pelajari lebih lanjut di penjelasan laporan agregat. |
| Kebisingan & Penskalaan | Sejumlah derau statistik ditambahkan ke laporan ringkasan sebagai bagian dari proses agregasi yang juga berfungsi untuk menjaga privasi dan memastikan laporan akhir memberikan informasi pengukuran yang dianonimkan. Baca selengkapnya tentang mekanisme derau tambahan, yang diambil dari distribusi Laplace. |
| Pengesahan |
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 pengesahan. |
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.