ภาพรวมของ API หัวข้อสำหรับอุปกรณ์เคลื่อนที่

bookmark_border จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ดูข้อมูลเกี่ยวกับ Topics API ใน Android และขั้นตอนในการใช้งาน หรือจะข้ามไปที่การใช้หัวข้อเลยก็ได้

วิธีการทํางานของ Topics API

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

หัวข้อสำคัญ

• หัวข้อคือหัวข้อที่ผู้ใช้ปัจจุบันสนใจซึ่งมนุษย์อ่านได้ และเป็นส่วนหนึ่งของการจัดหมวดหมู่หัวข้อ
• ผู้เรียกคือเอนทิตี เช่น แอป, SDK ของบุคคลที่สาม, เว็บไซต์ หรือบริการที่ส่งคําขอไปยัง Topics API เพื่อสังเกตหรือเข้าถึงความสนใจของผู้ใช้
• ผู้เรียกใช้จะสังเกตหัวข้อได้หากผู้เรียกใช้ส่งคำขอ Topics API จากหน้าเว็บหรือแอปที่เชื่อมโยงกับหัวข้อนี้ในช่วง 3 ยุคที่ผ่านมา
• Epoch คือระยะเวลาของการคำนวณหัวข้อ ซึ่งค่าเริ่มต้นคือ 1 สัปดาห์
• การจัดหมวดหมู่คือรายการหมวดหมู่ที่เป็นลําดับชั้น ซึ่งรวมถึงหมวดหมู่ต่างๆ เช่น /Arts & Entertainment/Music & Audio/Soul & R&B และ /Business & Industrial/Business Services/Corporate Events
• ระบบจะดึงข้อมูลหัวข้อโดยใช้โมเดลการจัดหมวดหมู่ซึ่งจับคู่กิจกรรมของผู้ใช้กับหัวข้อตั้งแต่ 0 หัวข้อขึ้นไป

ขั้นตอนหลักของขั้นตอนการทํางานของ Topics API

วงจรการใช้งานของ Topics API มี 3 ขั้นตอนหลักดังนี้

• สังเกตกิจกรรมของผู้ใช้ เช่น เมื่อผู้ใช้เข้าชมหน้าเว็บ https://cats.example/tabby/index.html หรือดาวน์โหลดแอป cats
• ดึงข้อมูลหัวข้อจากกิจกรรมของผู้ใช้ เช่น /Pets & Animals/Pets/Cats
• เข้าถึงหัวข้อที่สังเกตได้ก่อนหน้านี้สําหรับผู้ใช้ เช่น เป็นสัญญาณในการเลือกการโฆษณาที่เกี่ยวข้อง (เช่น โปรโมชันอาหารแมว)

สังเกตหัวข้อ

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

• สมมติว่ามีผู้เรียกใช้ Topics API 2 ราย ได้แก่ A และ B
• โดยบริบทมี 2 รูปแบบ ดังนี้
  • Greenhouse เช่น แอปชื่อ Greenhouse หรือเว็บไซต์ greenhouse.example ที่เชื่อมโยงกับหัวข้อ Home & Garden
  • การออกกำลังกายเทนนิส เช่น แอปชื่อ "การออกกำลังกายเทนนิส" หรือเว็บไซต์ tennis.example ที่เชื่อมโยงกับหัวข้อ Sports/Tennis
