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

ดูวิธีใช้ Topics API ให้สอดคล้องกับกรณีการใช้งานเทคโนโลยีโฆษณาที่เฉพาะเจาะจง

ก่อนเริ่มต้น

ขั้นตอนแรกคือทำความคุ้นเคยกับ Topics API และบริการต่างๆ

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

สร้างและทดสอบภายในเครื่อง

ส่วนนี้จะอธิบายวิธีลองใช้ Topics API ในฐานะนักพัฒนาแต่ละราย

  1. การทดสอบและการติดตั้งใช้งานในเครื่อง (เวลาโดยประมาณ: ประมาณ 2 วัน)
    1. เปิดใช้ API ด้วยเบราว์เซอร์ในเครื่องจากบรรทัดคำสั่งด้วยแฟล็กฟีเจอร์ ทดสอบการสาธิตส่วนหัวและ JavaScript API เพื่อดูการใช้งานจริงของ Topics (วิดีโอคำแนะนำแบบทีละขั้น)
    2. เรียกใช้ Topics Colab เพื่อทดสอบการอนุมานหัวข้อโดยใช้โมเดลแมชชีนเลิร์นนิงของ Topics

เปิดใช้ Topics ในเบราว์เซอร์

หากต้องการเปิดใช้ Topics API ในอินสแตนซ์ Chrome ของคุณเองสำหรับการทดสอบในเครื่อง คุณมี 2 ตัวเลือกดังนี้

  1. เปิดใช้ API ความเป็นส่วนตัวเกี่ยวกับโฆษณาทั้งหมดใน chrome://settings/adPrivacy
  2. (แนะนำ) เรียกใช้ Chrome จากบรรทัดคำสั่งที่มีแฟล็ก Chromium โดยใช้พารามิเตอร์เฉพาะสำหรับ Topics API เพื่อกำหนดค่าตามที่จำเป็น

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

แสดงตัวอย่างกลไกของ Topics API

คุณสามารถดูกลไก Topics API ที่สำคัญในเครื่องโดยใช้เครื่องมือ chrome://topics-internals

ลองดูภายใน Topics API ที่ chrome://topics-internals
แท็บสถานะหัวข้อของเครื่องมือ chrome://topics-internals

ใช้เครื่องมือ Topics API ภายในเพื่อทดสอบตัวแยกประเภทภายในเครื่องตามเว็บไซต์ที่คุณเข้าชม

เมื่อใช้เครื่องมือนี้ คุณจะตรวจสอบสิ่งต่อไปนี้ได้

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

ดูวิธีแก้ไขข้อบกพร่องของ Topics ด้วยเครื่องมือ Internals

วิธีที่ API แสดงผลหัวข้อ

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

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเลือกหัวข้อได้ในการแยกประเภทหัวข้อ

คำแนะนำสำคัญ

  1. อย่าลืมปิด (และหยุด) กระบวนการทั้งหมดของ Chrome ก่อนเริ่มขั้นตอนใหม่โดยใช้แฟล็ก
  2. ตรวจสอบว่าได้เปิดใช้ API ความเป็นส่วนตัวเกี่ยวกับโฆษณาทั้งหมดภายใต้ chrome://settings/adPrivacy แล้ว
  3. ใช้หน้าแก้ไขข้อบกพร่องเพื่อทำความเข้าใจวิธีการทำงานของ Topics ภายในเครื่อง
  4. เมื่อมีคำถาม โปรดดูคำอธิบายปัญหาเกี่ยวกับ GitHub
  5. หาก API ไม่ทำงานตามที่คาดไว้ ให้ลองทำตามเคล็ดลับการแก้ปัญหา

วางแผนการติดตั้งใช้งาน MVP

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

ผู้โทรของ Topics API คือเอนทิตีที่เรียกใช้เมธอด JavaScript document.browsingTopics() หรือสังเกตและเข้าถึงหัวข้อโดยใช้ส่วนหัวของคำขอ HTTP รหัสของคุณและ eTLD+1 ที่เรียกใช้จากในตัวอย่างนี้คือผู้โทร การเรียก Topics API เป็นการสั่งให้เบราว์เซอร์ของผู้ใช้สังเกตหัวข้อที่สนใจเมื่อผู้ใช้เข้าชมเว็บไซต์ การเข้าชมนี้จะถูกนำมาพิจารณาในการคำนวณหัวข้อสำหรับ Epoch ถัดไป

