Bagian 1 dari 3 tentang proses debug Attribution Reporting. Pelajari alasan pentingnya proses debug dan waktu penggunaan laporan debug dalam pengujian.
Alasan Anda memerlukan laporan debug
Jika Anda sedang menguji Attribution Reporting API, Anda harus memeriksa apakah integrasi Anda berfungsi dengan benar, memahami kesenjangan dalam hasil pengukuran antara penerapan berbasis cookie dan penerapan Attribution Reporting, serta memecahkan masalah apa pun terkait integrasi Anda.
Laporan debug diperlukan untuk menyelesaikan tugas ini. Oleh karena itu, sebaiknya Anda menyiapkan fitur tersebut.
Glosarium
Aspek utama laporan debug
Dua jenis laporan debug
Dua jenis laporan proses debug tersedia. Gunakan keduanya karena memenuhi kasus penggunaan yang berbeda.
Laporan debug keberhasilan
Laporan proses debug keberhasilan melacak pembuatan laporan atribusi yang berhasil. Atribut ini terkait langsung dengan laporan atribusi.
Laporan debug keberhasilan telah tersedia sejak Chrome 101 (April 2022).
Laporan debug panjang
Laporan debug panjang memberi Anda visibilitas yang lebih besar ke dalam peristiwa sumber dan pemicu—sehingga Anda dapat memastikan bahwa sumber berhasil didaftarkan, atau melacak laporan yang hilang dan menentukan alasan laporan tersebut hilang (kegagalan dalam peristiwa sumber atau pemicu, kegagalan saat mengirim atau membuat laporan). Laporan debug panjang menunjukkan:
- Kasus saat browser berhasil mendaftarkan sumber.
- Kasus saat browser tidak berhasil mendaftarkan peristiwa sumber atau pemicu — yang berarti browser tidak akan membuat laporan atribusi.
- Kasus saat laporan atribusi tidak dapat dibuat atau dikirim karena alasan tertentu.
Laporan debug panjang menyertakan kolom type yang menjelaskan pendaftaran sumber yang berhasil, atau alasan mengapa laporan atribusi, pemicu, atau sumber tidak dibuat.
Laporan debug verbose telah tersedia sejak Chrome 109 (Januari 2023)—kecuali laporan debug verbose keberhasilan pendaftaran sumber yang ditambahkan kemudian di Chrome 112.
Tinjau contoh laporan di Bagian 2: Menyiapkan laporan debug.
Laporan debug berbasis cookie
Untuk menggunakan laporan debug, origin pelaporan harus menetapkan cookie.
Jika origin yang dikonfigurasi untuk menerima laporan adalah pihak ketiga, cookie ini akan menjadi cookie pihak ketiga. Artinya, laporan debug hanya dibuat jika cookie pihak ketiga diizinkan di browser pengguna.
Laporan debug akan langsung dikirim
Laporan debug dikirim segera oleh browser ke origin pelaporan. Hal ini berbeda dengan laporan atribusi, yang dikirim dengan penundaan.
Laporan debug keberhasilan dibuat dan dikirim segera setelah laporan atribusi yang sesuai dibuat, yaitu saat pendaftaran pemicu.
Laporan debug panjang dikirim segera setelah pendaftaran sumber atau pemicu.
Laporan debug memiliki jalur endpoint yang berbeda
Seperti laporan atribusi, semua laporan debug dikirim ke origin pelaporan. Laporan debug dikirim ke tiga endpoint terpisah dari origin pelaporan:
- Endpoint untuk laporan debug sukses, tingkat peristiwa
- Endpoint untuk laporan proses debug sukses, dapat diagregasi
- Endpoint untuk laporan debug verbose, tingkat peristiwa dan agregat.
Pelajari lebih lanjut di Bagian 2: Menyiapkan laporan debug.
Kasus penggunaan
Pemeriksaan integrasi real-time dasar
Laporan debug dikirim ke endpoint Anda dengan segera, tidak seperti laporan atribusi yang ditunda untuk melindungi privasi pengguna. Gunakan laporan debug sebagai sinyal real-time bahwa integrasi Anda dengan Attribution Reporting API berfungsi.
Pelajari cara melakukannya di Bagian 3: Buku resep debugging.
Analisis kerugian
Tidak seperti cookie pihak ketiga, Attribution Reporting API menyertakan perlindungan privasi bawaan, yang dirancang untuk menyeimbangkan utilitas dan privasi. Artinya, dengan Attribution Reporting API, Anda mungkin tidak dapat mengumpulkan semua data pengukuran yang dapat Anda kumpulkan dengan cookie. Tidak semua konversi yang dapat Anda lacak dengan cookie pihak ketiga akan menghasilkan laporan atribusi.
Salah satu contoh: untuk laporan tingkat peristiwa, Anda dapat mendaftarkan paling banyak satu konversi per tayangan iklan. Artinya, untuk tayangan iklan tertentu, Anda hanya akan mendapatkan satu laporan atribusi, berapa pun frekuensi pengguna melakukan konversi.
Gunakan laporan debug untuk mendapatkan visibilitas ke dalam perbedaan antara hasil pengukuran berbasis cookie dan hasil yang Anda peroleh dengan Attribution Reporting API. Tentukan konversi mana yang dilaporkan, berapa banyak konversi yang tidak dilaporkan, dan secara khusus konversi mana dan alasannya.
Pelajari cara menjalankan analisis kerugian di Bagian 3: Buku panduan debugging.
Pemecahan masalah
Meskipun kehilangan yang disebabkan oleh perlindungan privasi atau resource dapat diperkirakan, kehilangan lainnya mungkin tidak disengaja. Kesalahan konfigurasi dalam penerapan atau bug di browser itu sendiri dapat menyebabkan laporan hilang.
Anda dapat menggunakan laporan debug untuk mendeteksi dan memperbaiki masalah penerapan di sisi Anda, atau untuk melaporkan potensi bug kepada tim browser. Pelajari cara melakukannya di Bagian 3: Buku panduan debugging.
Pemeriksaan konfigurasi lanjutan
Beberapa fitur Attribution Reporting API memungkinkan Anda menyesuaikan perilaku API. Aturan pemfilteran, aturan penghapusan duplikat, dan aturan prioritas adalah beberapa contohnya.
Saat menggunakan fitur ini, gunakan laporan debug untuk memeriksa apakah logika Anda menghasilkan perilaku yang diinginkan dalam produksi, tanpa menunggu laporan atribusi. Pelajari cara melakukannya di Bagian 3: Buku resep debugging.
Pengujian lokal dengan laporan gabungan
Tidak seperti laporan atribusi gabungan yang dienkripsi, laporan debug gabungan mencakup payload yang tidak dienkripsi.
Gunakan laporan debug yang dapat digabungkan untuk memvalidasi isi laporan yang dapat digabungkan, dan untuk membuat laporan ringkasan dengan alat agregasi lokal untuk pengujian.
Memproses ulang laporan Layanan Agregasi
Keuntungan lain menggunakan mode debug adalah Anda dapat memproses laporan lagi. Oleh karena itu, untuk memproses laporan lebih dari sekali, pastikan laporan debug diaktifkan. Anda mungkin perlu memproses ulang laporan saat Anda:
- mencoba men-debug Layanan Agregasi.
- bereksperimen dengan berbagai strategi pengelompokan.
- bereksperimen dengan berbagai nilai epsilon.
Pemulihan data
Sebaiknya teknologi iklan mengaktifkan mode debug untuk menerima laporan debug sehingga mereka dapat memulihkan data pelaporan. Hal ini berguna dalam kasus masalah Layanan Agregasi seperti layanan yang tidak tersedia atau tidak responsif yang dapat menyebabkan pembuatan laporan ringkasan gagal.
Berikutnya
Bagian 2: Menyiapkan laporan debug