Ringkasan Attribution Reporting untuk Web

Ukur kapan klik atau penayangan iklan menghasilkan konversi, seperti pembelian di situs pengiklan.

Untuk siapa alat ini?

Di sini Anda akan menemukan dasar-dasar Pelaporan Atribusi dan beberapa konsep yang mendasarinya, tetapi tidak banyak detail teknis.

• Jika Anda bekerja di bidang iklan atau teknologi iklan, Anda akan mempelajari cara API ini menyediakan kemampuan yang diaktifkan oleh cookie pihak ketiga. Lihat kasus penggunaan API, yang memiliki detail selengkapnya tentang cara laporan dibuat.
• Jika Anda adalah developer atau engineer software, buka ringkasan sistem lengkap atau bereksperimen dan berpartisipasi dengan API.

Pengiklan dan penayang yang mengandalkan platform teknologi iklan untuk pengukuran konversi tidak perlu menggunakan API secara langsung. Anda mungkin tertarik untuk memahami cara kerja Pelaporan Atribusi jika teknologi iklan Anda berencana untuk berintegrasi dengan API ini.

Catatan: Di masa mendatang, Attribution Reporting API dapat melayani kasus penggunaan yang tidak terkait dengan iklan.

Apa itu Attribution Reporting API?

Saat ini, pengukuran konversi iklan sering kali mengandalkan cookie pihak ketiga. Browser membatasi akses ke cookie pihak ketiga karena cookie ini dapat digunakan untuk melacak pengguna di seluruh situs dan mengganggu privasi pengguna.

Attribution Reporting API memungkinkan pengukuran tersebut dengan cara yang menjaga privasi, tanpa cookie pihak ketiga.

API ini memungkinkan pengiklan dan penyedia teknologi iklan mengukur konversi dalam kasus berikut:

• Klik dan tampilan iklan.
• Iklan dalam iframe pihak ketiga, seperti iklan di situs penayang yang menggunakan penyedia teknologi iklan pihak ketiga.
• Iklan dalam konteks pihak pertama, seperti iklan di jaringan sosial atau halaman hasil mesin telusur, atau penayang yang menayangkan iklannya sendiri.

Jika Anda tidak memahami beberapa istilah atau konsep ini, lihat glosarium Privacy Sandbox.

Coba API

• Uji secara lokal di browser Anda. Menetapkan flag, yang memberi tahu browser Chrome untuk mengaktifkan fitur eksperimen tertentu.

Jika Anda tertarik untuk bereksperimen dengan API, buka Pelaporan Atribusi: bereksperimen dan berpartisipasi.

Catatan: API ini masih dalam proses pengembangan dan akan berkembang dari waktu ke waktu, bergantung pada masukan dan input ekosistem. Masukan Anda membantu memastikan bahwa solusi untuk berbagai kasus penggunaan dibahas. API ini sedang diinkubasi dan dikembangkan di tempat terbuka. Pertimbangkan untuk berpartisipasi dalam diskusi.

Perubahan API

• Pantau perubahan API.
• Pelajari alasan kami meluncurkan Attribution Reporting API pada paruh pertama tahun 2023.

Catatan: Attribution Reporting sebelumnya dikenal sebagai Event Conversion Measurement API. Nama ini diubah pada tahun 2022, karena cakupan tingkat peristiwa asli diperluas untuk mencakup kasus penggunaan pengukuran tambahan.

Ketersediaan

