อ่านวิธีอนุมานหัวข้อ และกำหนดหัวข้อให้กับผู้ใช้ เบราว์เซอร์ และผู้ใช้สามารถควบคุมรายการหัวข้อของตนได้อย่างไร
สถานะการใช้งาน
- Topics API ได้เข้าสู่ช่วงการสนทนาแบบสาธารณะแล้ว และขณะนี้พร้อมให้บริการแก่ผู้ใช้ 99 เปอร์เซ็นต์ ซึ่งขยายได้สูงสุดถึง 100 เปอร์เซ็นต์
- หากต้องการแสดงความคิดเห็นเกี่ยวกับ Topics API โปรดแจ้งปัญหาในคำอธิบาย Topics หรือเข้าร่วมการสนทนาในการปรับปรุงกลุ่มธุรกิจการโฆษณาบนเว็บ คำถามอธิบายมีคําถามที่ยังไม่ได้หลายข้อซึ่งยังต้องการคําจํากัดความเพิ่มเติม
- ไทม์ไลน์ Privacy Sandbox แสดงลําดับเวลาการติดตั้งใช้งาน Topics API และข้อเสนออื่นๆ ของ Privacy Sandbox
- Topics API: อัปเดตล่าสุด มีรายละเอียดการเปลี่ยนแปลงและการปรับปรุง Topics API และการใช้งาน
หัวข้อคืออะไร
หัวข้อใน Topics API คือหัวข้อที่ผู้ใช้สนใจซึ่งมีหลักฐานจากเว็บไซต์ที่เข้าชม
หัวข้อเป็นสัญญาณที่ช่วยให้แพลตฟอร์มเทคโนโลยีโฆษณาเลือกโฆษณาที่เกี่ยวข้องได้ ข้อมูลนี้ต่างจากคุกกี้ของบุคคลที่สามตรงที่มีการแชร์ข้อมูลนี้โดยไม่เปิดเผยข้อมูลเพิ่มเติมเกี่ยวกับตัวผู้ใช้เองหรือกิจกรรมการท่องเว็บของผู้ใช้
Topics API ช่วยให้บุคคลที่สาม เช่น แพลตฟอร์มเทคโนโลยีโฆษณา สังเกตและเข้าถึงหัวข้อที่ผู้ใช้สนใจได้ ตัวอย่างเช่น API อาจแนะนำหัวข้อ "ไฟเบอร์และ ศิลปะสิ่งทอ" สำหรับผู้ใช้ที่เข้าชมเว็บไซต์ knitting.example
รายการหัวข้อที่ Topics API ใช้เป็นสาธารณะ ดูแลจัดการโดยมนุษย์ อ่านได้โดยเจ้าหน้าที่ และออกแบบมาเพื่อหลีกเลี่ยงหมวดหมู่ที่ละเอียดอ่อน นี่คือรายการปัจจุบัน ซึ่งจะเพิ่มขึ้นเรื่อยๆ รายการนี้มีโครงสร้างตามการจัดหมวดหมู่ ซึ่งอาจเป็นหัวข้อระดับสูงหรือเจาะจงมากขึ้นก็ได้ ตัวอย่างเช่น Food & Drink
เป็นหมวดหมู่ที่กว้าง โดยมีหมวดหมู่ย่อยเป็น Cooking & Recipes
หมวดหมู่ย่อยสามารถแบ่งเป็นหมวดหมู่ย่อยอื่นๆ ได้อีก
การจัดหมวดหมู่หัวข้อดังกล่าวจำเป็นต้องตัดสินใจเลือกระหว่างประโยชน์ใช้สอยและความเป็นส่วนตัว หากหัวข้อเฉพาะเจาะจงเกินไป อาจใช้เพื่อระบุผู้ใช้แต่ละรายได้ หากกว้างเกินไป ก็จะไม่มีประโยชน์สำหรับการเลือกการโฆษณาหรือเนื้อหาอื่นๆ
การจัดหมวดหมู่หัวข้อสร้างขึ้นโดยคำนึงถึงข้อกำหนดที่สำคัญ 2 ประการดังนี้
- สนับสนุนการโฆษณาตามความสนใจ
- รักษาความปลอดภัยของผู้ใช้และปกป้องความเป็นส่วนตัว
ซึ่งจะแนะนำคำถามหลายข้อ เช่น
- วิธีที่ดีที่สุดสำหรับ API ในการอนุมานหัวข้อที่ผู้ใช้สนใจโดยอิงตามกิจกรรมการท่องเว็บโดยที่ยังรักษาความเป็นส่วนตัวของผู้ใช้ไว้คืออะไร
- คุณจะวางโครงสร้างการจัดหมวดหมู่เพื่อทำให้มีประโยชน์มากขึ้นได้อย่างไร
- การจัดหมวดหมู่ควรรวมรายการที่เฉพาะเจาะจงใดบ้าง
วิธีที่ API อนุมานหัวข้อสำหรับเว็บไซต์
หัวข้อได้มาจากโมเดลตัวแยกประเภทที่แมปชื่อโฮสต์ของเว็บไซต์กับหัวข้ออย่างน้อย 0 รายการ การวิเคราะห์ข้อมูลเพิ่มเติม (เช่น URL แบบเต็มหรือเนื้อหาของหน้าเว็บ) อาจช่วยให้แสดงโฆษณาที่เกี่ยวข้องมากขึ้น แต่ก็อาจทำให้ความเป็นส่วนตัวลดลงด้วยเช่นกัน
โมเดลตัวแยกประเภทสำหรับการแมปชื่อโฮสต์กับหัวข้อมีให้บริการแบบสาธารณะ และในฐานะหมายเหตุการอธิบาย คุณสามารถดูหัวข้อสำหรับเว็บไซต์ผ่านเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์เบราว์เซอร์ได้ โมเดลจะได้รับการพัฒนาและปรับปรุงในอนาคต และจะอัปเดตเป็นระยะๆ ความถี่ของเรื่องนี้ยังคงอยู่ในระหว่างการพิจารณา
เฉพาะเว็บไซต์ที่มีโค้ดที่เรียกใช้ Topics API เท่านั้นจะรวมอยู่ในประวัติการท่องเว็บที่มีสิทธิ์คำนวณความถี่ของหัวข้อ และที่เรียก API จะได้รับเฉพาะหัวข้อที่เคยสังเกตการณ์ กล่าวคือ เว็บไซต์ไม่มีสิทธิ์คํานวณความถี่ของหัวข้อหากไม่มีเว็บไซต์หรือบริการแบบฝังที่จะเรียกใช้ API
นอกจากนี้ ผู้โทรจะได้รับเฉพาะหัวข้อที่โค้ดของตน "เห็นแล้ว" เท่านั้น ดังนั้น ถ้ารหัสของผู้โทรรายอื่นลงทะเบียนหัวข้อ เช่น /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks
สำหรับเบราว์เซอร์ของผู้ใช้ แต่โค้ดของคุณไม่ได้ทำให้หัวข้อนั้นได้รับการลงทะเบียนสำหรับเบราว์เซอร์ของผู้ใช้ คุณจะไม่สามารถดูหัวข้อที่สนใจสำหรับเบราว์เซอร์ของผู้ใช้นั้นได้ เมื่อคุณเรียกใช้ API จากโค้ดที่ฝังไว้ของคุณ โปรดทราบว่าเนื่องจากตอนนี้ API ได้รวมระดับบนตามที่ตรวจพบแล้ว ตัวอย่างข้างต้น /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks
จึงทำให้เกิดการสังเกต Autos & Vehicles
และ Motor Vehicles
ด้วยเช่นกัน
หัวข้อที่แสดงผลสำหรับผู้ใช้จะได้รับการคำนวณใหม่สำหรับผู้โทรโดยขึ้นอยู่กับเว็บไซต์ระดับบนสุด ตัวอย่างเช่น หาก adtech.example
ขอหัวข้อของผู้ใช้ใน news-a.example
จากนั้นในวันที่ news-b.example
และจากนั้นในวันที่ news-c.example
หัวข้อที่ส่งกลับก็จะมีการคำนวณใหม่ในแต่ละเว็บไซต์ ซึ่งหมายความว่าผู้โทรมีแนวโน้มที่จะได้รับหัวข้อที่แตกต่างกันสำหรับผู้ใช้ในเว็บไซต์ระดับบนสุดที่แตกต่างกัน เนื่องจากหัวข้อ (สูงสุด) 3 รายการที่แสดงสำหรับผู้ใช้จะได้รับการสุ่มเลือกจาก 5 อันดับแรกสำหรับ Epoch 3 รายการที่ผ่านมา (โดยมีโอกาส 5% ที่จะได้หัวข้อแบบสุ่ม) ซึ่งทำให้ผู้โทรระบุผู้ใช้ตามหัวข้อได้ยากขึ้น เนื่องจาก URL เหล่านี้มักจะแตกต่างกันในเว็บไซต์ระดับบนสุดต่างๆ (แม้กระทั่งกับผู้ใช้ ผู้โทร และ Epoch เดียวกัน)
โมเดลตัวแยกประเภท
เราจะดูแลจัดการหัวข้อให้กับโดเมนระดับบนสุด 50,000 โดเมนด้วยตนเอง และการดูแลจัดการนี้ก็ใช้ในการฝึกตัวแยกประเภท รายการนี้จะอยู่ใน override_list.pb.gz
ซึ่งมีอยู่ที่ chrome://topics-internals/
ภายใต้รูปแบบปัจจุบันในแท็บตัวแยกประเภท API จะใช้การเชื่อมโยงโดเมนกับหัวข้อในรายการแทนเอาต์พุตของโมเดล
![หน้า chrome://topics-internals ที่เลือกแผงตัวแยกประเภท](https://developers.google.cn/static/privacy-sandbox/assets/images/chrometopics-internals-8d62cfff441e4.png?authuser=9&hl=th)
chrome://topics-internals
จะแสดงเวอร์ชันโมเดล เส้นทาง และหัวข้อที่เกี่ยวข้องกับแต่ละโฮสต์ที่แสดงอยู่หากต้องการเรียกใช้โมเดลโดยตรง ให้ดูคำแนะนำเกี่ยวกับการเรียกใช้โมเดลของ TensorFlow
หากต้องการตรวจสอบไฟล์ override_list.pb.gz
ให้คลายการแพคข้อมูลก่อนโดยทำดังนี้
gunzip -c override_list.pb.gz > override_list.pb
ใช้ protoc
เพื่อตรวจสอบเป็นข้อความ
protoc --decode_raw < override_list.pb > output.txt
GitHub มีการจัดหมวดหมู่หัวข้อที่มีรหัสทั้งหมด
การให้ความคิดเห็นหรืออินพุตเกี่ยวกับโมเดลตัวแยกประเภท
การแสดงความคิดเห็นเกี่ยวกับ Topics API มีหลายช่องทาง หากต้องการความคิดเห็นเกี่ยวกับโมเดลตัวแยกประเภท เราขอแนะนำให้ส่งปัญหาเกี่ยวกับ GitHub หรือตอบกลับปัญหาที่มีอยู่ เช่น
- ควรใช้การจัดหมวดหมู่หัวข้อแบบใดในระยะยาว
- จะเกิดอะไรขึ้นหากเว็บไซต์ไม่เห็นด้วยกับหัวข้อที่ได้รับมอบหมาย
วิธีที่เราเลือกหัวข้อยอดนิยม 5 อันดับแรกของผู้ใช้
API จะแสดงผล 1 หัวข้อสำหรับแต่ละ Epoch ได้สูงสุด 3 หัวข้อ หากแสดงผล 3 ครั้ง นี่จะรวมหัวข้อสำหรับ Epoch ปัจจุบันและ 2 ส่วนก่อนหน้า
- ที่ส่วนท้ายของแต่ละ Epoch เบราว์เซอร์จะรวบรวมรายการหน้าเว็บที่ตรงตามเกณฑ์ต่อไปนี้
- ผู้ใช้เข้าชมหน้าเว็บระหว่าง Epoch
- หน้าเว็บมีโค้ดที่เรียกใช้
document.browsingTopics()
- เปิดใช้ API แล้ว (เช่น ไม่ได้บล็อกโดยผู้ใช้หรือผ่านส่วนหัวการตอบกลับ)
- เบราว์เซอร์ในอุปกรณ์ของผู้ใช้จะใช้โมเดลตัวแยกประเภทที่ Topics API มีให้เพื่อแมปชื่อโฮสต์สําหรับแต่ละหน้ากับรายการหัวข้อ
- เบราว์เซอร์จะรวบรวมรายการหัวข้อ
- เบราว์เซอร์จะสร้างรายการหัวข้อห้าอันดับแรกตามความถี่
จากนั้นเมธอด document.browsingTopics()
จะแสดงหัวข้อแบบสุ่มจาก 5 อันดับแรกสําหรับแต่ละ Epoch ซึ่งมีโอกาส 5% ที่ระบบจะสุ่มเลือกหัวข้อเหล่านี้จากการจัดหมวดหมู่หัวข้อแบบเต็ม ใน Chrome ผู้ใช้ยังนำแต่ละหัวข้อออกหรือล้างประวัติการท่องเว็บเพื่อลดจำนวนหัวข้อที่ API แสดงผลได้ด้วย นอกจากนี้ ผู้ใช้ยังเลือกไม่ใช้ API ได้ด้วย
คุณดูข้อมูลเกี่ยวกับหัวข้อที่พบระหว่างช่วง Epoch ปัจจุบันได้จากหน้า chrome://topics-internals
วิธีที่ API เลือกว่าจะให้ผู้โทรคนใดเห็นหัวข้อใด
ผู้เรียก API จะได้รับเฉพาะหัวข้อที่สังเกตการณ์เมื่อเร็วๆ นี้ และระบบจะรีเฟรชหัวข้อสำหรับผู้ใช้ 1 ครั้งในแต่ละ Epoch ซึ่งหมายความว่า API จะมีกรอบเวลาต่อเนื่องที่ผู้โทรอาจได้รับหัวข้อบางอย่าง
ตารางด้านล่างแสดงตัวอย่าง (แม้จะมีขนาดเล็กมาก) ของประวัติการท่องเว็บสมมติสำหรับผู้ใช้ใน Epoch หนึ่ง โดยแสดงหัวข้อที่เกี่ยวข้องกับเว็บไซต์ที่ผู้ใช้เคยเข้าชม และการเรียก API ที่มีอยู่ในแต่ละเว็บไซต์ (เอนทิตีที่เรียกใช้ document.browsingTopics()
ในโค้ด JavaScript ที่อยู่ในเว็บไซต์)
ไซต์ | หัวข้อ | ผู้โทร API ในเว็บไซต์ |
---|---|---|
yoga.example | ฟิตเนส | adtech1.example adtech2.example |
knitting.example | งานฝีมือ | adtech1.example |
การเดินป่า-วันหยุดตัวอย่าง | ฟิตเนส การท่องเที่ยว และ การคมนาคมขนส่ง | adtech2.example |
diy-clothing.example | งานฝีมือ แฟชั่น และ รูปแบบ | [ไม่มี] |
ในตอนท้ายของ Epoch (ปัจจุบันคือ 1 สัปดาห์) Topics API จะสร้างหัวข้อยอดนิยมของเบราว์เซอร์ประจำสัปดาห์
- adtech1.example มีสิทธิ์ได้รับ "ฟิตเนส" และ "งานฝีมือ" เนื่องจากสังเกตการณ์ใน Yoy.example และใน knitting.example
- adtech1.example ไม่มีสิทธิ์ที่จะได้รับลิงก์ "การเดินทางและ การขนส่ง" หัวข้อสำหรับผู้ใช้รายนี้ เนื่องจากไม่ปรากฏในเว็บไซต์ใดๆ ที่ผู้ใช้เข้าชมเมื่อเร็วๆ นี้ซึ่งเชื่อมโยงกับหัวข้อนั้น
- adtech2.example เห็นโฆษณา "ฟิตเนส" และ "การเดินทางและ การขนส่ง" หัวข้อ แต่ยังไม่เคยเห็น "งานฝีมือ" หัวข้อ
ผู้ใช้เข้าชม diy-clothing.example ซึ่งมีบรรทัด "แฟชั่นและ รูปแบบ" แต่ไม่มีการเรียก Topics API ในเว็บไซต์นั้น ในจุดนี้หมายถึงช่อง "แฟชั่นและ รูปแบบ" API จะไม่แสดงผลหัวข้อสำหรับผู้โทร
ในสัปดาห์ที่ 2 ผู้ใช้เข้าชมเว็บไซต์อื่น
ไซต์ | หัวข้อ | ผู้โทร API ในเว็บไซต์ |
---|---|---|
sewing.example | งานฝีมือ | adtech2.example |
นอกจากนี้ยังมีการเพิ่มโค้ดจาก adtech2.example ไปยัง diy-clothing.example:
ไซต์ | หัวข้อ | ผู้โทร API ในเว็บไซต์ |
---|---|---|
diy-clothing.example | งานฝีมือ แฟชั่น และ รูปแบบ | adtech2.example |
รวมถึง "Fitness" และ "การเดินทางและ การขนส่ง" จากสัปดาห์ที่ 1 นั่นหมายความว่า adtech2.example จะสามารถได้รับ "Crafts" และ "แฟชั่นและ รูปแบบ" หัวข้อ — แต่ไม่ใช่ จนถึง Epoch ต่อไปนี้ สัปดาห์ที่ 3 วิธีนี้ช่วยให้มั่นใจได้ว่าบุคคลที่สามจะไม่สามารถเรียนรู้เพิ่มเติมเกี่ยวกับอดีตของผู้ใช้ (ในกรณีนี้คือความสนใจในแฟชั่น) มากไปกว่าที่พวกเขาได้รับคุกกี้
หลังจากนั้นอีก 2 สัปดาห์ "ฟิตเนส" และ "การเดินทางและ การขนส่ง" อาจออกจากรายการหัวข้อที่มีสิทธิ์ของ adtech2.example หากผู้ใช้ไม่เข้าชมเว็บไซต์ใดๆ ที่มีหัวข้อเหล่านั้นซึ่งมีโค้ดจาก adtech2.example
การควบคุมของผู้ใช้ ความโปร่งใส และการเลือกไม่รับ
ผู้ใช้ควรเข้าใจวัตถุประสงค์ของ Topics API, เข้าใจสิ่งที่พูดเกี่ยวกับ API ทราบเมื่อมีการใช้ API และมีสิทธิ์ควบคุมเพื่อเปิดหรือปิดใช้ API ได้
การจัดหมวดหมู่ที่มนุษย์อ่านได้ของ API ช่วยให้ผู้ใช้ดูข้อมูลและควบคุมหัวข้อที่เบราว์เซอร์อาจแนะนำได้ ผู้ใช้สามารถนำหัวข้อที่ไม่ต้องการให้ Topics API แชร์กับผู้ลงโฆษณาหรือผู้เผยแพร่โฆษณาได้ และยังควบคุมเพื่อแจ้งให้ผู้ใช้ทราบเกี่ยวกับ API และแสดงวิธีเปิดหรือปิดใช้ API ดังกล่าวได้ Chrome ให้ข้อมูลและการตั้งค่าสำหรับ Topics API ที่ chrome://settings/adPrivacy
นอกจากนี้ หัวข้อจะไม่พร้อมใช้งานสำหรับการเรียก API ในโหมดไม่ระบุตัวตน และระบบจะล้างหัวข้อเมื่อล้างประวัติการท่องเว็บ
รายการหัวข้อที่แสดงผลจะว่างเปล่าในกรณีต่อไปนี้
- ผู้ใช้เลือกไม่ใช้ Topics API ผ่านการตั้งค่าเบราว์เซอร์ที่
chrome://settings/adPrivacy
- ผู้ใช้ได้ล้างหัวข้อ (ผ่านการตั้งค่าเบราว์เซอร์ที่
chrome://settings/adPrivacy
) หรือล้างคุกกี้ - เบราว์เซอร์อยู่ในโหมดไม่ระบุตัวตน
คำอธิบายจะให้รายละเอียดเพิ่มเติมเกี่ยวกับเป้าหมายด้านความเป็นส่วนตัวและวิธีที่ API พยายามจัดการกับเป้าหมายนั้น
เว็บไซต์เลือกไม่ใช้
นอกเหนือจากความสามารถของผู้ใช้ในการเลือกไม่ใช้แล้ว คุณยังสามารถเลือกไม่ใช้ Topics สำหรับเว็บไซต์หรือหน้าเว็บในเว็บไซต์ดังกล่าวได้ ดูวิธีการได้จากคู่มือนักพัฒนาซอฟต์แวร์
การใช้ Topics API ในเว็บไซต์ด้วย prebid.js
ตามที่ได้แจ้งไว้ในการเปิดตัว Prebid 7 ชุมชนได้พัฒนาการผสานรวมกับ Topics API อย่างต่อเนื่องผ่านโมดูลใหม่ เราได้ผสานรวมโมดูลนี้ในเดือนธันวาคม 2022
ดูข้อมูลเพิ่มเติมที่นี่
- อ่านเอกสารประกอบเกี่ยวกับโมดูล Topics API ของ Prebid
- สำหรับข้อมูลเพิ่มเติม โปรดติดต่อ Prebid.js ผ่านช่องทางมาตรฐานที่มีให้ใช้งาน
ขั้นตอนถัดไป
- หากคุณเป็นนักพัฒนาเทคโนโลยีโฆษณา ให้ทดสอบและเข้าร่วมกับ Topics API
- อ่านคู่มือนักพัฒนาซอฟต์แวร์เพื่อดูแหล่งข้อมูลเชิงลึกเพิ่มเติม
- ดูรายละเอียดเกี่ยวกับกรณีการใช้งานเทคโนโลยีโฆษณาที่เฉพาะเจาะจงได้ในคู่มือการผสานรวม Topics API
มีส่วนร่วมและแชร์ความคิดเห็น
- GitHub: อ่านคำอธิบายของ Topics API จากนั้นถามคำถามและติดตามการอภิปรายเกี่ยวกับปัญหาเกี่ยวกับที่เก็บ API
- W3C: พูดคุยเกี่ยวกับ Use Case ของอุตสาหกรรมในการปรับปรุงกลุ่มธุรกิจการโฆษณาบนเว็บ
- ประกาศ: เข้าร่วมหรือดูรายชื่ออีเมล
- การสนับสนุนสำหรับนักพัฒนาซอฟต์แวร์ Privacy Sandbox: ถามคำถามและเข้าร่วมการสนทนาในที่เก็บการสนับสนุนนักพัฒนาซอฟต์แวร์ของ Privacy Sandbox
- Chromium: รายงานข้อบกพร่องของ Chromium เพื่อถามคําถามเกี่ยวกับการติดตั้งใช้งานที่มีให้ทดสอบใน Chrome ในปัจจุบัน