Mengukur kapan klik atau penayangan iklan menghasilkan konversi, seperti pembelian di situs pengiklan.
Ditujukan untuk siapa ini?
Di sini Anda akan menemukan dasar-dasar Attribution Reporting dan beberapa konsep dasar, tetapi tidak banyak detail teknis.
- Jika Anda bekerja dalam iklan atau teknologi iklan, Anda akan mempelajari cara API ini memberikan kemampuan yang diaktifkan oleh cookie pihak ketiga. Lihat kasus penggunaan API, yang memiliki detail lebih lengkap tentang cara laporan dibuat.
- Jika Anda adalah developer atau software engineer, buka ringkasan sistem lengkap atau bereksperimen dan berpartisipasi menggunakan 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 Attribution Reporting jika rencana teknologi iklan Anda diintegrasikan dengan API ini.
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 tersebut dapat digunakan untuk melacak pengguna di berbagai situs dan menghambat 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 penayangan 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 kurang memahami beberapa istilah atau konsep ini, lihat glosarium Privacy Sandbox.
Coba API
- Uji secara lokal di browser Anda. Setel flag, yang memberi tahu browser Chrome untuk mengaktifkan fitur eksperimental tertentu.
Jika Anda tertarik untuk bereksperimen dengan API tersebut, buka Attribution Reporting: bereksperimen dan berpartisipasi.
Perubahan API
- Pantau perubahan API.
- Pelajari alasan kami mengirimkan Attribution Reporting API pada paruh pertama tahun 2023.
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: Penjelasan lintas perangkat |
Proposal ini telah diarsipkan. Saat ini tidak ada rencana untuk penerapan. |
Mencegah laporan gabungan yang tidak valid menggunakan verifikasi laporan Penjelasan |
Akan tersedia di Chrome pada Semester 1 2024 |
Daftar default yang diizinkan untuk Kebijakan Izin Attribution Reporting API akan tetap ada * Pengumuman milis |
Tersedia di Chrome pada Kuartal 1 2023 |
Esilon pelaporan Level Peristiwa yang Dapat Dikonfigurasi Masalah GitHub |
Tersedia di Chrome pada Q4 2023 |
Padding untuk payload laporan Gabungan Penjelasan yang diperbarui |
Tersedia di Chrome pada Q4 2023 |
Tingkat Peristiwa Fleksibel Fase 1 Lite Penjelasan konfigurasi tingkat peristiwa fleksibel |
Tersedia di Chrome pada K4 2023
Kemampuan untuk menyesuaikan jumlah laporan atribusi dan jumlah/panjang periode pelaporan. Tersedia di Chrome pada K1 2024 Kemampuan untuk menyesuaikan jumlah bit data pemicu. |
Dukungan untuk proses debug Pelaporan Atribusi setelah penghentian cookie pihak ketiga Mencari masukan di GitHub |
Akan tersedia di Chrome pada Semester 1 2024 |
Dukungan untuk Attribution Reporting API dan Layanan Agregasi untuk Google Cloud Penjelasan Attribution Reporting API Penjelasan Layanan Agregasi |
Tersedia di Chrome pada Semester 2 2023 |
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 tampilan iklan tertentu (di sisi iklan) dengan data di sisi konversi. Data sisi konversi sangat terbatas, dan data tersebut dibunyikan (artinya, untuk sebagian kecil kasus, data acak yang dikirim, bukan laporan sebenarnya). Tindakan 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 daripada laporan tingkat peristiwa. Kombinasi teknik privasi membantu mengurangi risiko penggabungan identitas lintas situs.
Laporan tingkat peristiwa
Laporan tingkat peristiwa mengaitkan klik atau tampilan iklan dengan data konversi umum.
![Laporan tingkat peristiwa](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=7&hl=id)
news.example
(dilampirkan ke ID pengguna Bob_Doe pada news.example
) telah menghasilkan pembelian pada 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 menyediakan data pelatihan untuk model machine learning.
- Pelaporan umum, yang hanya 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 yang 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 tidak valid atau spam.
Laporan ringkasan
Laporan ringkasan (sebelumnya dikenal sebagai laporan gabungan) menawarkan data konversi yang lebih mendetail dan fleksibilitas yang lebih besar untuk menggabungkan klik atau melihat data dan data konversi.
Pelajari laporan ringkasan lebih lanjut.
![Contoh insight dari laporan ringkasan.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=7&hl=id)
news.example
telah menghasilkan 518 konversi pada shoes.example
, dan total pembelanjaan sebesar $38.174. Setengah dari konversi berasal dari pengguna di NYC, AS.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)—merupakan area penelitian aktif.
Fitur lainnya
Fitur lain dari API ini termasuk:
- Atribusi aplikasi ke web: lihat atau klik iklan di aplikasi lalu lakukan konversi di web.
Dukungan browser
- Firefox dan Edge belum berbagi sinyal.
- Safari dan Webkit bersifat negatif dan mengusulkan API lain 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 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 tentang sisi klik/tampilan 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.
- API tidak aktif saat cookie pihak ketiga dinonaktifkan.
Bagaimana situs dapat mengontrol akses?
Jika tersedia di browser tertentu, API akan tersedia secara default di situs mana pun, baik dalam dokumen dan skrip tingkat atas, maupun dalam iframe origin yang sama.
Pihak ketiga arbitrer—misalnya, iframe iklan lintas origin yang tidak ditambahkan ke halaman dengan skrip yang memiliki akses tingkat atas—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.
Situs dapat menonaktifkan Attribution Reporting API untuk semua pihak, termasuk skrip dengan akses level 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.
Laporan tingkat peristiwa
![laporan tingkat peristiwa](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=7&hl=id)
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 sedikit keterlambatan dan derau.
Laporan ringkasan
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=7&hl=id)
Laporan ringkasan dibuat sebagai berikut:
- Pengguna mengklik atau melihat iklan yang dikonfigurasi secara khusus. Browser—di perangkat lokal pengguna—merekam peristiwa ini, bersama dengan data konfigurasi atribusi yang telah ditentukan sebelumnya.
- Kemudian, saat pengguna melakukan konversi, browser 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 sebagaimana laporan tingkat peristiwa.
Baca selengkapnya tentang laporan ringkasan.
Privasi
Tidak seperti cookie pihak ketiga, Attribution Reporting API memungkinkan perusahaan iklan mendapatkan insight tentang konversi tanpa melacak aktivitas individu di seluruh situs.
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 Bobi di news.example
dan di
shoes.example
. Teknologi iklan dapat menggabungkan potongan-potongan
informasi ini untuk membuat profil Bob yang mendetail,
termasuk lokasi Bob, kebiasaan penjelajahan, dan
bacaan pilihan 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 menghambat privasi pengguna:
Aktivitas Bob dilacak di seluruh situs dengan detail tingkat tinggi.
![Tampilan berdampingan dari web saat ini (identitas gabungan) dan web masa depan (identitas yang dipartisi)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=7&hl=id)
Sejumlah kecil informasi digabungkan lintas situs—cukup untuk mengukur konversi, namun tidak cukup untuk melacak aktivitas Bobi di berbagai situs secara mendetail. Aktivitas
Bob di news.example
dan shoes.example
tetap
terpisah.
Perlindungan di setiap jenis laporan
Laporan tingkat peristiwa menautkan ID sisi iklan dengan sejumlah kecil data sisi konversi. Meskipun memberikan informasi lintas situs tentang konversi, informasi sisi konversi terlalu umum untuk menggabungkan identitas pengguna di seluruh situs.
Laporan ringkasan memberikan insight yang mendetail, tetapi hanya di tingkat agregat. Karena konten laporan agregat ini dienkripsi saat dikirim ke teknologi iklan, teknologi iklan tidak dapat memperoleh informasi apa pun dari laporan tanpa menggunakan layanan agregasi. Layanan agregasi hanya menyediakan akses ke agregat yang berisik.
Perlindungan privasi tambahan seperti pembatasan kapasitas diberlakukan pada laporan tingkat peristiwa dan agregat.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=7&hl=id)
Secara detail: Laporan dan privasi tingkat peristiwa
Laporan tingkat peristiwa memberikan insight konversi tanpa melacak pengguna di berbagai situs, dengan mengikuti mekanisme privasi berikut:
- Tidak ada ID lintas situs yang digunakan dan tidak ada aktivitas penjelajahan lintas situs mendetail yang akan keluar dari perangkat.
- Laporan tingkat peristiwa mengaitkan 64 bit informasi di sisi iklan
(
news.example
) hanya dengan 1 bit atau 3 bit pada 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 kecil: 1 bit atau 3 bit, yang tidak cukup untuk menyimpan ID.- 64 bit sisi iklan bukanlah informasi baru. Saat ini, User-ID sudah
tersedia di sisi iklan.
news.example
atauadtech.example
sudah mengetahui tentang aktivitas pengguna tertentu dinews.example
.
- 64 bit sisi iklan bukanlah informasi baru. Saat ini, User-ID sudah
tersedia di sisi iklan.
- Perlindungan tambahan diterapkan untuk mencegah penyalahgunaan dan pelacakan lintas situs:
- Laporan dikirim dengan penundaan.
- Data konversi dibisukan: dalam persentase tertentu, laporan palsu dibuat.
- Jumlah laporan konversi yang diatribusikan dibatasi per klik atau tampilan.
Detail: Laporan ringkasan dan privasi
Laporan ringkasan mengaitkan peristiwa klik atau penayangan dengan data konversi yang mendetail. Cookie ini menyediakan 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 hasil laporan ringkasan. Setiap pengguna tertentu dapat memicu beberapa atribusi untuk klik (atau tampilan) dan konversi tertentu.
- Data digabungkan hingga tingkat banyak peristiwa (banyak pengguna) dan tidak ada peristiwa individual yang dapat diamati secara tepat. Saat melihat data gabungan, saat tingkat detail meningkat, derau relatif pada data tersebut juga meningkat. Slice data yang menggabungkan banyak peristiwa dan pengguna akan lebih akurat untuk mempertahankan kegunaan.
- Laporan mentah yang mengaitkan peristiwa klik atau penayangan mendetail dengan data konversi mendetail akan 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 bagian data yang berbeda memiliki batas kapasitas.
Berinteraksi dan memberikan masukan
- Untuk pertanyaan tentang API: buat masalah di repositori API.
- Ikuti info terbaru dan pengumuman API di milis Pelaporan Atribusi.
- Jika Anda memiliki pertanyaan teknis, laporkan bug Chromium.
- Untuk pertanyaan penerapan, integrasi, dan praktik terbaik umum: membuat masalah di repositori dukungan developer Privacy Sandbox.