Proposal	Status
Perjalanan konversi: aplikasi ke web Penjelasan web dan Penjelasan Android Pengumuman milis	Tersedia di Chrome dan Android untuk uji coba origin
Perjalanan konversi: lintas-perangkat Penjelasan	Proposal ini telah diarsipkan. Saat ini tidak ada rencana untuk penerapan.
Mencegah laporan agregat yang tidak valid menggunakan verifikasi laporan Penjelasan	Proposal ini telah diarsipkan. Sebagai gantinya, kami telah mengimplementasikan trigger_context_id untuk kasus penggunaan ini.
Daftar yang diizinkan default untuk Kebijakan Izin Attribution Reporting API akan tetap * Pengumuman milis	Tersedia di Chrome pada K1 2023
Epsilon pelaporan tingkat peristiwa yang dapat dikonfigurasi Masalah GitHub	Tersedia di Chrome pada Kuartal 4 2023
Padding untuk payload laporan agregat Penjelasan yang diperbarui	Tersedia di Chrome pada Kuartal 4 2023
Tingkat peristiwa fleksibel Penjelasan konfigurasi tingkat peristiwa fleksibel	Tersedia di Chrome pada Kuartal 4 2023 Kemampuan untuk menyesuaikan jumlah laporan atribusi dan jumlah/durasi periode pelaporan. Tersedia di Chrome pada K1 2024 Kemampuan untuk menyesuaikan jumlah bit data pemicu.
Dukungan untuk laporan proses debug panjang Pelaporan Atribusi yang tidak bergantung pada cookie pihak ketiga Penjelasan	Tersedia di Chrome pada Kuartal 3 2024
Dukungan untuk Attribution Reporting API dan Layanan Agregasi untuk Google Cloud Penjelasan Attribution Reporting API Penjelasan Layanan Agregasi	Tersedia di Chrome pada paruh kedua tahun 2023
Penjelasan Pemfilteran kontribusi yang fleksibel	Tersedia di Chrome pada Kuartal 3 2024
Pemfilteran pra-atribusi: cakupan atribusi Penjelasan	Tersedia di Chrome pada Kuartal 4 2024

Catatan: Untuk mengetahui ringkasan status semua Privacy Sandbox API, lihat linimasa Privacy Sandbox.

Kasus penggunaan dan fitur

Attribution Reporting API memberikan akses ke berbagai jenis insight dengan dua jenis laporan yang dapat dikirim ke pengiklan atau penyedia teknologi iklan pihak ketiga. Kedua jenis laporan ini dapat digunakan secara bersamaan dan saling melengkapi.

• Laporan tingkat peristiwa mengaitkan klik atau penayangan iklan tertentu (di sisi iklan) dengan data di sisi konversi. Data sisi konversi sangat terbatas, dan data tersebut berisi derau (artinya untuk sebagian kecil kasus, data acak dikirim, bukan laporan sebenarnya). Hal ini menjaga privasi pengguna dengan mencegah penggabungan identitas pengguna di seluruh situs. Sebagai perlindungan privasi tambahan, laporan dikirim dengan penundaan.
• Laporan ringkasan tidak terikat dengan peristiwa tertentu di sisi iklan. Laporan ini memberikan data konversi yang lebih lengkap dengan fidelitas lebih tinggi dibandingkan laporan tingkat peristiwa. Kombinasi teknik privasi membantu mengurangi risiko penggabungan identitas di seluruh situs.

Laporan tingkat peristiwa

Laporan tingkat peristiwa mengaitkan klik atau penayangan iklan dengan data konversi kasar.

Contoh laporan tingkat peristiwa: ID klik 200400600 di news.example (disertakan dengan ID pengguna Bob_Doe di news.example) telah menghasilkan pembelian di shop.example.

Laporan tingkat peristiwa cocok untuk:

• Pengoptimalan. Jawab pertanyaan seperti "Bagaimana cara meningkatkan laba atas investasi saya?". Secara khusus, laporan ini dapat digunakan untuk mengoptimalkan penempatan iklan, karena ID unik sisi iklan dapat disediakan dalam laporan. Laporan tingkat peristiwa dapat memberikan data pelatihan untuk model machine learning.
• Pelaporan kasar, yang memerlukan sangat sedikit informasi tentang konversi. Batas saat ini adalah 3 bit data konversi untuk klik⏤artinya, konversi dapat diberi salah satu dari delapan kategori⏤dan 1 bit untuk tampilan. Encoding data sisi konversi terperinci, seperti harga atau waktu konversi tertentu tidak didukung dalam laporan tingkat peristiwa.
• Deteksi penipuan. Data dalam beberapa laporan dapat berguna untuk deteksi dan analisis penipuan iklan, dengan memungkinkan Anda memahami pola yang dapat digunakan untuk mengidentifikasi aktivitas spam atau tidak valid.

Laporan ringkasan

Laporan ringkasan (sebelumnya dikenal sebagai laporan gabungan) menawarkan data konversi yang lebih mendetail dan fleksibilitas yang lebih besar untuk menggabungkan data klik atau tampilan dan data konversi.