Topics API ออกแบบมาเพื่อกรองผลลัพธ์สำหรับผู้โทรแต่ละรายหรือต่อ eTLD+1 ของบริบทการเรียกใช้ กล่าวคือ ระบบจะถือว่าต้นทางของ iframe (เมื่อใช้ JavaScript API) หรือ URL ของคำขอดึงข้อมูล (เมื่อใช้ส่วนหัว) เป็นผู้โทร และหัวข้อจะคำนวณตามผู้โทรนั้น

แผนภาพต่อไปนี้จะแสดงวิธีการดังกล่าว

ขั้นตอนที่ Topics API ใช้ขณะที่ผู้ใช้เข้าชมเว็บไซต์ที่ใช้ API
วิธีที่ API สังเกตและเข้าถึงหัวข้อ

ในแผนภาพนี้

  1. ผู้ใช้เปิด Chrome และเข้าชมเว็บไซต์หลายแห่ง (customerA.example, customerB.example.br ฯลฯ) ซึ่งรวมถึง iframe ของเทคโนโลยีโฆษณา (แหล่งที่มา: iframe.adtech.example) หรือส่วนหัวที่ส่งผ่านการเรียกใช้การดึงข้อมูล
    • Chrome จะบันทึกหัวข้อความสนใจของผู้ใช้รายนี้
  2. หลังจากนำทางครบ 7 วันโดยมีหัวข้อที่สนใจโดย Topics API ผู้ใช้รายเดียวกันที่ใช้อุปกรณ์เดียวกันเข้าชมเว็บไซต์เป้าหมาย (publisher-e.example) Topics API จะแสดงรายการหัวข้อ และในตัวอย่างเฉพาะนี้ ระบบจะแสดงผล 1 หัวข้อที่คำนวณจากการสังเกตผู้ใช้นี้ในสัปดาห์ก่อนหน้า
    • เฉพาะเบราว์เซอร์ของผู้ใช้ที่เข้าชมเว็บไซต์ที่ adtech.example สังเกตการณ์ในขั้นตอนที่ 1 เท่านั้นที่จะแสดงผลการค้นหาหัวข้อในขั้นตอนที่ 2 (เราเรียกว่าการกรองการสังเกตการณ์ ซึ่งคุณจะไม่เห็นหัวข้อของผู้ใช้ที่คุณไม่เคยเห็นมาก่อน)
  3. ด้วยรายการนี้ (สำหรับหัวข้อเดียวในขณะนี้) คุณสามารถเรียกใช้แบ็กเอนด์ API (ads.adtech.example/topics-backend) เพื่อใช้ข้อมูลหัวข้อเป็นส่วนหนึ่งของชุดข้อมูลตามบริบทได้
  4. ตอนนี้ คุณสามารถสร้างประสบการณ์ที่ปรับเปลี่ยนในแบบของคุณมากขึ้นสำหรับผู้ใช้รายนี้ได้ด้วยการเข้าถึงหัวข้อความสนใจที่คุณสังเกตเห็นในช่วงสัปดาห์ที่ผ่านมา ทั้งนี้ขึ้นอยู่กับกรณีการใช้งานของคุณ

เรียกใช้ Topics API

