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 baik, memahami kesenjangan dalam hasil pengukuran antara penerapan berbasis cookie dan penerapan Pelaporan Atribusi, dan pecahkan 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. Mereka berhubungan langsung ke laporan atribusi.
Laporan debug keberhasilan telah tersedia sejak Chrome 101 (April 2022).
Laporan debug panjang
Laporan debug panjang memberi Anda visibilitas yang lebih besar 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 pihak ketiga cookie. 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. Ini tidak seperti laporan atribusi, yang dikirim dengan tertunda.
Laporan debug keberhasilan dibuat dan dikirim segera setelah laporan atribusi yang sesuai dibuat, yaitu, berdasarkan pemicu pendaftaran.
Laporan debug panjang dikirim segera setelah sumber atau pemicu pendaftaran.
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 privasi bawaan perlindungan 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 pelacakan dengan cookie pihak ketiga akan menghasilkan laporan atribusi.
Satu contoh: untuk laporan tingkat peristiwa, Anda dapat mendaftarkan maksimal satu konversi per tayangan iklan. 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 Atribusi Reporting API. Tentukan dengan tepat konversi mana yang dilaporkan, berapa banyak konversi tidak dilaporkan, dan khususnya yang mana dan mengapa.
Pelajari cara menjalankan analisis kerugian di Bagian 3: Men-debug buku resep.
Pemecahan masalah
Meskipun kerugian yang disebabkan oleh perlindungan resource atau privasi sudah diperkirakan, kerugian lainnya mungkin tidak diinginkan. Kesalahan konfigurasi dalam implementasi atau {i>bug<i} di browser itu sendiri dapat menyebabkan laporan menghilang.
Anda dapat menggunakan laporan debug untuk mendeteksi dan memperbaiki masalah penerapan di pihak Anda, atau untuk melaporkan potensi {i>bug<i} kepada tim {i>browser<i}. Pelajari cara melakukannya di Bagian 3: Proses debug buku resep.
Pemeriksaan konfigurasi lanjutan
Beberapa fitur Attribution Reporting API memungkinkan Anda menyesuaikan perilaku model. Aturan pemfilteran, aturan penghapusan duplikat, dan aturan prioritas adalah beberapa contohnya.
Saat menggunakan fitur ini, gunakan laporan debug untuk memeriksa apakah logika Anda mengarah pada 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 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 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.