Buku resep proses debug Pelaporan Atribusi

Bagian 3 dari 3 tentang proses debug Pelaporan Atribusi. Temukan petunjuk tentang cara menggunakan laporan debug.

Dalam cookbook ini, Anda akan menemukan petunjuk cara menggunakan laporan debug untuk berbagai kasus penggunaan yang diuraikan dalam Bagian 1: Pengantar laporan debug.

Glosarium

  • 报告来源是用于设置归因报告来源和触发器标头的来源。浏览器生成的所有报告都会发送到此源。在本指南中，我们使用 https://adtech.example 作为示例报告来源。
  • 归因报告（简称“报告”）是包含您请求的衡量数据的最终报告（事件级报告或可汇总报告）。
  • 调试报告包含有关归因报告或者来源或触发器事件的其他数据。收到调试报告并不一定表示存在问题！调试报告有两种
  • 过渡调试报告是一种调试报告，需要设置 Cookie 才能生成和发送。如果 Cookie 未设置且第三方 Cookie 被弃用，过渡调试报告将不可用。本指南中描述的所有调试报告都是过渡性调试报告。
  • 成功调试报告用于跟踪成功生成归因报告。它们与归因报告直接相关。从 Chrome 101（2022 年 4 月）开始，已提供成功调试报告。
  • 详细调试报告可以跟踪缺失的报告，并帮助您确定缺失报告的原因。它们分别用于表明浏览器未记录来源或触发器事件（这意味着浏览器不会生成归因报告）以及由于某种原因无法生成或发送归因报告的情况。详细调试报告包含一个 type 字段，用于说明未生成来源事件、触发器事件或归因报告的原因。从 Chrome 109（2023 年 1 月稳定版）开始提供详细调试报告。
  • 调试键是您可以在来源端和触发器端设置的唯一标识符。通过调试键，您可以映射基于 Cookie 的转化和基于归因的转化。将系统设置为生成调试报告并设置调试密钥后，浏览器会将这些调试密钥添加到所有归因报告和调试报告中。

如需了解我们的文档中使用的更多概念和关键术语，请参阅 Privacy Sandbox 术语表。

Cara: Memeriksa integrasi Anda secara real time

  1. Siapkan sistem Anda untuk membuat laporan debug sukses. Lihat caranya di Bagian 2: Menyiapkan laporan Debug.
  2. Setiap kali Anda men-deploy kode Pelaporan Atribusi, periksa secara real time apakah Anda menerima beberapa laporan debug sukses di endpoint. Jika demikian, penyiapan Pelaporan Atribusi Anda berfungsi.
  3. Laporan debug sukses hanya dikirim saat konversi terjadi. Sebagai gantinya, sebaiknya periksa apakah integrasi Anda disiapkan dengan benar, terlepas dari konversi—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.

Cara: 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 langsung dikirim ke endpoint Anda.

Ringkasan

Langkah-langkah untuk analisis kerugian

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 debug sukses ini, Anda akan menerima laporan atribusi nanti—dengan beberapa pengecualian. Tinjau Skenario laporan debug sukses untuk mengetahui detailnya.

Jika tidak: artinya konversi tidak terdaftar di Pelaporan Atribusi. 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 Anda pernah menerima laporan debug panjang yang sesuai pada suatu waktu (waktu sumber atau pemicu)?

  • Jika Anda tidak menerima laporan debug panjang: hal ini mungkin disebabkan oleh perilaku pengguna atau masalah integrasi. Tinjau skenario tanpa laporan debug untuk mengetahui detailnya.

  • Jika Anda menerima laporan debug panjang, lihat kolom type-nya.

    • Jika type-nya adalah source-success: ini berarti sumber berhasil didaftarkan, tetapi pemicunya tidak. Untuk mempersempit alasan laporan debug sukses tidak ada, cari laporan debug panjang yang sesuai dari jenis lainnya⏤laporan tersebut akan menunjukkan masalah di sisi pemicu.

    • Jika type-nya adalah yang lain: sumber atau pemicu belum terdaftar. type memberi tahu Anda alasannya. Laporan atribusi yang sesuai (dan laporan debug sukses) tidak akan ada. Bergantung pada type laporan debug panjang, Anda dapat menggunakan informasi ini sebagai titik data analisis kerugian (dengan kata lain, tidak ada tindakan yang perlu Anda lakukan), atau Anda dapat melaporkan bug atau memecahkan masalah implementasi. Tinjau skenario laporan debug panjang untuk mengetahui detailnya.

