Pelaporan debug untuk Protected Audience

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:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

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.