การตั้งค่า Topics API

เตรียมสภาพแวดล้อมให้พร้อมใช้งาน ทดสอบ และพัฒนาเว็บแอปพลิเคชันด้วย Topics API

สร้างและทดสอบในเครื่อง

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

เปิดใช้ Topics ในเบราว์เซอร์

หากต้องการเปิดใช้ Topics API ในอินสแตนซ์ Chrome ของคุณเองสำหรับการทดสอบในเครื่อง คุณมี 2 ตัวเลือกดังนี้

  1. เปิดใช้ API ความเป็นส่วนตัวเกี่ยวกับโฆษณาทั้งหมดใน chrome://settings/adPrivacy
  2. (แนะนำ) เรียกใช้ Chrome จากบรรทัดคำสั่งที่มีแฟล็ก Chromium โดยใช้พารามิเตอร์เฉพาะสำหรับ Topics API เพื่อกำหนดค่าตามที่จำเป็น คุณจะควบคุมฟีเจอร์ของ Topics ได้อย่างละเอียดมากขึ้นโดยเรียกใช้ Chrome จากบรรทัดคำสั่ง ตัวอย่างเช่น คุณอาจตั้งค่า Topics ของ Topics (กรอบเวลาที่ API ใช้ในการคำนวณความสนใจของผู้ใช้) และกำหนดค่าลักษณะการทำงานของ API ตามความต้องการของคุณได้

คําแนะนําสําคัญ

  1. ตรวจสอบว่าคุณได้ปิดและหยุดกระบวนการของ Chrome ทั้งหมดก่อนที่จะเริ่มกระบวนการใหม่โดยใช้ Flag
  2. ตรวจสอบว่าได้เปิดใช้ Ad Privacy API ทั้งหมดในส่วน chrome://settings/adPrivacy
  3. หาก API ไม่ทํางานตามที่คาดไว้ ให้ลองทำตามเคล็ดลับการแก้ปัญหา
  4. หากมีข้อสงสัย โปรดดูคำอธิบายปัญหาใน GitHub

ควบคุม Topics API ด้วยแฟล็ก Chrome

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

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

ตารางต่อไปนี้อธิบายพารามิเตอร์แต่ละรายการ ค่าเริ่มต้น และวัตถุประสงค์

