Beberapa teknologi Privacy Sandbox akan dihentikan secara bertahap.

Lihat Update tentang Rencana untuk Teknologi Privacy Sandbox kami.

Status fitur Privacy Sandbox memberikan informasi selengkapnya tentang status setiap API dan fitur platform.

Halaman ini diterjemahkan oleh Cloud Translation API.

Buku resep proses debug Pelaporan Atribusi

Bagian 3 dari 3 tentang proses debug Attribution Reporting. Temukan petunjuk tentang cara menggunakan laporan debug.

Dalam panduan ini, Anda akan menemukan petunjuk tentang cara menggunakan laporan debug untuk berbagai kasus penggunaan yang diuraikan dalam 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.

Cara: Memeriksa integrasi secara real time

Siapkan sistem Anda untuk membuat laporan debug keberhasilan. 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 Anda. Jika ya, penyiapan Attribution Reporting Anda berfungsi.
Laporan debug keberhasilan hanya dikirim saat konversi terjadi. Sebagai gantinya, Anda sebaiknya memeriksa apakah integrasi Anda disiapkan dengan benar terlepas dari konversi—yaitu, Anda ingin memeriksa apakah sumber berhasil didaftarkan. Untuk mencapainya, Anda dapat mengandalkan keberhasilan pendaftaran sumber laporan debug panjang. Lihat cara menyiapkannya di Bagian 2: Menyiapkan laporan Debug.

Cara: Menganalisis kerugian dan memecahkan masalah integrasi

Untuk membandingkan hasil pengukuran konversi berbasis cookie dengan laporan Attribution Reporting, gunakan kunci debug dan petakan konversi cookie dengan laporan debug. Ingatlah bahwa laporan debug dikirim segera ke endpoint Anda.

Ringkasan

Gunakan kunci debug (pasangan <source_debug_key, trigger_debug_key>) untuk memetakan konversi cookie ke laporan debug keberhasilan. Untuk setiap konversi cookie, pada waktu konversi, apakah Anda menerima laporan debug keberhasilan yang sesuai?

Jika ya: untuk semua laporan proses debug keberhasilan ini, Anda dapat mengharapkan untuk menerima laporan atribusi nanti—dengan beberapa pengecualian. Tinjau Skenario laporan debug keberhasilan untuk mengetahui detailnya.

Jika tidak: berarti 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 verbose. Untuk setiap konversi ini, apakah Anda pernah (waktu sumber atau pemicu) menerima laporan debug panjang yang sesuai?

Jika Anda tidak menerima laporan debug verbose: hal ini mungkin disebabkan oleh perilaku pengguna atau masalah integrasi. Tinjau skenario laporan tanpa proses debug untuk mengetahui detailnya.
Jika Anda menerima laporan debug verbose, lihat kolom type-nya.
- Jika type-nya adalah source-success: berarti sumber berhasil didaftarkan, tetapi pemicunya tidak. Untuk mempersempit alasan mengapa laporan debug keberhasilan tidak ada, cari laporan debug panjang yang sesuai dari jenis lain⏤laporan tersebut akan menunjukkan masalah di sisi pemicu.
- Jika type-nya adalah yang lain: sumber atau pemicu belum didaftarkan. type memberi tahu Anda alasannya. Laporan atribusi yang sesuai (dan laporan debug keberhasilan) tidak akan ada. Bergantung pada type laporan debug verbose, Anda mungkin hanya ingin menggunakan 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 Anda. Tinjau skenario laporan debug verbose untuk mengetahui detailnya.

Kemungkinan skenario

Laporan debug keberhasilan

Jika untuk konversi cookie tertentu, Anda menerima laporan debug yang berhasil, berarti konversi ini berhasil didaftarkan dengan Attribution Reporting.

Anda dapat mengharapkan untuk menerima laporan atribusi untuk konversi ini nanti⏤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 browser selama seminggu, laporan tidak akan dikirim selama seminggu atau lebih. Anda mungkin menganggap keterlambatan ini sebagai kerugian.
Hanya Berlaku untuk Tingkat Peristiwa: Laporan tingkat peristiwa digantikan oleh laporan lain dengan prioritas yang lebih tinggi.
Kemungkinan masalah jaringan.

Laporan debug panjang jenis `source-success`

