Halaman ini diterjemahkan oleh Cloud Translation API.

Buku resep proses debug Pelaporan Atribusi

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 origin yang [menetapkan header sumber dan pemicu Attribution Reporting. 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 gabungan) yang berisi data pengukuran yang Anda minta.
Laporan debug berisi data tambahan tentang laporan atribusi, atau tentang sumber atau peristiwa pemicu. Menerima laporan debug bukan berarti ada 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. Model atribusi 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 penyebab tidak adanya laporan tersebut. Kejadian ini menunjukkan kasus saat browser tidak mencatat peristiwa sumber atau pemicu (yang berarti browser tidak akan menghasilkan 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 sudah menyiapkan sistem untuk menghasilkan laporan debug dan menetapkan kunci debug, browser akan menyertakan kunci debug ini di semua laporan atribusi dan laporan debug.

Untuk mengetahui konsep dan istilah utama lainnya 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 adalah source-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 pada type 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.

Catatan: Jika laporan panjang type dimulai dengan trigger-event, laporan hanya dapat dibuat untuk peristiwa sumber atau pemicu yang terkait dengan laporan tingkat peristiwa. Jika laporan panjang type diawali dengan trigger-aggregate, laporan hanya dapat dibuat untuk peristiwa sumber atau pemicu yang terkait dengan laporan agregat. Dalam kasus lain, hal ini berlaku untuk laporan tingkat peristiwa atau laporan gabungan.

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.

Catatan: Anda mungkin memiliki laporan atribusi tingkat peristiwa yang tidak memetakan ke konversi berbasis cookie. Kemungkinan besar ini adalah laporan derau yang dihasilkan secara acak oleh API. Anda dapat mengonfirmasi hal ini dengan mencari laporan panjang debug jenis source-noised yang memiliki kunci debug sumber yang sama dengan laporan tingkat peristiwa.

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.

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.