แหล่งข้อมูลสนับสนุนสำหรับ Topics API บนเว็บ

ดูคําแนะนําสำหรับการแก้ไขข้อบกพร่อง การแก้ปัญหา และแหล่งข้อมูลการสนับสนุนสำหรับหัวข้อต่างๆ ในเว็บ

การแก้ปัญหา

หากคุณเรียกใช้ document.browsingTopics() หรือส่งคําขอ fetch() ที่มีการตั้งค่าส่วนหัว Sec-Browsing-Topics แต่ได้รับอาร์เรย์ว่างเป็นการตอบกลับ คุณสามารถดําเนินการแก้ไขข้อบกพร่องหลายขั้นตอนเพื่อระบุสาเหตุของปัญหาได้ ทั้งในแอปพลิเคชันเวอร์ชันที่พัฒนาในเครื่องและในระบบที่ใช้งานจริง

แก้ไขข้อบกพร่องในเครื่อง

หากคุณทดสอบในเครื่อง ให้ตรวจสอบว่าคุณใช้ Chrome ที่มีพารามิเตอร์ที่จำเป็น

  • หากต้องการข้ามการลงทะเบียน ให้เปิดใช้ Flag chrome://flags/#privacy-sandbox-enrollment-overrides และเพิ่ม URL ของเว็บไซต์ที่เรียก Topics

  • กำหนดค่า Topics API สำหรับการทดสอบโดยใช้Flag ฟีเจอร์ Flag เหล่านี้ช่วยให้คุณแก้ไขพารามิเตอร์ต่างๆ เช่น ระยะเวลาของศักราช จำนวนหัวข้อยอดนิยม และอื่นๆ เพื่อให้คุณทดสอบ Topics ได้อย่างสบายใจ คุณสามารถใช้ Flag ฟีเจอร์ที่แนะนำต่อไปนี้

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

  • ก่อนเรียกใช้ Chrome ด้วย Flag โปรดตรวจสอบว่าคุณได้ปิดอินสแตนซ์และกระบวนการอื่นๆ ทั้งหมดของ Chrome แล้ว

  • โปรดตรวจสอบสิ่งต่อไปนี้

    • คุณใช้ Chrome เวอร์ชัน 101 ขึ้นไป
    • สคริปต์เรียกใช้ Topics API เพื่อสังเกตหัวข้อ เมื่อทดสอบ คุณสามารถจําลองพฤติกรรมของผู้ใช้ได้โดยไปที่เว็บไซต์ที่ฝังสคริปต์ ดูตัวอย่างการใช้งานจริงได้ที่เดโม
    • คุณไม่ได้เปิดใช้โปรแกรมบล็อกโฆษณาหรือแอปหรือส่วนขยายที่คล้ายกัน
    • คุณไม่ได้อยู่ในโหมดไม่ระบุตัวตน
    • จาก chrome://settings/trackingProtection ตัวเลือก Block all third-party cookies ปิดใช้อยู่

แก้ไขข้อบกพร่องการติดตั้งใช้งานจริง

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

  • ตรวจสอบว่าเว็บไซต์ลงทะเบียนกับ Privacy Sandbox แล้ว
  • ทดสอบโค้ดฝั่งหน้าเว็บเพื่อให้แน่ใจว่า JavaScript ทํางานตามที่คาดไว้
  • ทดสอบแบ็กเอนด์เพื่อรับผลลัพธ์ของหัวข้อ
    • อย่าลืมตรวจสอบว่าได้กําหนดค่าประเภทข้อมูลและพารามิเตอร์ API แบ็กเอนด์อย่างถูกต้อง
    • ตรวจสอบว่าได้กําหนดค่าแบ็กเอนด์ให้ปรับขนาดอย่างเหมาะสม
  • จากประสบการณ์ของเรา คุณต้องรออย่างน้อย 3 สัปดาห์ก่อนจะเริ่มเห็นผลลัพธ์ของหัวข้อที่เกี่ยวข้องมากขึ้น
  • ผู้ใช้บางรายจะเปิดใช้ Topics ไม่ได้ในกรณีต่อไปนี้
    • ผู้ใช้ปิดใช้ Topics API ได้อย่างชัดเจน
    • หน้าของผู้เผยแพร่โฆษณาสามารถควบคุมนโยบายสิทธิ์และเลือกไม่ใช้เว็บไซต์ได้
  • เพิ่มเมตริกและการสังเกตการณ์ลงในสภาพแวดล้อมนี้ คุณต้องใช้เมตริกและข้อมูลดังกล่าวเพื่อวิเคราะห์ผลลัพธ์แรก ตัวอย่างเมตริก ได้แก่
    • เวลาในการตอบสนองของการโทร
    • ข้อผิดพลาด HTTP ในการเรียกใช้หัวข้อ
  • พยายามจำกัดการเปลี่ยนแปลงในการติดตั้งใช้งานในช่วง 3 สัปดาห์แรก

แหล่งข้อมูล