• ทั้งผู้โทร A และ B อยู่ในบริบทของ Greenhouse
• เฉพาะผู้โทร B เท่านั้นที่อยู่ในบริบทของการออกกำลังกายเทนนิส
• สมมติว่าไม่มีหัวข้อใดที่สังเกตได้สําหรับผู้ใช้ก่อนศักราช 1 เพื่อลดความซับซ้อน
• ผู้ใช้เข้าชมแอป Greenhouse และผู้ที่โทร A และ B เรียกใช้ Topics API เพื่อบันทึกการเข้าชมหน้าเว็บหรือแอปของผู้ใช้ (ดูวิธีเรียกใช้ Topics API ในคู่มือการใช้งานที่แนะนำในขั้นตอนถัดไป) ระบบจะใช้ระเบียนนี้ (ชื่อโฮสต์หรือข้อมูลแอป) ในภายหลังเพื่อดึงหัวข้อที่น่าสนใจ จากนั้น Topics API จะทําเครื่องหมายหัวข้อ Home & Garden ว่าเป็นผู้สังเกตการณ์โดยทั้งผู้เรียก A และ B
• ผู้ใช้เข้าชมแอปการออกกำลังกายเทนนิส เฉพาะผู้ที่เรียกใช้ B เท่านั้นที่ส่งคําขอ Topics API จากนั้น Topics API จะทําเครื่องหมายหัวข้อ Sports/Tennis ตามที่ผู้เรียก B สังเกตเห็น
• เมื่อสิ้นสุด Epoch Topics API จะรีเฟรชหัวข้อยอดนิยมของผู้ใช้และระบุผู้เรียกใช้ที่สังเกตหัวข้อเหล่านี้ตามกิจกรรมของผู้ใช้
• ต่อมา เมื่อผู้โทร B เรียกใช้ Topics API อีกครั้ง ระบบอาจได้รับหัวข้อ Home & Garden หรือ Sports/Tennis (หรือหัวข้อแบบสุ่มโดยมีโอกาส 5%) สำหรับผู้ใช้รายนี้ในอาร์เรย์คำตอบ
• ผู้เรียก A จะเข้าถึงได้เฉพาะหัวข้อ Home & Garden เนื่องจากไม่เคยสังเกตหัวข้อ Sports/Tennis ซึ่งหมายความว่าบุคคลที่สามจะทราบเฉพาะหัวข้อที่ผู้ใช้สนใจภายในบริบทที่เฉพาะเจาะจง (แอปหรือเว็บไซต์) ที่หัวข้อนั้นปรากฏอยู่

ดึงหัวข้อ

Topics จะดึงหัวข้อที่น่าสนใจจากกิจกรรมของผู้ใช้ หัวข้อจะเลือกจากการจัดหมวดหมู่แบบโอเพนซอร์สที่กำหนดไว้ล่วงหน้า Topics จะรีเฟรชหัวข้อยอดนิยม 5 อันดับแรกของผู้เรียกใช้และหัวข้อที่ผู้ใช้เรียกใช้ในช่วง Epoch 1 ครั้ง โมเดลการจัดประเภท Topics จะดึงหัวข้อมาจากกิจกรรมของผู้ใช้ เช่น ชื่อโฮสต์สําหรับการเข้าชมหน้าเว็บ ข้อมูลแอปใน Android

ผู้โทรเข้าถึงหัวข้อที่สนใจของผู้ใช้

API จะแสดงเฉพาะหัวข้อที่ผู้เรียกใช้สังเกตเห็นภายใน 3 ช่วงเวลาล่าสุด ระบบจะแสดงหัวข้อต่อผู้เรียกสูงสุด 3 หัวข้อ โดยให้ 1 หัวข้อสำหรับแต่ละ Epoch 3 รายการล่าสุด (หากผู้เรียกสังเกตหัวข้อสำหรับ Epoch นั้น) ผู้เรียกใช้สามารถใช้หัวข้อที่แสดงผลเพื่อเสริมข้อมูลตามบริบทและรวมเข้าด้วยกันเพื่อช่วยค้นหาโฆษณาที่เกี่ยวข้องกับผู้ใช้มากขึ้น

Epoch

Topics API ต้องตรวจสอบว่าหัวข้อความสนใจที่ระบุเป็นข้อมูลล่าสุด ระบบจะอนุมานหัวข้อของผู้ใช้โดยพิจารณาจากกิจกรรมของผู้ใช้ในช่วงระยะเวลาหนึ่งๆ ที่รู้จักกันในชื่อ "Epoch" ซึ่งโดยค่าเริ่มต้นคือ 1 สัปดาห์ ผู้ใช้แต่ละรายจะมียุคของตนเอง (ยุคคือ "ต่อผู้ใช้") และระบบจะสุ่มเวลาเริ่มต้น

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

หัวข้อใน Android ในทางปฏิบัติ

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

ในบริบทของ Topics API ผู้ซื้อและผู้ลงโฆษณาจะขึ้นอยู่กับฝั่งขาย โดยฝั่งผู้ขายจะแสดงตัวตนอย่างกว้างขวางในแอปของผู้เผยแพร่โฆษณาและสังเกตหัวข้อของผู้ใช้ จากนั้นจึงแชร์หัวข้อกับผู้ซื้อเพื่อช่วยในการเลือกโฆษณาที่เกี่ยวข้องมากขึ้น หากต้องการรับหัวข้อ แอปฝั่งขายและ SDK จะต้องสร้างร่องรอยโดยการเป็นผู้สังเกตการณ์ Topics API มาอย่างน้อย 1 Epoch

