Bagian 1 dari 3 tentang proses debug Attribution Reporting. Pelajari alasan pentingnya proses debug dan kapan harus menggunakan laporan debug dalam pengujian.
Alasan Anda memerlukan laporan debug
Jika Anda 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 semua masalah 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
Tersedia dua jenis laporan debug. Gunakan keduanya, karena keduanya memenuhi kasus penggunaan yang berbeda.
Laporan debug berhasil
Laporan debug keberhasilan melacak pembuatan laporan atribusi yang berhasil. Keduanya berhubungan 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 baik tentang peristiwa sumber dan pemicu—sehingga Anda dapat memastikan bahwa sumber berhasil didaftarkan, atau melacak laporan yang hilang dan menentukan alasan laporan tersebut tidak ada (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 menghasilkan laporan atribusi.
- Kasus ketika 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. Hal ini memiliki beberapa implikasi utama:
- Laporan debug hanya dibuat jika cookie pihak ketiga diizinkan di browser pengguna.
- Laporan debug tidak akan tersedia lagi setelah cookie pihak ketiga dihentikan.
Laporan debug segera dikirim
Laporan debug dikirim segera oleh browser ke asal pelaporan. Hal ini tidak seperti laporan atribusi, yang dikirim dengan penundaan.
Laporan debug keberhasilan dibuat dan dikirim segera setelah laporan atribusi yang sesuai dibuat: yaitu pada 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 asal pelaporan. Laporan debug dikirim ke tiga endpoint terpisah dari asal pelaporan:
- Endpoint untuk laporan debug berhasil, tingkat peristiwa
- Endpoint untuk laporan debug berhasil, yang 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 segera 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: Melakukan debug buku resep.
Analisis kerugian
Tidak seperti cookie pihak ketiga, Attribution Reporting API menyertakan perlindungan privasi bawaan yang dirancang untuk mencapai keseimbangan antara utilitas dan privasi. Ini berarti bahwa dengan Attribution Reporting API, Anda mungkin tidak dapat mengumpulkan semua data pengukuran yang saat ini Anda kumpulkan 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 kali pun pengguna melakukan konversi.
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 khususnya konversi yang mana dan alasannya.
Pelajari cara menjalankan analisis kerugian di Bagian 3: Men-debug buku resep.
Pemecahan masalah
Meskipun kerugian yang disebabkan oleh perlindungan resource atau privasi telah diperkirakan, kerugian lainnya mungkin tidak diinginkan. Kesalahan konfigurasi dalam implementasi atau bug di browser 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: Men-debug buku resep.
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 mengarah ke perilaku yang diinginkan dalam produksi, tanpa menunggu laporan atribusi. Pelajari cara melakukannya di Bagian 3: Melakukan debug buku resep.
Pengujian lokal dengan laporan agregat
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 menggunakan mode debug adalah Anda dapat memproses laporan lagi. Oleh karena itu, untuk memproses laporan lebih dari sekali, pastikan Anda mengaktifkan laporan debug. Anda mungkin ingin memproses ulang laporan saat Anda:
- mencoba men-debug Layanan Agregasi.
- bereksperimen dengan berbagai strategi pengelompokan.
- bereksperimen dengan berbagai nilai epsilon yang berbeda.
Pemulihan data
Sebaiknya teknologi iklan mengaktifkan mode debug untuk menerima laporan debug sehingga mereka dapat memulihkan data pelaporan. Tindakan ini berguna dalam kasus masalah Layanan Agregasi, seperti layanan yang tidak tersedia atau tidak responsif yang dapat menyebabkan pembuatan laporan ringkasan gagal.