การสังเกตและเข้าถึงหัวข้อของผู้ใช้ทำได้ 2 วิธี คุณสามารถใช้

  • JavaScript API จากภายใน iframe
    • การเพิ่ม iframe ในเว็บไซต์เป้าหมาย (เว็บไซต์ของผู้เผยแพร่โฆษณา) ที่มีโค้ด JavaScript ที่เรียกใช้ Topics API โดยใช้ document.browsingTopics()
  • ตัวเลือกส่วนหัว
    • การดึงข้อมูล (ซึ่งแนะนำ) หรือ XHR (ไม่แนะนำและใช้ได้ระหว่างช่วงทดลองใช้จากต้นทางที่สมบูรณ์เท่านั้น)
      • คุณสามารถเข้าถึงหัวข้อต่างๆ จากส่วนหัว Sec-Browsing-Topics ในคำขอที่ส่งไปยังระบบแบ็กเอนด์ของเทคโนโลยีโฆษณาได้ ซึ่งเป็นตัวเลือกที่มีประสิทธิภาพมากที่สุด (เวลาในการตอบสนองต่ำในการสังเกตหัวข้อของผู้ใช้ที่เฉพาะเจาะจงรายเดียว)
    • การใช้แท็ก iframe ที่มีแอตทริบิวต์ browsingtopics ให้ทำดังนี้
      • คุณเพิ่ม iframe ด้วยแอตทริบิวต์ browsingtopics ได้และ Chrome จะรวมหัวข้อ (สังเกตได้จาก eTLD+1 ของ iframe) ไว้ในส่วนหัว Sec-Browsing-Topics ในคำขอสำหรับ iframe

ติดตั้งใช้งานด้วย JavaScript และ iframe

เราขอแนะนำให้คุณแยกการสาธิต JavaScript API หรือการสาธิตส่วนหัวของ Topics และใช้รายการใดรายการหนึ่งต่อไปนี้เป็นจุดเริ่มต้นสำหรับโค้ด

คุณรวมเอลิเมนต์ <iframe> ไว้ใน HTML หรือเพิ่ม iframe แบบไดนามิกด้วย JavaScript ได้ วิธีสร้าง iframe แบบไดนามิกอย่างหนึ่งคือการใช้ JavaScript ต่อไปนี้

const iframe = document.createElement('iframe');
iframe.setAttribute('src', 'https://...');
document.body.appendChild(iframe);

ตรวจสอบว่า Topics API ได้รับการรองรับและพร้อมใช้งานในอุปกรณ์นี้หรือไม่ผ่านการตรวจหาฟีเจอร์

'browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics') ?
  console.log('document.browsingTopics() is supported on this page') :
  console.log('document.browsingTopics() is not supported on this page');

เรียกใช้ Topics API จากใน iframe นั้น

const topics = await document.browsingTopics();

คุณควรได้รับรายการหัวข้อที่สังเกตการณ์สำหรับผู้ใช้รายนี้ในช่วง 3 สัปดาห์ที่ผ่านมา โปรดทราบว่ารายการนี้อาจว่างเปล่าหรือประกอบด้วยหัวข้อ 1, 2 หรือ 3 หัวข้อ ตั้งแต่ 3 สัปดาห์ล่าสุด

ต่อไปนี้คือตัวอย่างของสิ่งที่ API แสดงผล

[{'configVersion': String, 
  'modelVersion': String, 
  'taxonomyVersion': String, 
  'topic': Number, 
  'version': String}]
  • configVersion: สตริงที่ระบุการกำหนดค่าปัจจุบัน
  • modelVersion: สตริงที่ระบุตัวแยกประเภทแมชชีนเลิร์นนิงที่ใช้ในการอนุมานหัวข้อ
  • taxonomyVersion: สตริงที่ระบุชุดของหัวข้อที่เบราว์เซอร์ใช้อยู่
  • topic: ตัวเลขที่ระบุหัวข้อในการจัดหมวดหมู่
  • version: สตริงที่รวม configVersion และ modelVersion

อ่านข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งใช้งานนี้

ใช้งานด้วยส่วนหัว HTTP

คุณเข้าถึงหัวข้อได้จากส่วนหัวของ Sec-Browsing-Topics ของคำขอ scan()/XHR หรือของคำขอ iframe

ส่วนหัวคำขอและการตอบกลับสำหรับการตั้งค่าและการเรียกข้อมูลหัวข้อ
ส่วนหัวสำหรับ iframe และ fetch()

