Topics API สําหรับอุปกรณ์เคลื่อนที่: ภาพรวม

ดูข้อมูลเกี่ยวกับ 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 API จะทําเครื่องหมายหัวข้อว่าสังเกตได้ก็ต่อเมื่อผู้เรียกมีอยู่ในบริบทเท่านั้น
Topics API จะทําเครื่องหมายหัวข้อที่สังเกตได้เฉพาะผู้เรียกที่มีอยู่ในบริบทของหัวข้อเหล่านี้ ผู้โทรจะเข้าถึงได้เฉพาะหัวข้อที่ตนสังเกตเท่านั้น

ดึงหัวข้อ

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

การผสานรวม Topics ตามประเภทธุรกิจ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

App การจัดประเภทหัวข้อ SDK เทคโนโลยีโฆษณา
A T1, T5 ad-sdk1, ad-sdk2
B T2 ad-sdk2
C T3, T6 ad-sdk3, ad-sdk4
D T1, T4 ad-sdk1
E T5 ad-sdk4, ad-sdk5
F T6 ad-sdk2, ad-sdk3, ad-sdk4
G T7 ad-sdk2

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

หัวข้อยอดนิยม ผู้โทรที่รับข้อมูลเกี่ยวกับหัวข้อได้
T1 ad-sdk1, ad-sdk2
T2 ad-sdk2
T3 ad-sdk3, ad-sdk4
T4 ad-sdk1
T5 ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

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

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

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

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

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

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

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

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

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

ดูเพิ่มเติม

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