ส่วนที่ 1 จาก 3 เกี่ยวกับการแก้ไขข้อบกพร่องการรายงานการระบุแหล่งที่มา ดูว่าเหตุใดการแก้ไขข้อบกพร่องจึงสำคัญและควรใช้รายงานข้อบกพร่องเมื่อใดในการทดสอบ
เหตุผลที่ต้องใช้รายงานข้อบกพร่อง
หากคุณกำลังทดสอบ Attribution Reporting API คุณควรตรวจสอบว่าการผสานรวมทํางานอย่างถูกต้อง ทําความเข้าใจช่องว่างของผลลัพธ์การวัดผลระหว่างการติดตั้งใช้งานตามคุกกี้กับการติดตั้งใช้งานการรายงานการระบุแหล่งที่มา และแก้ปัญหาเกี่ยวกับการผสานรวม
ต้องมีรายงานข้อบกพร่องจึงจะทํางานเหล่านี้ได้ เราจึงขอแนะนําอย่างยิ่งให้คุณตั้งค่า
อภิธานศัพท์
ลักษณะสำคัญของรายงานข้อบกพร่อง
รายงานการแก้ไขข้อบกพร่อง 2 ประเภท
รายงานการแก้ไขข้อบกพร่องมี 2 ประเภท ใช้ทั้ง 2 แบบ เนื่องจากมีกรณีการใช้งานที่แตกต่างกัน
รายงานการแก้ไขข้อบกพร่องที่สำเร็จ
รายงานการแก้ไขข้อบกพร่องที่ประสบความสําเร็จจะติดตามการสร้างรายงานการระบุแหล่งที่มาที่ประสบความสําเร็จ ข้อมูลเหล่านี้เกี่ยวข้องกับรายงานการระบุแหล่งที่มาโดยตรง
รายงานการแก้ไขข้อบกพร่องที่สำเร็จพร้อมใช้งานตั้งแต่ Chrome 101 (เมษายน 2022)
รายงานการแก้ไขข้อบกพร่องแบบละเอียด
รายงานการแก้ไขข้อบกพร่องแบบละเอียดช่วยให้คุณเห็นแหล่งที่มาและเหตุการณ์ทริกเกอร์ได้มากขึ้น เพื่อให้คุณตรวจสอบได้ว่าแหล่งที่มาได้รับการลงทะเบียนสําเร็จหรือไม่ หรือติดตามรายงานที่หายไปและระบุสาเหตุที่หายไป (แหล่งที่มาหรือเหตุการณ์ทริกเกอร์ไม่สําเร็จ การส่งหรือสร้างรายงานไม่สําเร็จ) รายงานการแก้ไขข้อบกพร่องแบบละเอียดจะระบุข้อมูลต่อไปนี้
- กรณีที่เบราว์เซอร์ลงทะเบียนแหล่งที่มาสําเร็จ
- กรณีที่เบราว์เซอร์ไม่ได้ลงทะเบียนแหล่งที่มาหรือเหตุการณ์ทริกเกอร์สําเร็จ ซึ่งหมายความว่าจะไม่สร้างรายงานการระบุแหล่งที่มา
- กรณีที่สร้างหรือส่งรายงานการระบุแหล่งที่มาไม่ได้เนื่องจากเหตุผลบางอย่าง
รายงานการแก้ไขข้อบกพร่องแบบละเอียดจะมีช่อง type ที่อธิบายการลงทะเบียนแหล่งที่มาที่สำเร็จ หรือเหตุผลที่ระบบไม่สร้างรายงานแหล่งที่มา ทริกเกอร์ หรือการระบุแหล่งที่มา
รายงานการแก้ไขข้อบกพร่องแบบละเอียดพร้อมใช้งานตั้งแต่ Chrome 109 (มกราคม 2023) ยกเว้นรายงานการแก้ไขข้อบกพร่องแบบละเอียดที่การลงทะเบียนแหล่งที่มาสำเร็จซึ่งเพิ่มเข้ามาใน Chrome 112 ในภายหลัง
ดูตัวอย่างรายงานในส่วนที่ 2: ตั้งค่ารายงานการแก้ไขข้อบกพร่อง
รายงานข้อบกพร่องจะอิงตามคุกกี้
หากต้องการใช้รายงานการแก้ไขข้อบกพร่อง แหล่งที่มาของการรายงานต้องตั้งค่าคุกกี้
หากต้นทางที่กําหนดค่าให้รับรายงานเป็นบุคคลที่สาม คุกกี้นี้จะถือเป็นคุกกี้ของบุคคลที่สาม ซึ่งหมายความว่าระบบจะสร้างรายงานการแก้ไขข้อบกพร่องก็ต่อเมื่อเบราว์เซอร์ของผู้ใช้อนุญาตคุกกี้ของบุคคลที่สามเท่านั้น
ระบบจะส่งรายงานข้อบกพร่องทันที
เบราว์เซอร์จะส่งรายงานข้อบกพร่องไปยังแหล่งที่มาของการรายงานทันที ซึ่งแตกต่างจากรายงานการระบุแหล่งที่มาที่ส่งล่าช้า
ระบบจะสร้างและส่งรายงานการแก้ไขข้อบกพร่องที่ประสบความสําเร็จทันทีที่สร้างรายงานการระบุแหล่งที่มาที่เกี่ยวข้อง ซึ่งก็คือเมื่อมีการลงทะเบียนทริกเกอร์
ระบบจะส่งรายงานการแก้ไขข้อบกพร่องแบบละเอียดทันทีเมื่อมีการลงทะเบียนแหล่งที่มาหรือทริกเกอร์
รายงานการแก้ไขข้อบกพร่องมีเส้นทางปลายทางที่แตกต่างกัน
เช่นเดียวกับรายงานการระบุแหล่งที่มา ระบบจะส่งรายงานการแก้ไขข้อบกพร่องทั้งหมดไปยังแหล่งที่มาของการรายงาน ระบบจะส่งรายงานข้อบกพร่องไปยังปลายทาง 3 แห่งแยกกันของต้นทางการรายงาน ดังนี้
- ปลายทางสําหรับรายงานการแก้ไขข้อบกพร่องที่สําเร็จระดับเหตุการณ์
- ปลายทางสําหรับรายงานการแก้ไขข้อบกพร่องที่สําเร็จซึ่งรวบรวมได้
- ปลายทางสําหรับรายงานการแก้ไขข้อบกพร่องที่แสดงรายละเอียดระดับเหตุการณ์และรวบรวมได้
ดูข้อมูลเพิ่มเติมในส่วนที่ 2: ตั้งค่ารายงานการแก้ไขข้อบกพร่อง
กรณีการใช้งาน
การตรวจสอบการผสานรวมแบบเรียลไทม์ขั้นพื้นฐาน
ระบบจะส่งรายงานข้อบกพร่องไปยังปลายทางทันที ซึ่งแตกต่างจากรายงานการระบุแหล่งที่มาที่จะมีการหน่วงเวลาเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ ใช้รายงานการแก้ไขข้อบกพร่องเป็นสัญญาณแบบเรียลไทม์ที่ระบุว่าการผสานรวมกับ Attribution Reporting API ทํางานอยู่
ดูวิธีทําได้ในส่วนที่ 3: ตำราการแก้ไขข้อบกพร่อง
การวิเคราะห์การสูญเสีย
Attribution Reporting API มีการคุ้มครองความเป็นส่วนตัวในตัว ซึ่งต่างจากคุกกี้ของบุคคลที่สาม โดยออกแบบมาเพื่อรักษาสมดุลระหว่างประโยชน์และความเป็นส่วนตัว ซึ่งหมายความว่าเมื่อใช้ Attribution Reporting API คุณอาจไม่สามารถรวบรวมข้อมูลการวัดผลทั้งหมดที่รวบรวมได้โดยใช้คุกกี้ Conversion บางรายการที่คุณติดตามได้ด้วยคุกกี้ของบุคคลที่สามจะไม่สร้างรายงานการระบุแหล่งที่มา
ตัวอย่างหนึ่งคือสําหรับรายงานระดับเหตุการณ์ คุณสามารถบันทึก Conversion ได้สูงสุด 1 รายการต่อการแสดงผล 1 ครั้ง ซึ่งหมายความว่าสําหรับการแสดงโฆษณาหนึ่งๆ คุณจะได้รับรายงานการระบุแหล่งที่มาเพียงฉบับเดียว ไม่ว่าผู้ใช้จะทำ Conversion กี่ครั้งก็ตาม
ใช้รายงานการแก้ไขข้อบกพร่องเพื่อดูความแตกต่างระหว่างผลลัพธ์การวัดผลที่อิงตามคุกกี้กับผลลัพธ์ที่คุณได้รับจาก Attribution Reporting API ระบุ Conversion ที่รายงาน จำนวน Conversion ที่ไม่ได้รายงาน และระบุ Conversion ที่เฉพาะเจาะจงและเหตุผล
ดูวิธีทําการวิเคราะห์การสูญเสียในส่วนที่ 3: ตำราการแก้ไขข้อบกพร่อง
การแก้ปัญหา
แม้ว่าความสูญเสียที่เกิดจากความเป็นส่วนตัวหรือการคุ้มครองทรัพยากรเป็นสิ่งที่คาดไว้ แต่ความสูญเสียอื่นๆ อาจเกิดขึ้นโดยไม่ตั้งใจ การกําหนดค่าที่ไม่ถูกต้องในการใช้งานหรือข้อบกพร่องในเบราว์เซอร์อาจทําให้รายงานหายไป
คุณสามารถใช้รายงานข้อบกพร่องเพื่อตรวจหาและแก้ไขปัญหาการติดตั้งใช้งานในฝั่งของคุณ หรือเพื่อรายงานข้อบกพร่องที่อาจเกิดขึ้นไปยังทีมเบราว์เซอร์ ดูวิธีทําได้ในส่วนที่ 3: ตำราการแก้ไขข้อบกพร่อง
การตรวจสอบการกำหนดค่าขั้นสูง
ฟีเจอร์บางอย่างของ Attribution Reporting API ช่วยให้คุณปรับแต่งลักษณะการทํางานของ API ได้ ตัวอย่างของกฎดังกล่าว ได้แก่ กฎการกรอง กฎการกรองข้อมูลที่ซ้ำกันออก และกฎลําดับความสําคัญ
เมื่อใช้ฟีเจอร์เหล่านี้ ให้ใช้รายงานข้อบกพร่องเพื่อตรวจสอบว่าตรรกะของคุณทําให้เกิดลักษณะการทำงานที่ต้องการในเวอร์ชันที่ใช้งานจริงโดยไม่ต้องรอรายงานการระบุแหล่งที่มา ดูวิธีทําได้ในส่วนที่ 3: ตำราการแก้ไขข้อบกพร่อง
การทดสอบในพื้นที่ด้วยรายงานที่รวบรวมได้
รายงานการแก้ไขข้อบกพร่องที่รวบรวมได้จะมีเพย์โหลดที่ไม่ได้เข้ารหัส ซึ่งต่างจากรายงานการระบุแหล่งที่มาที่รวบรวมได้ซึ่งเข้ารหัส
ใช้รายงานข้อบกพร่องที่รวบรวมได้เพื่อตรวจสอบเนื้อหาของรายงานที่รวบรวมได้ และสร้างรายงานสรุปด้วยเครื่องมือการรวมข้อมูลในเครื่องเพื่อทดสอบ
ประมวลผลรายงานบริการรวมข้อมูลอีกครั้ง
ข้อดีอีกอย่างหนึ่งของการใช้โหมดแก้ไขข้อบกพร่องคือช่วยให้คุณประมวลผลรายงานอีกครั้งได้ ดังนั้น หากต้องการประมวลผลรายงานมากกว่า 1 ครั้ง โปรดตรวจสอบว่าได้เปิดใช้รายงานข้อบกพร่องแล้ว คุณอาจต้องประมวลผลรายงานอีกครั้งในกรณีต่อไปนี้
- พยายามแก้ไขข้อบกพร่องของบริการรวมข้อมูล
- ทดสอบกลยุทธ์การแบ่งกลุ่มแบบต่างๆ
- การทดสอบค่า epsilon ที่แตกต่างกัน
การกู้ข้อมูล
เราขอแนะนําให้เทคโนโลยีโฆษณาเปิดใช้โหมดแก้ไขข้อบกพร่องเพื่อรับรายงานการแก้ไขข้อบกพร่องเพื่อให้กู้คืนข้อมูลการรายงานได้ ซึ่งมีประโยชน์ในกรณีที่เกิดปัญหาเกี่ยวกับบริการรวบรวมข้อมูล เช่น บริการไม่พร้อมใช้งานหรือไม่ตอบสนอง ซึ่งอาจทําให้การสร้างรายงานสรุปไม่สําเร็จ