Pelajari laporan ringkasan lebih lanjut.

Berikut contoh insight dari laporan ringkasan: CampaignID 1234567 di news.example telah menghasilkan 518 konversi di shoes.example, dan total pembelanjaan sebesar $38.174. Setengah dari konversi berasal dari pengguna di NYC, Amerika Serikat.

Laporan ringkasan paling cocok untuk melaporkan kasus penggunaan. Laporan ini membantu menjawab pertanyaan seperti: "Berapa laba atas investasi saya?"

Penggunaan laporan ringkasan untuk pengoptimalan—misalnya, untuk mengoptimalkan nilai pembelian, yang tidak didukung oleh laporan tingkat peristiwa (karena data konversi terlalu kasar)—adalah area riset aktif.

Fitur lainnya

Fitur lain dari API ini mencakup:

• Atribusi aplikasi ke web: melihat atau mengklik iklan di aplikasi dan melakukan konversi di web.

Catatan: Di masa mendatang tanpa cookie pihak ketiga, API ini akan digabungkan dengan API iklan perlindungan privasi lainnya untuk mencakup kasus penggunaan menyeluruh: - Pemasaran ulang: lihat Protected Audience API - Pemilihan iklan berbasis minat: lihat Topics

Dukungan browser

• Firefox dan Edge belum membagikan sinyal.
• Safari dan Webkit negatif dan mengusulkan API yang berbeda untuk mengukur konversi iklan, yang disebut Pengukuran Klik Pribadi.

Meskipun kedua API tersebut berbeda, Chrome dan WebKit bekerja sama secara terbuka untuk menyederhanakan pengalaman developer, misalnya dengan menyelaraskan nama atribut dan struktur JSON untuk laporan.

Kumpulan fitur Attribution Reporting API berbeda dengan kumpulan fitur Private Click Measurement API yang diusulkan oleh Safari dan WebKit. Terutama, dengan Attribution Reporting API:

• Pengukuran lihat-tayang didukung.
• Laporan tingkat peristiwa dapat diberikan.
• Laporan ringkasan berisi informasi lengkap di sisi klik/penayangan dan sisi konversi.
• Pihak ketiga seperti platform teknologi iklan dapat menerima laporan atas nama penayang dan pengiklan.

Konfigurasi browser

• Pengguna dapat memilih untuk tidak menggunakan API dengan setelan pengguna di chrome://settings/adPrivacy.
• API tidak aktif dalam mode Samaran.

Catatan: API ini tidak bergantung pada cookie pihak ketiga. Namun, dalam fase pengujian, cookie pihak ketiga harus diaktifkan agar API dapat diaktifkan. Hal ini memungkinkan developer mendapatkan laporan debug dan membandingkan hasil API dengan atribusi berbasis cookie.

Bagaimana cara situs mengontrol akses?

Jika tersedia di browser tertentu, API akan tersedia secara default di situs tertentu, baik dalam dokumen dan skrip tingkat teratas, maupun dalam iframe dengan origin yang sama.

Pihak ketiga arbitrer—misalnya, iframe iklan lintas origin yang tidak ditambahkan ke halaman dengan skrip yang memiliki akses tingkat teratas—tidak dapat menggunakan API tanpa sepengetahuan penayang atau pengiklan: dalam iframe ini, Attribution Reporting API harus diaktifkan secara eksplisit dengan kebijakan Izin.

<iframe src="..." allow="attribution-reporting"></iframe>

Pihak ketiga dengan akses tingkat teratas yang menambahkan iframe lintas origin ke halaman juga dapat mengaktifkan Attribution Reporting API dengan kebijakan Izin.

Catatan:

Manfaat keamanan

Dengan melakukan hal ini, skrip dengan akses tingkat atas memungkinkan frame yang ditambahkan secara otomatis untuk menggunakan Pelaporan Atribusi. Hanya skrip pihak ketiga yang dipercaya oleh situs yang boleh diberi akses tingkat teratas, sehingga ini bukan masalah. Keuntungan keamanan utama kebijakan ini terletak di tempat lain: frame yang ditambahkan tanpa skrip tingkat atas tidak boleh dipercaya secara default untuk mendaftarkan sumber atau pemicu (kecuali jika penyematnya sudah dipercaya). Itulah sebabnya situs tingkat teratas diwajibkan untuk mengaktifkan API secara eksplisit untuk iframe ini.

