Bagian 1 dari 3 tentang proses debug Pelaporan Atribusi. Pelajari alasan pentingnya proses debug dan kapan harus menggunakan laporan debug dalam pengujian.
Alasan Anda memerlukan laporan debug
Jika 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 menyiapkannya.
Glosarium
Aspek utama laporan debug
Dua jenis laporan debug
Ada dua jenis laporan debug yang tersedia. Gunakan keduanya, karena keduanya memenuhi kasus penggunaan yang berbeda.
Laporan debug sukses
Laporan debug sukses melacak pembuatan laporan atribusi yang berhasil. Laporan ini terkait langsung dengan laporan atribusi.
Laporan debug sukses telah tersedia sejak Chrome 101 (April 2022).
Laporan debug panjang
Laporan debug panjang memberi Anda visibilitas yang lebih baik ke sumber dan peristiwa pemicu—sehingga Anda dapat memastikan bahwa sumber berhasil didaftarkan, atau melacak laporan yang hilang dan menentukan penyebabnya (kegagalan dalam sumber atau peristiwa pemicu, kegagalan saat mengirim atau membuat laporan). Laporan debug panjang menunjukkan:
- Kasus saat browser berhasil mendaftarkan sumber.
- Kasus saat browser tidak berhasil mendaftarkan sumber atau peristiwa 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 laporan sumber, pemicu, atau atribusi tidak dibuat.
Laporan debug panjang telah tersedia sejak Chrome 109 (Januari 2023)—kecuali untuk laporan debug panjang keberhasilan pendaftaran sumber yang telah ditambahkan nanti di Chrome 112.
Tinjau contoh laporan di Bagian 2: Menyiapkan laporan debug.
Laporan debug berbasis cookie
Untuk menggunakan laporan debug, asal 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 langsung dikirim
Laporan debug langsung dikirim oleh browser ke origin pelaporan. Hal ini tidak seperti laporan atribusi, yang dikirim dengan penundaan.
Laporan debug sukses dibuat dan dikirim segera setelah laporan atribusi yang sesuai dibuat: yaitu, pada pendaftaran pemicu.
Laporan debug panjang langsung dikirim setelah pendaftaran sumber atau pemicu.
Laporan debug memiliki jalur endpoint yang berbeda
Seperti laporan atribusi, semua laporan debug dikirim ke asal pelaporan. Laporan debug dikirim ke tiga endpoint terpisah dari origin pelaporan:
- Endpoint untuk laporan debug sukses, tingkat peristiwa
- Endpoint untuk laporan debug sukses, yang dapat digabungkan
- Endpoint untuk laporan debug panjang, tingkat peristiwa, dan agregat.
Pelajari lebih lanjut di Bagian 2: Menyiapkan laporan debug.
Kasus penggunaan
Pemeriksaan integrasi real-time dasar
Laporan debug langsung dikirim ke endpoint Anda, tidak seperti laporan atribusi yang tertunda 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: Cookbook proses debug.
Analisis kerugian
Tidak seperti cookie pihak ketiga, Attribution Reporting API menyertakan perlindungan privasi bawaan, yang dirancang untuk menyeimbangkan antara utilitas dan privasi. Artinya, dengan Attribution Reporting API, Anda mungkin tidak dapat mengumpulkan semua data pengukuran yang dapat dikumpulkan dengan cookie. Tidak semua konversi yang dapat Anda lacak dengan cookie pihak ketiga akan menghasilkan laporan atribusi.
Satu contoh: untuk laporan tingkat peristiwa, Anda dapat mendaftarkan maksimal satu konversi per tayangan. Artinya, untuk tayangan iklan tertentu, Anda hanya akan mendapatkan satu laporan atribusi, berapa pun frekuensi konversi pengguna.
Gunakan laporan debug untuk mendapatkan visibilitas tentang perbedaan antara hasil pengukuran berbasis cookie dan hasil yang Anda dapatkan dengan Attribution Reporting API. Tentukan konversi mana yang dilaporkan, jumlah konversi yang tidak dilaporkan, dan secara khusus konversi mana dan alasannya.
Pelajari cara menjalankan analisis kerugian di Bagian 3: Cookbook proses debug.
Pemecahan masalah
Meskipun kerugian yang disebabkan oleh perlindungan privasi atau resource sudah diperkirakan, kerugian lainnya mungkin tidak disengaja. Konfigurasi yang salah dalam penerapan atau bug di browser itu sendiri dapat menyebabkan laporan hilang.
Anda dapat menggunakan laporan debug untuk mendeteksi dan memperbaiki masalah penerapan di pihak Anda, atau untuk melaporkan potensi bug kepada tim browser. Pelajari cara melakukannya di Bagian 3: Cookbook proses debug.
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: Cookbook proses debug.
Pengujian lokal dengan laporan gabungan
Tidak seperti laporan atribusi agregat yang dienkripsi, laporan debug agregat menyertakan payload yang tidak dienkripsi.
Gunakan laporan debug agregat untuk memvalidasi konten laporan agregat, dan untuk membuat laporan ringkasan dengan alat agregasi lokal untuk pengujian.
Memproses ulang laporan Layanan Agregasi
Keuntungan lain dari penggunaan mode debug adalah Anda dapat memproses laporan lagi. Oleh karena itu, untuk memproses laporan lebih dari sekali, pastikan laporan debug diaktifkan. Sebaiknya proses 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 agar dapat memulihkan data pelaporan mereka. Hal ini berguna jika terjadi masalah Layanan Agregasi seperti layanan yang tidak tersedia atau tidak responsif yang dapat menyebabkan pembuatan laporan ringkasan gagal.