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 gabungan 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

Proposal	Status
Layanan Anggaran Privasi Lintas Cloud Penjelasan	Tersedia
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 disimpan sebagai rentang hingga 64, untuk memfasilitasi eksperimen dan masukan pada berbagai parameter. Kirim 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 untuk pemulihan anggaran pasca-bencana (error, kesalahan konfigurasi, dan sebagainya) Penjelasan	Tersedia Mekanisme untuk meninjau persentase ID bersama yang dipulihkan oleh teknologi iklan menggunakan pemulihan anggaran dan menangguhkan pemulihan mendatang untuk pemulihan yang berlebihan yang direncanakan untuk K1 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 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

Laporan gabungan 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 mengakses data pokok.

Pelajari laporan gabungan lebih lanjut.

Akuntansi Laporan Agregat

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 tidak ada laporan yang melewati Layanan Agregasi di luar anggaran privasi yang dialokasikan.

Baca selengkapnya tentang hubungan strategi pengelompokan dengan laporan agregat.

Anggaran Akuntansi Laporan Gabungan

Referensi ke anggaran yang memastikan setiap laporan tidak diproses lebih dari sekali.

Layanan Agregasi

Layanan yang dioperasikan teknologi iklan yang memproses laporan agregat untuk membuat laporan ringkasan.

Baca selengkapnya tentang latar belakang Layanan Agregasi di penjelasan dan daftar istilah lengkap kami.

Pengesahan

Mekanisme untuk mengautentikasi identitas software, biasanya dengan hash kriptografis atau tanda tangan. Untuk proposal layanan agregasi, pengesahan mencocokkan kode yang berjalan di layanan agregasi yang dioperasikan teknologi iklan Anda dengan kode open source.

Baca selengkapnya tentang pengesahan.

Bonding Kontribusi

Koordinator

Entitas yang bertanggung jawab atas pengelolaan kunci dan akuntansi laporan gabungan. Koordinator mengelola daftar hash konfigurasi layanan agregasi yang disetujui dan mengonfigurasi akses ke kunci dekripsi.

Derau dan Penskalaan

Derau statistik yang ditambahkan ke laporan ringkasan selama proses agregasi untuk menjaga privasi dan memastikan laporan akhir memberikan informasi pengukuran anonim.

Baca selengkapnya tentang mekanisme derau tambahan, yang diambil dari distribusi Laplace.

Asal Pelaporan

Entitas yang menerima laporan agregat—dengan kata lain, Anda atau teknologi iklan yang memanggil Attribution Reporting API. Laporan agregat dikirim dari perangkat pengguna ke URL terkenal yang terkait dengan asal pelaporan. Asal pelaporan ditetapkan selama pendaftaran.

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

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. Pelaporan ini memungkinkan fleksibilitas yang lebih besar dan memberikan model data yang lebih lengkap daripada pelaporan tingkat peristiwa, terutama untuk beberapa kasus penggunaan seperti nilai konversi.

Trusted Execution Environment (TEE)

Konfigurasi hardware dan software komputer yang aman yang memungkinkan pihak eksternal memverifikasi versi software yang tepat yang berjalan di komputer tanpa takut terekspos. TEE memungkinkan pihak eksternal memverifikasi bahwa software melakukan fungsi persis seperti yang diklaim oleh produsen software tersebut—tidak lebih dan tidak kurang.

Untuk mempelajari TEE yang digunakan untuk proposal Privacy Sandbox lebih lanjut, baca penjelasan layanan Protected Audience API dan penjelasan Layanan Agregasi.

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 saat laporan diterima dari perangkat web dan seluler, hingga saat laporan ringkasan dibuat di Layanan Agregasi.

1. Ambil kunci publik untuk membuat laporan terenkripsi.
2. Laporan gabungan yang dienkripsi 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 tertentu.
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 mengirimkan 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 asal 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.

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 Tugas

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. Pekerja Agregasi 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 menyimpan kunci dekripsi dalam cache 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 minimum dan maksimum pekerja 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 hasil 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 umum dan mitigasi 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.