โปรดดูคู่มือการใช้งาน Topics API ) สำหรับตัวอย่างโค้ดที่แสดงวิธีตั้งค่าความสามารถในการดึงข้อมูลหัวข้อสำหรับการโฆษณาตามความสนใจ

การผสานรวมหัวข้อตามประเภทธุรกิจ

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

สำหรับเทคโนโลยีโฆษณาทั้งหมด

• อ่านการจัดหมวดหมู่ Topics และแสดงความคิดเห็น
• ทดสอบกับ Topics API ตัวอย่างแอปเพื่อดูว่าตัวแยกประเภทในอุปกรณ์แสดงข้อมูลหัวข้อใดบ้าง
• อัปเดตแอปและ SDK เพื่อเริ่มเรียกใช้ Topics API
• อัปเดตโปรโตคอลเพื่อเริ่มส่งหัวข้อในคําขอโฆษณา
• ลงทะเบียนเทคโนโลยีโฆษณาด้วย Privacy Sandbox

สำหรับเทคโนโลยีโฆษณาฝั่งขาย

• กลายเป็นผู้สังเกตการณ์เพื่อสร้างร่องรอย Topics API Topics API มีสัญญาณใหม่ คุณจึงต้องอัปเดต SDK เพื่อเริ่มเรียกใช้ Topics API หากต้องการดึงข้อมูลหัวข้ออย่างต่อเนื่อง SDK ของคุณต้องเรียกใช้ API จากแอปของผู้เผยแพร่โฆษณาอย่างน้อย 1 ครั้งต่อ Epoch ระบบจะใช้เวลาสูงสุด 4 ยุคเพื่อให้ได้หัวข้อสูงสุด (3 หัวข้อ) เพื่อส่งไปกับคําขอโฆษณา
• รวมข้อมูล Topics API ในคำขอโฆษณา สำหรับคำขอโฆษณาแต่ละรายการ ให้เริ่มแชร์ข้อมูล Topics API กับพาร์ทเนอร์ฝั่งซื้อ Topics API วางแผนที่จะเสริมสัญญาณอื่นๆ (เช่น สัญญาณบริบท) เพื่อช่วยค้นหาโฆษณาที่เหมาะสมสำหรับผู้เข้าชมนั้นๆ
• ทำงานร่วมกันเกี่ยวกับโปรโตคอลสำหรับการแชร์หัวข้อกับพาร์ทเนอร์ฝั่งซื้อ Topics API ต้องใช้ SDK แต่ละรายการเพื่อทำงานร่วมกับพาร์ทเนอร์ปลายทางเพื่อยอมรับวิธีการแชร์ข้อมูล Topics API

สำหรับเทคโนโลยีโฆษณาฝั่งซื้อ

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

วิธีที่ API อนุมานหัวข้อสําหรับแอป

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

ตัวแยกประเภทหัวข้อ

หัวข้อที่น่าสนใจมาจากโมเดลการจัดประเภทที่ได้รับการฝึกด้วยข้อมูลแอปที่เผยแพร่ต่อสาธารณะ

• เมื่อใช้โมเดลตัวแยกประเภทสำหรับการอนุมานเพื่อคํานวณหัวข้อสําหรับ Epoch ที่ระบุ ชุดสัญญาณที่ใช้จะยังคงอยู่ในอุปกรณ์ สัญญาณชุดนี้อาจรวมถึงแอปที่ติดตั้งหรือใช้เมื่อเร็วๆ นี้ และอาจขยายให้รวมสัญญาณอื่นๆ ในภายหลังด้วย
• โมเดล V5 ได้รับการฝึกโดย Google ด้วยข้อมูลแอปที่ติดป้ายกำกับโดยเจ้าหน้าที่ 540,000 รายการและข้อมูลแอปที่เผยแพร่ต่อสาธารณะ 17 ล้านรายการจาก App Store เช่น Google Play Store โมเดลนี้ใช้ชื่อแอปและชื่อแพ็กเกจเป็นสัญญาณอินพุตและพร้อมให้นักพัฒนาแอปทดสอบและดูหัวข้อที่แอปจัดประเภทไว้ได้อย่างอิสระ
• อาจเป็นไปได้ว่าแอปแมปไปยังหัวข้อมากกว่า 1 หัวข้อ หรือไม่มีหัวข้อเลย หรือระบบอาจไม่ได้เพิ่มลงในประวัติหัวข้อของผู้ใช้ ในกรณีที่แอปแมปกับหัวข้อมากกว่า 1 หัวข้อในการจัดหมวดหมู่ จำนวนหัวข้อที่เลือกสำหรับแอปนี้จะจํากัดไว้ที่ 3 อันดับแรก

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