Situs dapat menonaktifkan Attribution Reporting API untuk semua pihak, termasuk skrip dengan akses tingkat teratas, dengan mengirimkan header respons HTTP:

Permissions-Policy: attribution-reporting=()

Bagaimana cara kerja Attribution Reporting API?

Attribution Reporting API memungkinkan pengukuran dua peristiwa yang ditautkan bersama: peristiwa di situs penayang, seperti pengguna yang melihat atau mengklik iklan, dengan konversi berikutnya di situs pengiklan.

Catatan: Attribution Reporting API mungkin tidak sesuai untuk kebutuhan penagihan biaya per konversi, karena adanya derau yang ditambahkan ke tingkat peristiwa dan laporan ringkasan. Anda dapat membagikan masukan terkait dampak pada berbagai model penagihan oleh Attribution Reporting API di GitHub.

Laporan tingkat peristiwa

Laporan tingkat peristiwa dibuat sebagai berikut:
Browser mencocokkan klik atau penayangan dengan data konversi yang ditentukan oleh teknologi iklan.
Kemudian, browser mengirimkan laporan yang dihasilkan ke endpoint yang telah ditentukan, dengan beberapa penundaan dan derau.

Laporan ringkasan

Pembuatan laporan ringkasan

Laporan ringkasan dibuat sebagai berikut:

• Pengguna mengklik atau melihat iklan yang dikonfigurasi secara khusus. Browser—di perangkat lokal pengguna—mencatat peristiwa ini, bersama dengan data konfigurasi atribusi yang telah ditentukan sebelumnya.
• Kemudian, saat pengguna melakukan konversi, browser akan mencocokkan peristiwa klik atau penayangan mendetail ini (dikenal sebagai peristiwa sumber atribusi) dengan data konversi mendetail (dikenal sebagai data pemicu atribusi). Dimensi detail yang diambil telah ditentukan sebelumnya oleh perusahaan teknologi iklan, dan browser mengikuti logika tertentu yang ditentukan oleh teknologi iklan. Browser menghasilkan data ini dalam laporan agregat.
• Laporan agregat dienkripsi oleh browser dan dikirim ke server teknologi iklan. Dari server teknologi iklan, laporan agregat dikirim ke layanan agregasi untuk menghasilkan laporan ringkasan.
• Laporan ringkasan kemudian tersedia untuk teknologi iklan. Perhatikan bahwa laporan ringkasan tidak tertunda dalam jumlah yang sama seperti laporan tingkat peristiwa.

Baca selengkapnya tentang laporan ringkasan.

Privasi

Tidak seperti cookie pihak ketiga, Attribution Reporting API memungkinkan perusahaan periklanan mendapatkan insight tentang konversi tanpa melacak aktivitas individu di seluruh situs.

Mari kita ambil contoh orang bernama Bob. Bob melihat iklan saat membaca berita di news.example. Satu minggu kemudian, Bob membeli sepatu di shoes.example.

Saat ini, konversi ini akan dilacak oleh cookie pihak ketiga yang digunakan sebagai ID lintas situs. Dengan cookie pihak ketiga, perusahaan teknologi iklan dapat mengakses banyak detail tentang aktivitas Bob di news.example dan di shoes.example. Teknologi iklan dapat menggabungkan bagian-bagian informasi ini untuk membuat profil mendetail tentang Bob, termasuk lokasi, kebiasaan menjelajah, dan bacaan pilihan Bob di news.example. Profil ini juga dapat menyertakan informasi pembelian, aktivitas, dan kartu kredit di shoes.example. Gabungan lintas situs ini berguna untuk mengukur konversi iklan. Namun, hal ini dapat mengganggu privasi pengguna: Aktivitas Bob dilacak di seluruh situs dengan tingkat detail yang tinggi.

Tampilan berdampingan dari web saat ini (identitas gabungan) dan web masa depan (identitas partisi)

Sejumlah kecil informasi digabungkan di seluruh situs—cukup untuk mengukur konversi, tetapi tidak cukup untuk melacak aktivitas Bob di seluruh situs secara mendetail. Aktivitas Bob di news.example dan di shoes.example tetap terpisah.