คุณทำเครื่องหมายหัวข้อที่ได้จากส่วนหัวของคำขอว่าสังเกตการณ์ได้โดยการตั้งค่าส่วนหัว Observe-Browsing-Topics: ?1 ในการตอบกลับคำขอ จากนั้นเบราว์เซอร์จะใช้หัวข้อดังกล่าวในการคำนวณหัวข้อที่ผู้ใช้สนใจ

หาก API แสดงผลหัวข้ออย่างน้อย 1 หัวข้อ คำขอดึงข้อมูลไปยัง eTLD+1 ที่พบหัวข้อนั้นจะมีส่วนหัว Sec-Browsing-Topics ดังนี้ 

(325);v=chrome.1:1:1, ();p=P000000000

หาก API ไม่ได้แสดงผลหัวข้อ ส่วนหัวจะมีลักษณะดังนี้

();p=P0000000000000000000000000000000

มีการเสริมค่าส่วนหัว Sec-Browsing-Topics เพื่อลดความเสี่ยงที่ผู้โจมตีจะรู้จำนวนหัวข้อที่กำหนดขอบเขตเป็นผู้โทร โดยอิงตามความยาวของส่วนหัว

ใช้กับ fetch()

ในหน้าผู้เผยแพร่โฆษณา ให้เพิ่มโค้ดสำหรับคำขอดึงข้อมูล โดยอย่าลืมใส่ {browsingTopics: true}

fetch('<topics_caller_eTLD+1>', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

ในเบราว์เซอร์ที่รองรับ API นี้ คำขอ fetch() จะมีส่วนหัว Sec-Browsing-Topics ที่แสดงรายการหัวข้อที่พบสำหรับชื่อโฮสต์ของ URL คำขอ

ติดตั้งด้วย iframe

เช่นเดียวกับคำขอ fetch() ระบบจะส่งส่วนหัว Sec-Browsing-Topics เมื่อใช้แอตทริบิวต์ browsingtopics ใน iframe

<iframe src="<topics_caller_eTLD+1>" browsingtopics></iframe>

ในกรณีนี้ จะเป็นผู้โทร ซึ่งคล้ายกับสายดึงข้อมูล

ฝั่งเซิร์ฟเวอร์ - เหมือนกันในทุกกรณี

หากต้องการให้เบราว์เซอร์ทำเครื่องหมายหัวข้อในส่วนหัวของคำขอ Sec-Browsing-Topics ว่าสังเกตการณ์ และรวมการเข้าชมหน้าเว็บปัจจุบันในการคำนวณหัวข้อยอดนิยมครั้งถัดไปของผู้ใช้ด้วย การตอบกลับของเซิร์ฟเวอร์ต้องมี Observe-Browsing-Topics: ?1

ต่อไปนี้คือตัวอย่าง JavaScript ที่ใช้ setHeader()

res.setHeader('Observe-Browsing-Topics', '?1');

การติดตั้งใช้งานแบ็กเอนด์ของ Topics

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

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics, user, domain, caller) {
  // Validate inputs
  // If the list is not empty, continue
  // Use topics as an additional contextual signal
}

ใช้หัวข้อเป็นข้อมูลบริบท

ระบบอาจพิจารณาข้อมูลหัวข้อควบคู่กับสัญญาณอื่นๆ เช่น URL, คีย์เวิร์ด และแท็ก เป็นสัญญาณเพิ่มเติมเกี่ยวกับกลุ่มเป้าหมาย

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

