แก้ไขข้อบกพร่องในการรายงานสำหรับ Protected Audience

การรายงานข้อบกพร่องของ Protected Audience ช่วยให้นักพัฒนาเทคโนโลยีโฆษณาสามารถประกาศ URL ระยะไกลเพื่อรับคำขอ GET จากอุปกรณ์เมื่อชนะหรือแพ้การประมูล ซึ่งจะ เปิดใช้กรณีการใช้งานต่อไปนี้

• รับรายงานผลการประมูลที่ชนะและแพ้
• ทำความเข้าใจสาเหตุที่แพ้การประมูล เช่น ทำความเข้าใจว่าปัญหาเกิดจาก การติดตั้งใช้งานสคริปต์การเสนอราคาหรือการให้คะแนน หรือเป็นปัญหาเกี่ยวกับตรรกะหลัก
• ค้นพบปัญหาเมื่อมีการอัปเดตตรรกะ JavaScript

การรายงานข้อบกพร่องระดับเหตุการณ์พร้อมให้ทดสอบใน Privacy Sandbox Developer Preview 9 แล้ว การรายงานข้อบกพร่องรองรับในอุปกรณ์ทั้งหมดที่ AdId พร้อมใช้งาน

แผนระยะยาวคือการเปิดใช้แพลตฟอร์มเพื่อรายงานผลการประมูลด้วย บริการรวมข้อมูลแบบส่วนตัว ซึ่งจะช่วยให้มั่นใจได้ว่าการรายงานย้อนหลัง จะใช้เพื่อรวมกลุ่มเป้าหมายที่กำหนดเองของผู้ใช้แต่ละรายกับแอปของผู้เผยแพร่โฆษณาไม่ได้ การรายงานระดับเหตุการณ์เป็นแบบชั่วคราว จนกว่าจะมีการเผยแพร่เฟรมเวิร์กการรายงานที่เหมาะสม

ดูข้อมูลเพิ่มเติมเกี่ยวกับ[การรายงานการแก้ไขข้อบกพร่องในข้อเสนอช่วงทดลองใช้ FLEDGE จากต้นฉบับของ Chrome][10]

การใช้งาน

การรายงานข้อบกพร่องจะใช้ JavaScript API ต่อไปนี้ ซึ่งทั้ง 2 รายการรับอาร์กิวเมนต์สตริง URL

• forDebuggingOnly.reportAdAuctionWin(String url)
• forDebuggingOnly.reportAdAuctionLoss(String url)

ตัวอย่างต่อไปนี้รายงานการประมูลโฆษณาที่แพ้พร้อมราคาเสนอที่ชนะ และ ตัวแปรภายใน จากนั้นคุณสามารถใช้ข้อมูลนี้เพื่อแก้ไขข้อบกพร่องได้

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

ระบบจะแทนที่เทมเพลต ${winningBid} ด้วยค่าจริงหลังจาก การประมูลเสร็จสมบูรณ์

ผู้ขายอาจเลือกส่งคืน rejectReason จากฟังก์ชัน scoreAds ได้

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'
  }
}

หากผู้ขายไม่ได้ตั้งค่าเหตุผลของการปฏิเสธ ระบบจะส่ง not-available แทน

ตัวแปร URL

ตัวแปรที่เพิ่มลงใน URL การแก้ไขข้อบกพร่องได้จะตรงกับตัวแปรที่คล้ายกันใน Chrome (แม้ว่า ${topLevelWinningBid} และ ${topLevelMadeWinningBid} จะไม่พร้อมใช้งานเนื่องจากไม่มีแนวคิดการประมูลคอมโพเนนต์ ใน Android)

ข้อจำกัด

• โฮสต์ของ URL ต้องตรงกับโดเมน Privacy Sandbox ที่คุณลงทะเบียน
• URL ต้องมีความยาวไม่เกิน 4096 อักขระ ซึ่งรวมถึงโดเมน https:// คำนำหน้า และข้อมูลการประมูลที่แทนที่
• ในรุ่นต่อๆ ไป ระบบจะส่งการ Ping สำหรับการแก้ไขข้อบกพร่องเมื่อเชื่อมต่อกับ Wi-Fi เท่านั้น

ลักษณะการทำงานในอุปกรณ์

ในสภาพแวดล้อมของอุปกรณ์เคลื่อนที่ การปกป้องหน่วยความจำและการใช้งานเครือข่ายเป็นสิ่งสำคัญอันดับแรก ดังนั้น รายงานการแก้ไขข้อบกพร่องจึงเกิดขึ้นเป็นชุด

พร็อพเพอร์ตี้ของระบบต่อไปนี้จะควบคุมอัตราและขนาดของกลุ่ม ซึ่งสามารถ ปรับให้มีค่าต่ำลงเพื่อการพัฒนาได้

• fledge_event_level_debug_reporting_batching_rate
• fledge_event_level_debug_reporting_batch_size

เวลาในการตอบสนองที่คาดไว้ของรายงานการแก้ไขข้อบกพร่องคือ 15-60 นาทีหลังจากที่การประมูล เสร็จสมบูรณ์

ไม่มีการรับประกันที่แน่นอนเกี่ยวกับความสมบูรณ์ของรายงานการแก้ไขข้อบกพร่อง หากอุปกรณ์รีบูตหรือกระบวนการ adservices ขัดข้องก่อนที่จะส่งการเรียกไปยังเซิร์ฟเวอร์ ระบบจะทิ้งเหตุการณ์เหล่านี้

เทคโนโลยีโฆษณาแต่ละรายการมี URL การแก้ไขข้อบกพร่องที่ลงทะเบียนได้สูงสุด 75 รายการต่อการประมูล ระบบจะไม่สนใจ URL ที่ลงทะเบียนหลังจากถึงขีดจำกัดดังกล่าว

สุดท้าย หากผู้ใช้ปิดใช้ AdId ระบบจะส่งรายงานการแก้ไขข้อบกพร่อง ฟีเจอร์นี้ยังไม่ได้ใช้งานใน Developer Preview 9 แต่จะใช้งานได้ในเวอร์ชันต่อๆ ไป

ลักษณะการทำงานของเซิร์ฟเวอร์เทคโนโลยีโฆษณา

เซิร์ฟเวอร์เทคโนโลยีโฆษณาควรมีลักษณะการทำงานต่อไปนี้สำหรับการรายงานการแก้ไขข้อบกพร่อง

• อุปกรณ์จะส่งคำขอ GET ไปยังเซิร์ฟเวอร์ที่คุณระบุด้วย forDebuggingOnly.* API
• คำขอแต่ละรายการแสดงถึงรายงานการแก้ไขข้อบกพร่องระดับเหตุการณ์รายการเดียว ซึ่งก็คือการประมูลโฆษณาครั้งเดียวที่ชนะหรือแพ้
• แต่ละคำขอไม่มีเนื้อหา ข้อมูลทั้งหมดอยู่ในพารามิเตอร์การค้นหา
• เพย์โหลดการตอบกลับขนาดใหญ่อาจส่งผลเสียต่อประสิทธิภาพและการใช้ข้อมูล และระบบจะ ไม่สนใจเพย์โหลดดังกล่าว