Perlindungan di setiap jenis laporan

Laporan tingkat peristiwa menautkan ID sisi iklan dengan sejumlah kecil data sisi konversi. Meskipun menyediakan informasi lintas situs tentang konversi, informasi sisi konversi terlalu kasar untuk menggabungkan identitas pengguna di seluruh situs.

Laporan ringkasan memberikan insight mendetail, tetapi hanya pada tingkat gabungan; karena konten laporan agregat ini dienkripsi saat dikirim ke teknologi iklan, teknologi iklan tidak dapat mendapatkan informasi apa pun dari laporan tanpa menggunakan layanan agregasi. Layanan agregasi hanya memberikan akses ke agregat yang berisi derau.

Perlindungan privasi tambahan seperti batasan kapasitas diterapkan pada laporan tingkat peristiwa dan gabungan.

Secara mendetail: Laporan tingkat peristiwa dan privasi

Laporan tingkat peristiwa memberikan insight konversi tanpa melacak pengguna di seluruh situs, dengan mengikuti mekanisme privasi berikut:

• Tidak ada ID lintas situs yang digunakan dan tidak ada aktivitas penjelajahan lintas situs yang mendetail yang keluar dari perangkat.
• Laporan tingkat peristiwa mengaitkan informasi 64 bit di sisi iklan (news.example) dengan hanya 1 bit atau 3 bit di sisi konversi (shop.example). 64 bit adalah informasi yang cukup untuk dipetakan ke ID pengguna individual, tetapi 64 bit ini hanya dapat ditautkan dengan informasi lintas situs yang sangat sedikit: 1 bit atau 3 bit, yang tidak cukup untuk menyimpan ID.
  • 64 bit sisi iklan bukanlah informasi baru. ID pengguna sudah dapat tersedia di sisi iklan saat ini. news.example atau adtech.example sudah mengetahui aktivitas pengguna tertentu di news.example.
• Perlindungan tambahan diterapkan untuk mencegah penyalahgunaan dan pelacakan lintas situs:
  • Laporan dikirim dengan penundaan.
  • Data konversi diganggu: dalam persentase tertentu, laporan palsu akan dibuat.
  • Jumlah laporan konversi yang diatribusikan dibatasi per klik atau penayangan.

Secara mendetail: Laporan ringkasan dan privasi

Laporan ringkasan mengaitkan peristiwa klik atau tampilan dengan data konversi mendetail. Fitur ini memberikan insight konversi tanpa melacak pengguna di seluruh situs, dengan menggunakan mekanisme privasi berikut:

• Tidak ada ID lintas situs yang digunakan.
• Setiap atribusi dapat memberikan beberapa kontribusi pada laporan ringkasan yang dihasilkan. Setiap pengguna tertentu dapat memicu beberapa atribusi untuk klik (atau penayangan) dan konversi tertentu.
• Data digabungkan hingga tingkat banyak peristiwa (banyak pengguna) dan tidak ada peristiwa individual yang dapat diamati secara akurat. Saat melihat data gabungan, semakin tinggi tingkat detail, semakin tinggi juga derau relatif pada data tersebut. Slice data yang menggabungkan banyak peristiwa dan pengguna lebih akurat untuk mempertahankan kegunaan.
• Laporan mentah yang mengaitkan peristiwa klik atau penayangan mendetail dengan data konversi mendetail dienkripsi dan tidak dapat dibaca oleh perusahaan teknologi iklan. Data ini hanya dapat dibaca oleh layanan agregasi.
• Perlindungan tambahan diterapkan untuk mencegah penyalahgunaan dan pelacakan lintas situs:
  • Laporan dikirim dengan penundaan acak.
  • Kueri pada berbagai bagian data dibatasi kapasitasnya.

Berinteraksi dan memberikan masukan

• Untuk pertanyaan tentang API: buat masalah di repositori API.
• Ikuti pembaruan dan pengumuman API di mailing list Attribution Reporting.
• Jika Anda memiliki pertanyaan teknis, laporkan bug Chromium.
• Untuk pertanyaan tentang penerapan, integrasi, dan praktik terbaik umum: buat masalah di repositori dukungan developer Privacy Sandbox.