สร้างและติดตั้งใช้งาน

  1. รวบรวมหัวข้อด้วยการสังเกตผู้ใช้ในเวอร์ชันที่ใช้งานจริง แต่ยังไม่ได้ปรับขนาด (เวลาโดยประมาณ: ประมาณ 1 สัปดาห์)
    1. ทำความเข้าใจตัวเลือกของคุณ: iframe และ JavaScript หรือส่วนหัว HTTP
    2. กำหนดโดเมนของ iframe
    3. สร้างโค้ด JavaScript โดยใช้แอปสาธิตเป็นข้อมูลอ้างอิงโค้ด หรือใช้ตัวเลือกส่วนหัว
    4. ทำให้ Topics ใช้งานได้ในสภาพแวดล้อมที่มีการควบคุม (เว็บไซต์ที่ใช้งานจริงบางแห่ง)
    5. เพิ่มการใช้งาน Topics ไปยังเว็บไซต์เป้าหมายบางแห่ง (ขณะนี้ไม่เกิน 5 เว็บไซต์)
    6. การทดสอบและการตรวจสอบการทำงาน
  2. [ไม่บังคับ] ใช้ข้อมูล Topics เป็นสัญญาณบริบท (ร่วมกับ URL, แท็ก ฯลฯ) (เวลาโดยประมาณ: ประมาณ 3 วัน)
    1. หลังจากได้รับรายการหัวข้อแล้ว คุณจะส่งรายการหัวข้อดังกล่าวไปยังระบบแบ็กเอนด์พร้อมกับสัญญาณบริบทอื่นๆ ได้

ทำให้ใช้งานได้ในเว็บไซต์เป้าหมายบางแห่ง

ตอนนี้คุณมีโค้ดแล้ว ลองเพิ่มโค้ดลงในเว็บไซต์เป้าหมายบางแห่งสำหรับการทดสอบครั้งแรกและตรวจสอบว่า API มีความเสถียรและทำงานได้ในสภาพแวดล้อมที่มีการควบคุมนี้

เราขอแนะนำให้คุณเลือกเว็บไซต์เป้าหมายที่:

  • ได้รับการเข้าชมเดือนละน้อย (น้อยกว่า 1 ล้านครั้ง/เดือน): คุณควรเริ่มต้นด้วยการใช้ API กับกลุ่มเป้าหมายขนาดเล็กก่อน
  • คุณเป็นเจ้าของและควบคุมเอง: หากจำเป็น คุณสามารถปิดการใช้งานได้อย่างรวดเร็วโดยไม่ต้องมีการอนุมัติที่ซับซ้อน
  • ไม่สำคัญทางธุรกิจ: เนื่องจากการใช้งานนี้อาจรบกวนประสบการณ์ของผู้ใช้ ให้เริ่มจากเว็บไซต์เป้าหมายที่มีความเสี่ยงต่ำ
  • รวมไม่เกิน 5 เว็บไซต์: ตอนนี้คุณยังไม่ต้องการการเข้าชมหรือจำนวนผู้ที่เห็นมากนัก
  • นำเสนอธีมต่างๆ: เลือกเว็บไซต์ที่ตรงกับหมวดหมู่ต่างๆ (เช่น เว็บไซต์หนึ่งเกี่ยวกับกีฬา อีกเว็บไซต์หนึ่งเกี่ยวกับข่าวสาร อีกเว็บไซต์หนึ่งเกี่ยวกับอาหารและเครื่องดื่ม เป็นต้น) คุณใช้เครื่องมือหัวข้อภายในใน Chrome เพื่อตรวจสอบความถูกต้องของโดเมนและการแยกประเภทโดเมนตามตัวแยกประเภทแมชชีนเลิร์นนิงของ Topics ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขข้อบกพร่องในคู่มือนักพัฒนาซอฟต์แวร์ Topics API

การทดสอบและการตรวจสอบการทำงาน

เมื่อเรียกใช้ Topics API ในสภาพแวดล้อมแบบจำกัดนี้ จะมีการดำเนินการต่อไปนี้

  • อาร์เรย์ว่างของหัวข้อ [] หากเป็นการเรียกอุปกรณ์นี้ครั้งแรกสำหรับเว็บไซต์นี้และผู้โทรในช่วง 7 วันที่ผ่านมา
  • รายชื่อตั้งแต่ 0 ถึง 3 หัวข้อที่แสดงถึงความสนใจของผู้ใช้รายนี้
  • หลังจากการสังเกตการณ์ 7 วัน คุณจะได้รับสิ่งต่อไปนี้
    • หัวข้อหนึ่งที่แสดงถึงความสนใจของผู้ใช้นั้น ซึ่งคำนวณจากประวัติการนำทางในสัปดาห์นั้น
      • รายละเอียดสำคัญอย่างหนึ่งคือ หากผู้ใช้สังเกตหัวข้อได้ไม่มากพอสำหรับ Topics API ในการคำนวณหัวข้อยอดนิยม 5 อันดับแรกของสัปดาห์นั้น Topics จะเพิ่มหัวข้อแบบสุ่มเท่าที่จำเป็นเพื่อให้ได้จำนวนหัวข้อทั้งหมด 5 รายการ ดูรายละเอียดเพิ่มเติมเกี่ยวกับ API
  • รายการหัวข้อใหม่จะแทนที่ 1 จาก 3 หัวข้อหากคุณเรียกใช้หลังจากการสังเกต 4 สัปดาห์
  • หากคุณไม่ได้สังเกตหัวข้อสำหรับผู้ใช้เป็นเวลานานกว่า 3 สัปดาห์ Topics API จะแสดงผลอาร์เรย์ว่างเปล่า [] อีกครั้ง