Jika untuk sumber konversi cookie tertentu, Anda menerima laporan debug panjang berjenis source-success, berarti pendaftaran sumber berhasil. Bergantung pada apakah pendaftaran pemicu juga berhasil nanti, 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, dan oleh karena itu tidak ada laporan atribusi di kemudian hari⏤karena laporan panjang berarti kegagalan yang dapat dilaporkan terjadi. Terjadi masalah yang mencegah pendaftaran sumber, pendaftaran pemicu, pembuatan laporan, atau pengiriman laporan. Kemungkinan penyebab:

Batasan privasi
Batas penyimpanan
Aturan khusus
Masalah penerapan dalam kode Anda
Bug browser

Beberapa di antaranya sudah diperkirakan. Tindakan yang harus diambil bergantung pada type setiap laporan verbose. Tinjau referensi laporan verbose.

Tidak ada laporan debug

Jika untuk konversi cookie tertentu, Anda hanya menerima laporan atribusi (tidak ada laporan debug keberhasilan maupun laporan debug panjang), berarti ada sesuatu yang mencegah laporan debug dibuat. Kemungkinan penyebab:

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 Log 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 apa pun, tidak ada laporan atribusi), berarti terjadi kegagalan yang tidak dapat dilaporkan. Kemungkinan penyebab:

Masalah integrasi mendasar. Tinjau cara memecahkan masalah ini di Memperbaiki masalah integrasi mendasar.
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 mengapa laporan atribusi yang sesuai dihilangkan. Gunakan referensi untuk mengetahui tindakan yang harus dilakukan untuk setiap type laporan verbose.

Catatan: Jika type laporan verbose dimulai dengan trigger-event, laporan tersebut hanya dapat dibuat untuk peristiwa sumber atau pemicu yang terkait dengan laporan tingkat peristiwa. Jika type laporan panjang dimulai dengan trigger-aggregate, laporan tersebut hanya dapat dibuat untuk peristiwa sumber atau pemicu yang terkait dengan laporan gabungan. Dalam kasus lain, laporan tersebut adalah laporan tingkat peristiwa atau laporan gabungan.

Pendaftaran sumber berhasil

Sumber berhasil didaftarkan.

source-success: Detail dan isi laporan

Laporan batasan privasi

Laporan ini sudah diperkirakan. Hal ini 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 dihasilkan jika jumlah laporan melebihi batas; Anda dapat mendaftarkan paling banyak 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 sudah diperkirakan. Hal ini menunjukkan batasan 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 kustom yang sesuai untuk mengonfirmasi bahwa laporan yang sesuai dengan laporan verbose tersebut memang laporan yang ingin Anda hapus. Jika ini benar, Anda tidak perlu melakukan tindakan apa pun.

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 masalah implementasi. Pastikan tidak ada kesalahan konfigurasi dalam penyiapan <reporting origin, destination>. Ini juga mungkin merupakan perilaku API yang diharapkan. Misalnya, pengguna telah menghapus data pada suatu waktu setelah berinteraksi dengan iklan dan sebelum melakukan konversi, atau pengguna melakukan konversi tanpa pernah melihat iklan terkait. Detail dan isi laporan
trigger-aggregate-no-contributions: Ini kemungkinan bukan perilaku yang Anda inginkan untuk kode Anda. Pecahkan masalah kode pendaftaran pemicu; pastikan konfigurasi kontribusi Anda sudah benar. Detail dan isi laporan
trigger-aggregate-insufficient-budget: Ini kemungkinan bukan perilaku yang Anda inginkan untuk kode Anda. Periksa kembali kode pendaftaran pemicu Anda untuk memastikan bahwa jumlah semua kontribusi tidak melebihi anggaran kontribusi. Detail dan isi laporan

Error tak terduga (kemungkinan bug browser)

Laporan ini tidak terduga. Hal ini mungkin disebabkan oleh bug browser. Laporkan bug dan tentukan langkah-langkah untuk mereproduksinya dalam deskripsi Anda.

source-unknown-error: Detail dan isi laporan
trigger-unknown-error: Detail dan isi laporan

Contoh analisis kerugian

Langkah 1: Penyiapan dan pemetaan dengan cookie

