การตั้งค่า 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 (กรอบเวลาที่ API ใช้ในการคำนวณความสนใจของผู้ใช้) และกำหนดค่าลักษณะการทำงานของ API ตามความต้องการได้

คำแนะนำที่สำคัญ

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

ควบคุม Topics API ด้วย Chrome Flag

Flags ของ 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 เปิดใช้อยู่ เปิดใช้ API โฆษณา: การรายงานผลการระบุแหล่งที่มา, Protected Audience, Topics, Fenced Frame
PrivacySandboxSettings4 ปิดอยู่ เปิดใช้การตั้งค่า UI ของ Privacy Sandbox รุ่นที่ 4
OverridePrivacySandboxSettingsLocalTesting เปิดใช้อยู่ หากเปิดใช้แล้ว เบราว์เซอร์จะไม่กำหนดให้เปิดใช้การตั้งค่าพื้นฐานเพื่อเปิดใช้ฟีเจอร์ Privacy Sandbox อีกต่อไป
BrowsingTopicsBypassIPIsPubliclyRoutableCheck ปิดอยู่ หากเปิดใช้ ระบบจะไม่ตรวจสอบว่าที่อยู่ IP สามารถกำหนดเส้นทางแบบสาธารณะได้หรือไม่เมื่อพิจารณาการมีสิทธิ์ของหน้าที่จะรวมไว้ในการคำนวณหัวข้อ
BrowsingTopics:number_of_epochs_to_expose 3 จำนวน Epoch ที่จะใช้คำนวณหัวข้อเพื่อส่งไปยังบริบทที่ขอ เบราว์เซอร์จะเก็บข้อมูลภายในได้สูงสุด 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 ความน่าจะเป็นที่หัวข้อแต่ละหัวข้อภายใน Epoch จะเป็นหัวข้อที่ระบบสุ่มเลือกจากอนุกรมวิธานของหัวข้อทั้งหมด ความสุ่มจะคงอยู่กับยุคและเว็บไซต์
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 ระบบจะใช้ข้อมูลการใช้งาน API (เช่น การสังเกตหัวข้อ) กี่ Epoch ในการกรองหัวข้อสำหรับบริบทการเรียก
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 ครั้งต่อยุคในเวลาคำนวณ Topics โดยมีจุดประสงค์เพื่อจำกัดการใช้งานหน่วยความจำสูงสุด
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 จำนวนโดเมนบริบทการใช้งาน API สูงสุดที่อนุญาตให้จัดเก็บต่อการโหลดหน้าเว็บ
BrowsingTopics:config_version 1 เข้ารหัสพารามิเตอร์การกำหนดค่า Topics API หมายเลขเวอร์ชันแต่ละหมายเลขควรแมปกับชุดการกำหนดค่าเพียงชุดเดียว โดยปกติแล้ว การอัปเดตพารามิเตอร์การกำหนดค่าโดยไม่อัปเดต config_version จะใช้ได้สำหรับการทดสอบในเครื่อง แต่ในบางกรณีอาจทำให้เบราว์เซอร์อยู่ในสถานะที่ไม่สอดคล้องกันและอาจส่งผลให้เบราว์เซอร์ขัดข้อง เช่น การอัปเดต number_of_top_topics_per_epoch
BrowsingTopics:taxonomy_version 1 เวอร์ชันการจัดหมวดหมู่ที่ API ใช้

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

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

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

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

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