ชื่อธง ค่าเริ่มต้น คำอธิบาย
BrowsingTopics เปิดใช้อยู่ การเปิดใช้ Topics API
PrivacySandboxAdsAPIsOverride เปิดใช้อยู่ เปิดใช้ Attribution Reporting, Protected Audience, Topics, Fenced Frames
PrivacySandboxSettings4 ปิดอยู่ เปิดใช้การตั้งค่า UI ของ Privacy Sandbox เวอร์ชันที่ 4
OverridePrivacySandboxSettingsLocalTesting เปิดใช้อยู่ หากเปิดใช้ เบราว์เซอร์จะไม่กำหนดให้ต้องเปิดใช้การตั้งค่าพื้นฐานเพื่อเปิดใช้ฟีเจอร์ Privacy Sandbox อีกต่อไป
BrowsingTopicsBypassIPIsPubliclyRoutableCheck ปิดอยู่ หากเปิดใช้ การตรวจสอบว่าที่อยู่ IP กำหนดเส้นทางแบบสาธารณะได้จะถูกข้ามหรือไม่เมื่อพิจารณาการมีสิทธิ์สำหรับหน้าเว็บที่จะรวมอยู่ในการคำนวณหัวข้อ
BrowsingTopics:number_of_epochs_to_expose 3 จํานวนช่วงเวลาที่จะใช้คํานวณหัวข้อที่จะให้บริบทที่ขอ เบราว์เซอร์จะเก็บข้อมูลตามช่วงเวลาสูงสุด N+1 รายการภายใน
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s ระยะเวลาของแต่ละ Epoch ในการแก้ไขข้อบกพร่อง คุณอาจตั้งค่านี้เป็น 15 วินาทีแทนค่าเริ่มต้น 7 วัน
BrowsingTopics:number_of_top_topics_per_epoch 5 จํานวนหัวข้อที่คำนวณต่อยุค
BrowsingTopics:use_random_topic_probability_percent 5 ความน่าจะเป็นที่หัวข้อหนึ่งๆ ภายในยุคสมัยจะแสดงผลแบบสุ่มจากการจัดหมวดหมู่หัวข้อทั้งหมด ความสุ่มจะยึดตามช่วงเวลาและเว็บไซต์
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 จำนวนช่วงเวลาของข้อมูลการใช้งาน API (นั่นคือ การสังเกตหัวข้อ) ที่จะใช้ในการกรองหัวข้อสำหรับบริบทการเรียก
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 จำนวนโดเมนบริบทที่สังเกตได้สูงสุดที่จะเก็บไว้สำหรับหัวข้อยอดนิยมแต่ละหัวข้อ โดยมีจุดประสงค์เพื่อจำกัดหน่วยความจำที่ใช้อยู่
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 จำนวนรายการสูงสุดที่อนุญาตให้ดึงข้อมูลจากฐานข้อมูลสำหรับการค้นหาแต่ละรายการสำหรับบริบทการใช้งาน API การค้นหาจะเกิดขึ้น 1 ครั้งต่อยุคเมื่อถึงเวลาคำนวณหัวข้อ มีจุดประสงค์เพื่อจำกัดการใช้งานหน่วยความจำสูงสุด
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 จํานวนโดเมนบริบทการใช้งาน API สูงสุดที่อนุญาตให้จัดเก็บต่อการโหลดหน้าเว็บ 1 ครั้ง
BrowsingTopics:config_version 1 เข้ารหัสพารามิเตอร์การกําหนดค่า Topics API หมายเลขเวอร์ชันแต่ละรายการควรแมปกับชุดการกําหนดค่าเพียงชุดเดียวเท่านั้น โดยทั่วไปแล้ว การอัปเดตพารามิเตอร์การกําหนดค่าโดยไม่อัปเดต config_version นั้นไม่มีปัญหาสําหรับการทดสอบในเครื่อง แต่ในบางสถานการณ์อาจทําให้เบราว์เซอร์อยู่ในสถานะที่ไม่น่าเชื่อถือและอาจทําให้เบราว์เซอร์ขัดข้อง เช่น การอัปเดต number_of_top_topics_per_epoch
BrowsingTopics:taxonomy_version 1 เวอร์ชัน taxonomy ที่ API ใช้

ก่อนเริ่มใช้งาน

ก่อนเริ่มการใช้งาน เราขอแนะนำให้คุณดูแหล่งข้อมูลเหล่านี้เพื่อทำความคุ้นเคยกับ Topics API

  1. ดูเอกสารของนักพัฒนาซอฟต์แวร์:
    1. ทำความเข้าใจวัตถุประสงค์ของ Topics API และบทบาทในการโฆษณาตามความสนใจ
    2. ทําความเข้าใจวิธีการทำงานของ Topics บนเว็บ
    3. ลองใช้เดโมและดูวิดีโอแนะนำการใช้งาน Topics, การทำงานร่วมกัน และเครื่องมือ
    4. แยกเดโมออกมาและเรียกใช้จากเว็บไซต์ของคุณเอง
    5. อ่านคำอธิบาย API เพื่อทําความเข้าใจรายละเอียดเพิ่มเติม
  2. ทําความเข้าใจบทบาทของ API ในการรองรับความเกี่ยวข้องของโฆษณาในอนาคต เมื่อผู้ใช้จํานวนมากขึ้นไม่สามารถใช้คุกกี้ของบุคคลที่สามได้
  3. หากต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงสถานะใน API ให้สมัครรับอีเมลสำหรับนักพัฒนาแอปและคอยติดตามอัปเดตล่าสุดเกี่ยวกับ Topics
  4. มีส่วนร่วมในการสนทนาเกี่ยวกับปัญหาใน GitHub หรือการโทรของ W3C
  5. หากพบคําที่ไม่คุ้นเคย โปรดดูอภิธานศัพท์ของ Privacy Sandbox
  6. ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวคิดของ Chrome เช่น Flag ของ Chrome ได้ในวิดีโอสั้นๆ และบทความที่ goo.gle/cc

ขั้นตอนถัดไป

ดูรายละเอียดการใช้งานและตัวอย่างโค้ดเพื่อให้ผู้โทรสังเกตและเข้าถึงหัวข้อต่างๆ
ดูวิธีติดตั้งใช้งาน ทดสอบ และปรับขนาดโซลูชันตาม Topics