Kemungkinan skenario

Laporan debug sukses

Jika untuk konversi cookie tertentu, Anda menerima laporan debug berhasil, artinya konversi ini berhasil didaftarkan dengan Pelaporan Atribusi.

Anda akan 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 diganti dengan laporan lain yang memiliki prioritas lebih tinggi.
  • Kemungkinan masalah jaringan.

Laporan debug panjang dari jenis source-success

Jika untuk sumber konversi cookie tertentu, Anda menerima laporan debug panjang jenis source-success, artinya pendaftaran sumber berhasil. Bergantung pada apakah pendaftaran pemicu juga berhasil nanti, Anda mungkin akan 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 sukses, sehingga tidak ada laporan atribusi di lain waktu⏤karena laporan panjang berarti terjadi kegagalan yang dapat dilaporkan. Ada sesuatu 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 akan 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 sukses atau laporan debug panjang), artinya 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 Logs dan periksa apakah ada masalah yang muncul di sana.
  • Masalah jaringan yang terjadi pada waktu sumber atau pemicu, tetapi tidak saat laporan atribusi dikirim.

Apakah Anda menerima laporan atribusi?

Ini adalah subkasus dari 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), ini 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 laporan atribusi yang sesuai dihapus. Gunakan referensi untuk mengetahui tindakan 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 sudah diperkirakan. Batasan 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
Nilai ini dihasilkan 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 sudah diperkirakan. Batasan 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 akan muncul jika Anda menggunakan pemfilteran, penghapusan duplikat, prioritas, atau pemfilteran berbasis periode. Untuk berjaga-jaga, periksa kembali aturan kustom yang sesuai untuk mengonfirmasi bahwa laporan yang sesuai dengan laporan panjang 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 merupakan masalah implementasi. Pastikan tidak ada kesalahan konfigurasi dalam penyiapan <reporting origin, destination> Anda. Perilaku ini mungkin juga 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 mungkin 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 mungkin bukan perilaku yang Anda inginkan untuk kode Anda. Periksa kembali kode pendaftaran pemicu untuk memastikan bahwa jumlah semua kontribusi tidak melebihi anggaran kontribusi. Detail dan isi laporan

Error tidak terduga (potensi 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 guna 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 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 sukses (langsung dikirim) yang memiliki pasangan <source_debug_key, trigger_debug_key> yang sama dengan konversi berbasis cookie ini.

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

  • Laporan keberhasilan berarti atribusi telah berhasil dicatat, sehingga Anda dapat mengasumsikan 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/minggu ke depan (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 pada akhir setiap periode. Anggaplah Anda hanya menemukan 60 laporan atribusi. 10 laporan atribusi yang hilang mungkin disebabkan oleh perilaku pengguna.

Langkah 3: Penilaian kerugian singkat

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

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 laporan ini tidak ada, cari laporan proses debug panjang yang sesuai yang Anda terima pada waktu konversi (pendaftaran pemicu) atau sebelumnya pada waktu pendaftaran sumber. Gunakan kunci konversi berbasis cookie untuk memetakan konversi tersebut ke laporan debug panjang.

  • Misalkan 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 menyaring analisis kerugian. Analisis kolom type dari setiap laporan panjang. Misalnya, Anda mungkin menemukan bahwa:
    • 10 (= 10% dalam contoh kami) 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 pecahkan masalah

Setelah mengetahui alasan laporan tidak ada, Anda dapat menindaklanjuti insight ini.

Tindakan yang akan 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 merupakan tanda masalah penerapan di pihak Anda. Analisis lebih lanjut. Gunakan detail dalam isi laporan panjang untuk memecahkan masalah dan memperbaikinya jika diperlukan.
  • unknown-error mungkin merupakan tanda bug browser atau error jaringan. Jika Anda mengalaminya berulang kali, laporkan bug kepada developer browser.