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 memastikan bahwa integrasi Anda berfungsi dengan baik, memahami kesenjangan 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. Gunakan keduanya, karena keduanya memenuhi kasus penggunaan yang berbeda.
Laporan debug berhasil
Laporan debug keberhasilan melacak pembuatan laporan atribusi yang berhasil. Model tersebut berhubungan langsung dengan laporan atribusi.
Laporan debug berhasil 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 sumbernya berhasil didaftarkan, atau melacak laporan yang tidak ada 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 mencakup 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 pendaftaran sumber keberhasilan pendaftaran 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 perlu menetapkan cookie.
Jika asal 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 lagi tersedia setelah cookie pihak ketiga dihapus.
Laporan debug segera dikirim
Laporan debug dikirim langsung oleh browser ke asal pelaporan. Hal ini tidak seperti laporan atribusi, yang dikirim dengan penundaan.
Laporan debug berhasil dibuat dan dikirim segera setelah laporan atribusi yang sesuai dibuat: yaitu pada pendaftaran pemicu.
Laporan debug panjang dikirim langsung 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 dapat digabungkan
- Endpoint untuk laporan debug panjang, tingkat peristiwa, dan gabungan.
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 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 proses debug.
Analisis kerugian
Tidak seperti cookie pihak ketiga, Attribution Reporting API menyertakan perlindungan privasi bawaan, yang dirancang untuk mencapai keseimbangan antara utilitas dan privasi. Artinya, 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 yang dilaporkan, jumlah konversi yang tidak dilaporkan, dan khususnya 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 telah diperkirakan, kerugian lain mungkin tidak diinginkan. Kesalahan konfigurasi pada penerapan atau bug di browser dapat menyebabkan hilangnya laporan.
Anda dapat menggunakan laporan debug untuk mendeteksi dan memperbaiki masalah implementasi di pihak Anda, atau untuk melaporkan potensi bug kepada tim browser. Pelajari cara melakukannya di Bagian 3: Buku resep 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 mengarah ke perilaku yang diinginkan dalam produksi, tanpa menunggu laporan atribusi. Pelajari cara melakukannya di Bagian 3: Buku resep proses debug.
Pengujian lokal dengan laporan agregat
Tidak seperti laporan atribusi gabungan yang dienkripsi, laporan debug agregat menyertakan payload yang tidak terenkripsi.
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 untuk mengaktifkan laporan debug. Anda mungkin ingin memproses ulang laporan saat:
- mencoba men-debug Layanan Agregasi.
- bereksperimen dengan berbagai strategi pengelompokan.
- bereksperimen dengan nilai epsilon yang berbeda.
Pemulihan data
Sebaiknya teknologi iklan mengaktifkan mode debug untuk menerima laporan debug sehingga mereka dapat memulihkan data pelaporannya. Hal ini berguna dalam kasus masalah Layanan Agregasi seperti layanan yang tidak tersedia atau tidak responsif yang dapat menyebabkan kegagalan pembuatan laporan ringkasan.