Topics API: คู่มือการผสานรวม

Topics API สำหรับ Android ออกแบบมาเพื่อรองรับการโฆษณาตามความสนใจโดยไม่ต้องใช้ตัวระบุข้ามแอป

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

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

โดยทั่วไปแล้ว IBA จะมีการสื่อสารระหว่างแอป ผู้ขาย และผู้ซื้อ คู่มือนี้มีไว้สําหรับทุกฝ่าย ซึ่งรวมถึงเครือข่ายและเทคโนโลยีโฆษณาที่ทํางานเป็นทั้งผู้ซื้อและผู้ขาย

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

มีข้อควรพิจารณาระดับสูงที่สำคัญเมื่อใช้การโฆษณาตามความสนใจด้วย Topics API ดังนี้

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

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

คำศัพท์

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

ยิงประตู

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

ปัจจุบันเป้าหมายของการวางแผนการผสานรวมสำหรับ Privacy Sandbox ในตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ Android ประกอบด้วยความสามารถในการทําสิ่งต่อไปนี้

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

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

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

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

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

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

สิ่งที่ต้องมีก่อนและการตั้งค่า

นักพัฒนาแอป ผู้ขาย และผู้ซื้อควรทำตามขั้นตอนเหล่านี้เพื่อตั้งค่าเพื่อใช้งาน Topics API

ทำความคุ้นเคยกับ API

  1. เริ่มต้นด้วยการอ่านข้อเสนอการออกแบบเพื่อทำความคุ้นเคยกับ Topics API และความสามารถที่มี
  2. อ่านคู่มือนักพัฒนาซอฟต์แวร์เพื่อดูวิธีรวมโค้ดและการเรียก API ที่จำเป็นสำหรับกรณีการใช้งานของคุณ
  3. อ่านการจัดหมวดหมู่และแสดงความคิดเห็นเกี่ยวกับหัวข้อที่รวมอยู่ในรายการ
  4. ส่งความคิดเห็นสำหรับข้อเสนอการออกแบบหรือเอกสารประกอบ
  5. ลงชื่อสมัครรับข้อมูลอัปเดตเกี่ยวกับ Topics API ซึ่งจะช่วยให้คุณรับทราบข้อมูลปัจจุบันเกี่ยวกับฟีเจอร์ใหม่ๆ ที่จะเปิดตัวในรุ่นต่อๆ ไป

ตั้งค่าและทดสอบแอปตัวอย่าง

  1. ทำตามวิธีการในหน้านี้เพื่อตั้งค่า Privacy Sandbox ใน Android SDK ใน Android Studio
  2. แยกและเรียกใช้โค้ดในแอปตัวอย่างเวอร์ชัน Java หรือ Kotlin เพื่อทำความคุ้นเคยกับวิธีเรียกดูหัวข้อในอุปกรณ์
  3. ขณะทดสอบ ให้ทดสอบข้อมูลแอปสำหรับชื่อและคำอธิบายแอปเพื่อเปลี่ยนหัวข้อที่จะแสดงจากตัวแยกประเภทในอุปกรณ์
  4. หลังจากเข้าใจวิธีการทำงานของ API ไคลเอ็นต์และการจัดหมวดหมู่ในอุปกรณ์แล้ว ให้ใช้แอปตัวอย่างเป็นตัวอย่างเพื่อเป็นแนวทางในการผสานรวมของคุณเอง

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