Bagian 3 dari 3 tentang proses debug Attribution Reporting. Temukan petunjuk cara menggunakan laporan debug.
Dalam panduan ini, Anda akan menemukan petunjuk cara menggunakan laporan debug untuk berbagai kasus penggunaan yang diuraikan di Bagian 1: Pengantar laporan debug.
Glosarium
- Asal pelaporan adalah asal
yang menetapkan header sumber dan pemicu Pelaporan Atribusi.
Semua laporan yang dibuat oleh browser dikirim ke asal ini. Dalam panduan ini,
kami menggunakan
https://adtech.example
sebagai contoh asal pelaporan. - Laporan atribusi (singkatnya laporan) adalah laporan akhir (tingkat peristiwa atau agregat) yang berisi data pengukuran yang Anda minta.
- Laporan debug berisi data tambahan tentang laporan atribusi, atau tentang peristiwa sumber atau pemicu. Menerima laporan debug tidak selalu berarti ada sesuatu yang berfungsi dengan tidak benar. Ada dua jenis laporan debug
- Laporan debug transisi adalah laporan debug yang mengharuskan cookie ditetapkan agar dapat dibuat dan dikirim. Laporan debug transisi tidak akan tersedia jika cookie tidak ditetapkan dan setelah cookie pihak ketiga tidak digunakan lagi. Semua laporan debug yang dijelaskan dalam panduan ini adalah laporan debug transisi.
- Laporan debug keberhasilan melacak pembuatan laporan atribusi yang berhasil. Keduanya berkaitan langsung dengan laporan atribusi. Laporan debug sukses telah tersedia sejak Chrome 101 (April 2022).
- Laporan debug panjang dapat melacak laporan yang tidak ada dan membantu Anda menentukan alasan
laporan tidak ada. Eksperimen menunjukkan kasus saat browser tidak mencatat peristiwa sumber
atau pemicu, (yang berarti browser tidak akan membuat laporan atribusi), dan
kasus saat laporan atribusi tidak dapat dibuat atau dikirim karena alasan tertentu.
Laporan debug panjang menyertakan kolom
type
yang menjelaskan alasan peristiwa sumber, peristiwa pemicu, atau laporan atribusi tidak dibuat. Laporan debug panjang tersedia mulai Chrome 109 (Stabil pada Januari 2023). - Kunci debug adalah ID unik yang dapat Anda tetapkan di sisi sumber dan sisi pemicu. Kunci debug memungkinkan Anda memetakan konversi berbasis cookie dan konversi berbasis atribusi. Jika Anda telah menyiapkan sistem untuk menghasilkan laporan debug dan menetapkan kunci debug, browser akan menyertakan kunci debug ini dalam semua laporan atribusi dan laporan debug.
Untuk konsep lainnya dan istilah utama yang digunakan di seluruh dokumentasi kami, lihat glosarium Privacy Sandbox.
Petunjuk: Memeriksa integrasi secara real time
- Siapkan sistem Anda untuk membuat laporan debug sukses. Lihat caranya di Bagian 2: Menyiapkan laporan Debug.
- Setiap kali Anda men-deploy kode Attribution Reporting, periksa secara real time apakah Anda menerima beberapa laporan debug keberhasilan di endpoint. Jika ya, penyiapan Pelaporan Atribusi sudah berfungsi.
- Laporan debug berhasil hanya dikirim saat konversi terjadi. Sebagai gantinya, sebaiknya periksa apakah integrasi Anda sudah disiapkan dengan benar, terlepas dari konversinya—yaitu, Anda ingin memeriksa apakah sumber berhasil didaftarkan. Untuk mencapai hal ini, Anda dapat mengandalkan laporan debug panjang keberhasilan pendaftaran sumber. Lihat cara menyiapkannya di Bagian 2: Menyiapkan laporan Debug.
Petunjuk: Menganalisis kerugian dan memecahkan masalah integrasi
Untuk membandingkan hasil pengukuran konversi berbasis cookie dengan laporan Pelaporan Atribusi, gunakan kunci debug dan petakan konversi cookie dengan laporan debug. Ingat bahwa laporan debug dikirim segera ke endpoint Anda.
Ringkasan
Gunakan kunci debug (pasangan <source_debug_key, trigger_debug_key>
) untuk memetakan konversi cookie agar laporan debug berhasil.
Untuk setiap konversi cookie, pada waktu konversi, apakah Anda menerima laporan debug keberhasilan yang sesuai?
Jika ya: untuk semua laporan debug keberhasilan ini, Anda akan menerima laporan atribusi nanti—dengan beberapa pengecualian. Tinjau Skenario laporan debug berhasil untuk mengetahui detailnya.
Jika tidak: artinya konversi tidak terdaftar di Attribution Reporting. Gunakan pasangan <source_debug_key, trigger_debug_key>
(atau kunci debug sumber jika kunci debug pemicu tidak ada) untuk memetakan konversi cookie ke laporan debug panjang. Untuk setiap konversi ini, apakah pada waktu tertentu (waktu sumber atau pemicu) menerima laporan debug panjang yang sesuai?
Jika Anda tidak menerima laporan debug panjang: hal ini mungkin karena perilaku pengguna atau masalah integrasi. Tinjau skenario tidak ada laporan debug untuk mengetahui detailnya.
Jika Anda menerima laporan debug panjang, lihat kolom
type
.Jika
type
-nya adalahsource-success
: ini berarti sumber berhasil didaftarkan, tetapi pemicunya tidak berhasil. Untuk mempersempit alasan tidak adanya laporan debug keberhasilan, cari laporan debug panjang yang sesuai dari jenis lain⏤Laporan tersebut akan menunjukkan masalah di sisi pemicu.Jika
type
-nya adalah hal lain: sumber atau pemicu belum didaftarkan.type
menjelaskan alasannya. Laporan atribusi yang terkait (dan laporan debug keberhasilan) akan hilang. Bergantung padatype
dalam laporan debug panjang, Anda mungkin hanya ingin mengambil informasi ini sebagai titik data analisis kerugian (dengan kata lain, tidak ada tindakan untuk Anda), atau Anda mungkin ingin melaporkan bug atau memecahkan masalah penerapan. Tinjau skenario laporan debug panjang untuk mengetahui detailnya.
Kemungkinan skenario
Laporan debug berhasil
Jika Anda menerima laporan debug berhasil untuk konversi cookie tertentu, artinya konversi ini berhasil didaftarkan ke Attribution Reporting.
Anda akan menerima laporan atribusi nanti untuk konversi ini⏤dengan beberapa pengecualian:
- Perilaku pengguna: menghapus data setelah konversi dan sebelum laporan atribusi dikirim, menutup browser, dll. Jika pengguna menutup browser setelah melakukan konversi dan tidak membuka browsernya selama satu minggu, laporan tidak akan dikirim selama seminggu atau lebih. Anda dapat menganggap keterlambatan ini sebagai kerugian.
- Hanya berlaku untuk Tingkat Peristiwa: Laporan tingkat peristiwa digantikan dengan laporan lain dengan prioritas lebih tinggi.
- Kemungkinan masalah jaringan.
Laporan debug panjang jenis source-success
Jika Anda menerima laporan debug panjang dari jenis source-success
untuk sumber konversi cookie tertentu, artinya pendaftaran sumber berhasil. Bergantung pada apakah pendaftaran pemicu juga nantinya berhasil, Anda mungkin menerima atau tidak menerima laporan untuk konversi tersebut.
Ada satu peringatan untuk hal ini:
Laporan debug panjang dari jenis lainnya
Jika untuk konversi cookie tertentu, Anda menerima laporan debug panjang dari jenis lain, Anda tidak akan menerima laporan debug keberhasilan, sehingga nantinya tidak akan ada laporan atribusi⏤karena laporan panjang berarti telah terjadi kegagalan yang dapat dilaporkan. Sesuatu mencegah pendaftaran sumber, pendaftaran pemicu, pembuatan laporan, atau pengiriman laporan. Penyebab yang mungkin:
- Batas privasi
- Batas penyimpanan
- Aturan khusus
- Masalah penerapan dalam kode Anda
- Bug browser
Beberapa di antaranya wajar. Tindakan yang harus diambil bergantung pada type
setiap laporan panjang. Tinjau referensi laporan panjang.
Tidak ada laporan debug
Jika untuk konversi cookie tertentu, Anda hanya menerima laporan atribusi (tidak ada laporan debug keberhasilan atau laporan debug panjang), ini berarti ada sesuatu yang mencegah pembuatan laporan debug. Penyebab yang mungkin:
- Preferensi pengguna (pengguna telah menonaktifkan cookie pihak ketiga)
- Cookie tidak ada, atau kunci debug tidak ada (kunci debug dihapus karena cookie tidak ada). Di
chrome://attribution-internals
, buka tab Logs dan periksa apakah ada masalah yang muncul di sana. - Masalah jaringan yang terjadi pada waktu sumber atau pemicu, tetapi tidak terjadi saat laporan atribusi dikirim.
Apakah Anda menerima laporan atribusi?
Ini adalah subkasus tidak menerima laporan debug: jika untuk konversi cookie tertentu, Anda tidak menerima laporan apa pun (tidak ada laporan debug dalam bentuk apa pun, tidak ada laporan atribusi), hal ini berarti terjadi kegagalan yang tidak dapat dilaporkan. Penyebab yang mungkin:
- Masalah integrasi dasar. Tinjau cara memecahkan masalah tersebut di Memperbaiki masalah integrasi dasar.
- Kemungkinan masalah jaringan.
- Preferensi pengguna di setelan browser seperti Privacy Sandbox dinonaktifkan.
Referensi laporan debug panjang
Setiap laporan debug panjang memiliki kolom type
yang mencatat alasan penghapusan laporan atribusi yang terkait. Gunakan referensi untuk mencari tahu tindakan apa yang harus diambil untuk setiap type
laporan panjang.
Pendaftaran sumber berhasil
Sumber berhasil didaftarkan.
source-success
- Detail dan isi laporan
Laporan batasan privasi
Laporan ini diharapkan. Kebijakan tersebut menunjukkan batasan privasi untuk mengurangi kebocoran identitas pengguna lintas situs.
source-destination-limit
- Detail dan isi laporan
source-noised
- Detail dan isi laporan
trigger-attributions-per-source-destination-limit
- Detail dan isi laporan
trigger-reporting-origin-limit
- Detail dan isi laporan
trigger-event-noise
- Detail dan isi laporan
trigger-event-excessive-reports
- Ini dibuat jika jumlah laporan melebihi batas; Anda dapat mendaftarkan maksimal satu konversi untuk penayangan, dan tiga untuk klik. Perhatikan bahwa Anda dapat mengonfigurasi laporan yang akan diterima dengan menetapkan prioritas. Detail dan isi laporan
Laporan batasan penyimpanan
Laporan ini diharapkan. Batas penyimpanan menunjukkan batas penyimpanan untuk mencegah penggunaan resource yang berlebihan.
source-storage-limit
- Detail dan isi laporan
trigger-event-storage-limit
- Detail dan isi laporan
trigger-aggregate-storage-limit
- Detail dan isi laporan
Laporan aturan kustom
Laporan ini diharapkan jika Anda menggunakan pemfilteran, penghapusan duplikat, prioritas, atau pemfilteran berbasis jendela. Untuk berjaga-jaga, periksa kembali aturan khusus yang sesuai untuk mengonfirmasi bahwa laporan yang sesuai dengan laporan panjang tersebut memang merupakan laporan yang ingin Anda hapus. Jika ini benar, tidak ada tindakan yang perlu Anda lakukan.
trigger-no-matching-filter-data
- Detail dan isi laporan
trigger-event-no-matching-configuration
- Detail dan isi laporan
trigger-event-deduplicated
- Detail dan isi laporan
trigger-aggregate-deduplicated
- Detail dan isi laporan
trigger-event-low-priority
- Detail dan isi laporan
trigger-event-report-window-passed
- Detail dan isi laporan
trigger-aggregate-report-window-passed
- Detail dan isi laporan
Laporan panjang lainnya
Laporan ini dapat menunjukkan potensi masalah penerapan dalam kode Anda.
trigger-no-matching-source
- Ini mungkin adalah masalah penerapan. Pastikan tidak ada kesalahan konfigurasi dalam penyiapan
<reporting origin, destination>
Anda. Ini mungkin juga perilaku API yang diharapkan. Misalnya, pengguna telah menghapus data pada waktu tertentu setelah berinteraksi dengan iklan dan sebelum melakukan konversi, atau pengguna melakukan konversi tanpa pernah melihat iklan yang terkait. Detail dan isi laporan trigger-aggregate-no-contributions
- Perilaku ini mungkin bukan perilaku yang Anda inginkan untuk kode Anda. Pecahkan masalah kode pendaftaran pemicu Anda; pastikan konfigurasi kontribusi Anda sudah benar. Detail dan isi laporan
trigger-aggregate-insufficient-budget
- Perilaku ini mungkin bukan perilaku yang Anda inginkan untuk kode Anda. Periksa kembali kode pendaftaran pemicu untuk memastikan jumlah semua kontribusi tidak melebihi anggaran kontribusi. Detail dan isi laporan
Error tak terduga (kemungkinan bug browser)
Laporan ini tidak diharapkan. Hal itu dapat disebabkan oleh bug browser. Laporkan bug dan sebutkan dalam deskripsi Anda langkah-langkah untuk mereproduksinya.
source-unknown-error
- Detail dan isi laporan
trigger-unknown-error
- Detail dan isi laporan
Contoh analisis kerugian
Langkah 1: Menyiapkan dan melakukan pemetaan dengan cookie
Ikuti petunjuk di Bagian 2: Menyiapkan laporan debug untuk menyiapkan sistem agar dapat membuat laporan debug sukses dan laporan debug panjang.
Dengan demikian, Anda dapat menggunakan informasi konversi berbasis cookie untuk mencari laporan debug atau laporan atribusi yang sesuai.
Langkah 2: Identifikasi pendaftaran yang berhasil dan laporan yang hilang
Dalam contoh ini, anggaplah Anda telah melacak 100 konversi dengan sistem berbasis cookie.
Setiap kali Anda mencatat konversi berbasis cookie, cari laporan debug keberhasilan (langsung dikirim) yang memiliki pasangan <source_debug_key, trigger_debug_key>
yang sama dengan konversi berbasis cookie ini.
Anggaplah Anda telah menerima laporan debug berhasil untuk 70 konversi cookie ini.
- Laporan keberhasilan berarti atribusi telah berhasil dicatat, sehingga Anda dapat dengan aman berasumsi bahwa Anda akan mendapatkan laporan atribusi yang sesuai dengan setiap laporan keberhasilan—dengan beberapa pengecualian.
- Anda dapat memutuskan untuk memantau pengecualian ini. Untuk melakukannya, karena laporan atribusi dikirim ke endpoint Anda selama beberapa hari/minggu berikutnya (bergantung pada masa berlakunya), cari laporan atribusi yang memiliki pasangan kunci debug yang sama dengan setiap laporan debug yang berhasil. Pastikan untuk menunggu sebentar: laporan mungkin tidak langsung dikirim di akhir setiap jendela. Anggaplah Anda hanya menemukan 60 laporan atribusi. Sepuluh laporan atribusi yang tidak ada mungkin disebabkan oleh perilaku pengguna.
Langkah 3: Penilaian kerugian singkat
100–70 = 30 laporan debug keberhasilan tidak ada. Artinya, 30 konversi ini (yang dilacak dalam penerapan berbasis cookie) tidak dicatat dengan Attribution Reporting. Anda tidak akan menerima laporan atribusi untuk kata kunci tersebut.
Karena Anda memiliki 100 konversi berbasis cookie dan hanya 70 konversi berbasis atribusi, kerugian Anda adalah 30%. Sekarang Anda memiliki penilaian kerugian singkat.
Langkah 4: Menganalisis penyebab
Untuk menyelidiki penyebab tidak adanya laporan ini, cari laporan debug panjang yang sesuai yang Anda terima pada waktu konversi (pendaftaran pemicu) atau lebih awal pada saat pendaftaran sumber. Gunakan kunci konversi berbasis cookie untuk memetakannya ke laporan debug panjang.
- Anggaplah ada 10 kunci yang tidak memiliki laporan debug panjang. Periksa apakah ada masalah integrasi. Jika tidak, hal ini mungkin disebabkan oleh perilaku pengguna.
- Anda memiliki 20 laporan debug panjang. Sekarang Anda dapat mempertajam analisis kerugian. Analisis kolom
type
di setiap laporan panjang. Misalnya, Anda mungkin menemukan bahwa:- 10 laporan (= 10% dalam contoh kita) hilang karena
pending destination limit
- 5 laporan (= 5%) tidak ada karena
trigger-aggregate-no-contributions
. - 5 laporan (= 5%) tidak ada karena
unknown-error
.
- 10 laporan (= 10% dalam contoh kita) hilang karena
Langkah 5: Ambil tindakan dan pecahkan masalah
Setelah Anda memperoleh visibilitas tentang alasan mengapa laporan tidak ada, Anda dapat menindaklanjutinya.
Tindakan yang harus diambil bergantung pada type
setiap laporan panjang. Tinjau referensi laporan panjang untuk mengetahui detailnya. Contoh:
pending-destination-limit
adalah perlindungan privasi. Tidak ada tindakan yang perlu dilakukan. Gunakan angka ini sebagai titik data, untuk visibilitas dan pemantauan Anda sendiri.trigger-aggregate-no-contributions
mungkin tanda dari masalah penerapan di pihak Anda. Analisis lebih lanjut. Gunakan detail dalam isi laporan panjang untuk memecahkan masalah dan memperbaikinya jika diperlukan.unknown-error
mungkin tanda dari bug browser atau error jaringan. Jika Anda mengalami masalah ini berulang kali, laporkan bug untuk developer browser.