การจัดหมวดหมู่

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

หัวข้อบน Android ในเชิงปฏิบัติ

สมมติว่าผู้ใช้ติดตั้งแอป 7 แอปในอุปกรณ์ ได้แก่ ก, ข, ค, ง, จ, ฉ และช สมมติว่าการจัดประเภทหัวข้อสําหรับแอปและ SDK เทคโนโลยีโฆษณาในแอปเหล่านี้มีดังนี้

สิ้นสุดสัปดาห์ที่ 1: Topics API จะสร้างหัวข้อยอดนิยม 5 อันดับแรกของผู้ใช้สำหรับ Epoch นี้

ในสัปดาห์ที่ 2 หากผู้โทรในแอปใดก็ตามเรียกใช้ API รายการหัวข้อที่แสดงจะรวมเฉพาะหัวข้อที่ผู้โทรอยู่ใน "ผู้โทรที่ดูข้อมูลเกี่ยวกับหัวข้อนี้ได้" สำหรับหัวข้อของแอปนั้นสำหรับ epoch นั้น

• กรอบเวลาประวัติที่รวมอยู่ในการคํานวณหัวข้อที่พร้อมใช้งานสําหรับผู้เรียกแต่ละรายคือ 3 ยุค (หรือ 3 สัปดาห์)
• ระบบจะใช้เฉพาะหัวข้อที่เชื่อมโยงกับแอปที่เรียกใช้ Topics API ผ่าน SDK โฆษณาเท่านั้น ซึ่งหมายความว่าหากแอปไม่มี SDK โฆษณาที่เรียก Topics API หัวข้อที่เชื่อมโยงกับแอปนั้นจะไม่รวมอยู่ในกลุ่มหัวข้อที่ SDK โฆษณาเข้าถึงได้
• นอกจากนี้ แอปยังเลือกไม่ใช้ Topics API ได้ด้วย หัวข้อที่เชื่อมโยงกับแอปที่เลือกไม่ใช้จะไม่รวมอยู่ในการคํานวณหัวข้อรายสัปดาห์ เอกสารนี้จะได้รับการอัปเดตเพื่อรวมรายละเอียดการใช้งานที่เกี่ยวข้อง

หากมีการใช้งานแอปไม่เพียงพอที่แพลตฟอร์มจะอนุมานหัวข้อได้ 5 หัวข้อ แพลตฟอร์มอาจพิจารณาตัวเลือกต่างๆ เช่น การสร้างหัวข้อที่เหลือแบบสุ่ม

การเข้ารหัสของหัวข้อที่แสดงผล

แพลตฟอร์มเทคโนโลยีโฆษณาที่ลงทะเบียนซึ่งเรียกใช้ Topics API จะต้องระบุด้วย คีย์การเข้ารหัสเพื่อให้แน่ใจว่าหัวข้อที่แสดงผลจะอ่านได้เฉพาะกับ ของผู้โทร

Privacy Sandbox จะดึงข้อมูลคีย์เหล่านี้จากปลายทางที่เทคโนโลยีโฆษณาระบุไว้ เราขอแนะนําแนวทางปฏิบัติแนะนำในการอัปเดตคีย์เป็นประจำ แต่อย่างน้อยทุก 6 เดือน

Privacy Sandbox จะขอให้เทคโนโลยีโฆษณายืนยันความพร้อมใช้งานของปลายทางที่ระบุระหว่างขั้นตอนการลงทะเบียน สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการดำเนินการที่จำเป็น เทคโนโลยีโฆษณาปัจจุบันและที่ลงทะเบียนใหม่ โปรดดูคู่มือการลงทะเบียน

Next steps

ดูเพิ่มเติม

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

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