Ikuti petunjuk di Bagian 2: Menyiapkan laporan debug untuk menyiapkan sistem Anda agar membuat laporan debug keberhasilan 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 tidak ada

Dalam contoh ini, asumsikan Anda telah melacak 100 konversi dengan sistem berbasis cookie.

Setiap kali Anda mencatat konversi berbasis cookie, cari laporan debug keberhasilan (dikirim segera) yang memiliki pasangan <source_debug_key, trigger_debug_key> yang sama dengan konversi berbasis cookie ini.

Misalkan Anda telah menerima laporan debug keberhasilan untuk 70 konversi cookie ini.

Laporan keberhasilan berarti atribusi telah berhasil dicatat, sehingga Anda dapat mengasumsikan dengan aman bahwa Anda akan mendapatkan laporan atribusi yang sesuai dengan setiap laporan keberhasilan—dengan beberapa pengecualian.
Anda dapat memutuskan untuk memantau pengecualian ini. Untuk melakukannya, saat laporan atribusi dikirim ke endpoint Anda selama beberapa hari atau minggu berikutnya (bergantung pada masa berlaku), cari laporan atribusi yang memiliki pasangan kunci debug yang sama dengan setiap laporan debug keberhasilan. Pastikan untuk menunggu sebentar: laporan mungkin tidak dikirimkan segera di akhir setiap periode. Anggap saja Anda hanya menemukan 60 laporan atribusi. 10 laporan atribusi yang tidak ada mungkin disebabkan oleh perilaku pengguna.

Catatan: Anda mungkin memiliki laporan atribusi tingkat peristiwa yang tidak dipetakan ke konversi berbasis cookie. Kemungkinan besar ini adalah laporan tidak valid yang dibuat 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 Anda.

Langkah 3: Penilaian kerugian singkat

100-70 = 30 laporan proses debug keberhasilan tidak ada. Artinya, 30 konversi ini (yang dilacak dalam penerapan berbasis cookie) tidak dicatat dengan Pelaporan Atribusi. Anda tidak akan menerima laporan atribusi untuk ini.

Karena Anda memiliki 100 konversi berbasis cookie dan hanya 70 konversi berbasis atribusi, kehilangan Anda adalah 30%. Sekarang Anda memiliki penilaian kerugian singkat.

Langkah 4: Menganalisis penyebab

Untuk menyelidiki alasan laporan ini tidak ada, cari laporan debug verbose terkait yang telah Anda terima pada saat konversi (pendaftaran pemicu) atau sebelumnya pada saat pendaftaran sumber. Gunakan kunci konversi berbasis cookie untuk memetakannya ke laporan debug verbose.

Misalkan ada 10 kunci yang tidak memiliki laporan debug verbose. Periksa apakah ada masalah integrasi. Jika tidak, hal ini mungkin disebabkan oleh perilaku pengguna.
Anda memiliki 20 laporan debug panjang. Sekarang Anda dapat menyaring analisis kerugian. Analisis kolom type dari setiap laporan panjang. Misalnya, Anda mungkin menemukan bahwa:
- 10 (= 10% dalam contoh kita) laporan tidak ada karena pending destination limit
- 5 (= 5%) laporan tidak ada karena trigger-aggregate-no-contributions.
- 5 (= 5%) laporan tidak ada karena unknown-error.

Langkah 5: Ambil tindakan dan lakukan pemecahan masalah

Setelah Anda mengetahui alasan laporan tidak ada, Anda dapat mengambil tindakan berdasarkan insight ini.

Tindakan yang harus diambil bergantung pada type setiap laporan verbose. Tinjau referensi laporan verbose untuk mengetahui detailnya. Contoh:

pending-destination-limit adalah perlindungan privasi. Tidak ada tindakan yang perlu dilakukan. Gunakan nomor ini sebagai titik data, untuk visibilitas dan pemantauan Anda sendiri.
trigger-aggregate-no-contributions mungkin merupakan tanda masalah penerapan di pihak Anda. Analisis lebih lanjut. Gunakan detail dalam isi laporan verbose untuk memecahkan masalah dan memperbaikinya jika diperlukan.
unknown-error mungkin merupakan tanda adanya bug browser atau error jaringan. Jika Anda berulang kali mengalami masalah ini, laporkan bug kepada developer browser.