วัดประสิทธิภาพและเมตริกจากประสบการณ์ของผู้ใช้

  • ควรวัดเวลาที่เรียกใช้ JavaScript เรียก Topics API ภายใน iframe แบบข้ามต้นทางเพื่อใช้ในการวิเคราะห์ประสิทธิภาพในอนาคต โปรดรวบรวมและจัดเก็บข้อมูลการวัดและส่งข้อมูลทางไกลอย่างเหมาะสมในส่วนหลังของคุณ
    • เวลาที่ใช้ในการสร้าง iframe และหัวข้อ postMessage() หลังจากได้รับหัวข้อยังเป็นเมตริกอีกอย่างหนึ่งที่เป็นไปได้ในการคำนวณ

การแก้ปัญหา

ฉันเรียกใช้ Topics API แต่ได้รับผลเป็น Null ฉันต้องทำอย่างไร
หากคุณเรียกใช้ Topics API ภายในสัปดาห์แรกหลังจากสังเกตผู้ใช้ ก็มีความเป็นไปได้ว่าจะเป็นเช่นนั้น

คำแนะนำสำคัญ

  1. ทดสอบโค้ดส่วนหน้าเพื่อให้แน่ใจว่า JavaScript ทำงานตามที่คาดไว้

  2. ทดสอบระบบแบ็กเอนด์ของคุณเพื่อรับผลลัพธ์ของหัวข้อ

    1. อย่าลืมตรวจสอบว่าประเภทข้อมูลและพารามิเตอร์ของ API แบ็กเอนด์ได้รับการกำหนดค่าอย่างถูกต้อง
    2. ตรวจสอบว่ามีการกำหนดค่าแบ็กเอนด์ให้ปรับขนาดอย่างเหมาะสมแล้ว

  3. จากประสบการณ์ของเรา ควรให้เวลาอย่างน้อย 3 สัปดาห์ก่อนที่จะเริ่มได้รับผลการค้นหาหัวข้อที่เกี่ยวข้องมากขึ้น

  4. ผู้ใช้บางรายอาจไม่ได้เปิดใช้ Topics

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

  5. เพิ่มเมตริกและความสามารถในการสังเกตในสภาพแวดล้อมนี้ คุณจะต้องใช้เมตริกดังกล่าวในการวิเคราะห์ผลลัพธ์ครั้งแรก ตัวอย่างเมตริก ได้แก่

    1. เวลาในการตอบสนองของการโทร
    2. ข้อผิดพลาด HTTP ในการเรียกใช้หัวข้อ

  6. พยายามจำกัดการเปลี่ยนแปลงการติดตั้งใช้งานในช่วง 3 สัปดาห์แรก

ปรับขนาดเป็นเวอร์ชันที่ใช้งานจริง

ต่อไปนี้เป็นการสรุปทีละขั้นตอนเกี่ยวกับวิธีปรับขนาดให้เหมาะกับเวอร์ชันที่ใช้งานจริง โปรดดูขั้นตอนอธิบายไว้ด้านล่าง

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

ปรับขนาดการติดตั้งใช้งาน

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

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

เราขอแนะนำให้ทำดังนี้

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

มีส่วนร่วมและแชร์ความคิดเห็น