Pelaporan debug Protected Audience memungkinkan developer teknologi iklan mendeklarasikan URL jarak jauh untuk menerima permintaan GET dari perangkat saat menang atau kalah lelang. Tindakan ini memungkinkan kasus penggunaan berikut:
- Menerima laporan untuk hasil lelang yang menang dan kalah.
- Memahami alasan lelang kalah. Misalnya: Pahami apakah ada masalah terkait penerapan skrip bidding atau skor, atau masalah logika inti.
- Menemukan masalah saat logika JavaScript diperbarui
Pelaporan debug tingkat peristiwa tersedia untuk diuji di Pratinjau Developer 9 Privacy Sandbox. Pelaporan debug didukung di semua perangkat tempat AdId tersedia.
Rencana jangka panjangnya adalah memungkinkan platform melaporkan hasil lelang dengan layanan Agregasi Pribadi. Hal ini memastikan bahwa pelaporan setelahnya tidak dapat digunakan untuk menggabungkan audiens kustom pengguna individu ke aplikasi penayang. Pelaporan tingkat peristiwa bersifat sementara hingga framework pelaporan yang memadai dirilis.
Pelajari pelaporan debug dalam proposal uji coba origin FLEDGE asli Chrome lebih lanjut.
Penggunaan
Pelaporan debug diterapkan menggunakan JavaScript API berikut, yang keduanya menggunakan argumen string URL:
forDebuggingOnly.reportAdAuctionWin(String url)
forDebuggingOnly.reportAdAuctionLoss(String url)
Contoh berikut melaporkan kekalahan lelang iklan dengan bid yang menang, dan variabel internal. Data ini kemudian dapat digunakan untuk tujuan proses debug.
let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);
Template ${winningBid}
diganti dengan nilai sebenarnya setelah
lelang selesai.
Secara opsional, penjual dapat menampilkan rejectReason
dari fungsi scoreAds
mereka:
function scoreAd(ad, bid, auction_config, seller_signals,
trusted_scoring_signals, contextual_signal,
custom_audience_signal) {
let score = ...
return {
'status': 0,
'score': score,
'rejectReason': 'blocked-by-publisher'
}
}
Jika penjual tidak menetapkan alasan penolakan, not-available
akan
dikirim.
Variabel URL
Variabel yang dapat ditambahkan ke URL debug sesuai dengan
variabel sejenis di Chrome (meskipun ${topLevelWinningBid}
dan
${topLevelMadeWinningBid}
tidak tersedia karena tidak ada konsep lelang
komponen di Android).
Nama variabel | Deskripsi |
winningBid |
Nilai bid pemenang. |
madeWinningBid |
Nilai boolean yang menunjukkan apakah pembeli audiens kustom ini membuat bid yang menang, baik oleh audiens kustom ini, atau audiens kustom lain dengan pembeli yang sama. |
highestScoringOtherBid |
Nilai bid yang diberi skor tertinggi kedua oleh skrip scoreAd penjual. Perhatikan bahwa ini mungkin bukan nilai bid tertinggi kedua, karena skor dan bid mungkin bersifat independen. |
madeHighestScoringOtherBid |
Nilai boolean yang mewakili apakah pembeli audiens kustom ini
membuat bid ${highestScoringOtherBid} , baik oleh audiens kustom
ini, atau audiens kustom lain dengan pembeli yang sama. |
rejectReason |
String yang secara opsional ditetapkan oleh penjual yang menjelaskan alasan mereka menolak
bid. Dapat berupa salah satu nilai berikut:
|
Batasan
- Host URL harus cocok dengan domain Privacy Sandbox Anda yang terdaftar.
- URL tidak boleh lebih dari 4.096 karakter yang mencakup domain,
https://
dan data lelang pengganti. - Dalam rilis mendatang, ping debug hanya dikirim ketika terhubung ke Wi-Fi.
Perilaku di perangkat
Dalam lingkungan seluler, melindungi penggunaan memori dan jaringan adalah prioritas utama. Dengan demikian, laporan debug dibuat dalam beberapa batch.
Properti sistem berikut mengontrol kecepatan dan ukuran batch, yang dapat disesuaikan dengan nilai yang lebih rendah untuk pengembangan:
fledge_event_level_debug_reporting_batching_rate
fledge_event_level_debug_reporting_batch_size
Latensi yang diharapkan dari laporan debug adalah antara 15-60 menit setelah lelang selesai.
Tidak ada jaminan pasti terkait kelengkapan laporan debug. Jika perangkat dimulai ulang atau proses layanan iklan mengalami error sebelum panggilan ke server dikirim, peristiwa ini akan dihapus.
Setiap teknologi iklan memiliki batas maksimum 75 URL debug terdaftar per lelang. URL yang terdaftar setelah batas tersebut tercapai akan dihapus secara otomatis.
Terakhir, jika pengguna telah menonaktifkan AdId, laporan debug akan dikirim. Hal ini tidak diterapkan di Pratinjau Developer 9, tetapi akan diterapkan di versi mendatang.
Perilaku server teknologi iklan
Server teknologi iklan harus memiliki perilaku berikut untuk pelaporan debug:
- Perangkat mengirim permintaan GET ke server yang Anda tentukan dengan API
forDebuggingOnly.*
. - Setiap permintaan mewakili satu laporan debug tingkat peristiwa: satu kemenangan lelang iklan atau kekalahan lelang.
- Setiap permintaan tidak memiliki isi. Semua data ada dalam parameter kueri.
- Payload respons yang besar dapat berdampak negatif pada performa serta penggunaan data, dan akan diabaikan.