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

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

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

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

  1. เอกสารการตรวจสอบของนักพัฒนาซอฟต์แวร์
    1. เริ่มด้วยการอ่านภาพรวมเพื่อเริ่มต้นใช้งาน Topics API และความสามารถต่างๆ อย่างรวดเร็ว
    2. ดูคำแนะนำแบบทีละขั้นเกี่ยวกับการสาธิตหัวข้อ (วิดีโอ)
    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. เปิด chrome://flags/#privacy-sandbox-ads-apis และเปิดใช้ Privacy Sandbox API
  2. (แนะนำ) เรียกใช้ Chrome จากบรรทัดคำสั่งที่มีแฟล็ก Chromium โดยใช้พารามิเตอร์เฉพาะ Topics API เพื่อกำหนดค่าตามต้องการ
เปิดใช้ Privacy Sandbox API ที่ chrome://flags/#privacy-sandbox-ads-apis
การเปิดใช้ Privacy Sandbox API

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

โปรดอย่าลืมว่าหากเปิดใช้ chrome://flags/#privacy-sandbox-ads-apis การดำเนินการนี้จะลบล้างการตั้งค่า Epoch ของบรรทัดคำสั่ง โดยเปลี่ยนกลับไปเป็นค่าเริ่มต้น (ปัจจุบันคือ 1 สัปดาห์)

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

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

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

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

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

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

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

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

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

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

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

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

คำแนะนำที่สำคัญ

  1. โปรดปิด (และหยุด) กระบวนการทั้งหมดของ Chrome ก่อนเริ่มขั้นตอนใหม่โดยใช้แฟล็ก
  2. หากทำการทดสอบในสภาพแวดล้อมในเครื่อง คุณควรปิดใช้ chrome://flags/#privacy-sandbox-ads-apis เนื่องจากโปรแกรมจะลบล้างการตั้งค่าบรรทัดคำสั่งและเปลี่ยนกลับเป็นค่าเริ่มต้น
  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. แต่ตอนนี้ คุณสามารถสร้างประสบการณ์การใช้งานที่ปรับเปลี่ยนให้เหมาะกับผู้ใช้รายนี้มากขึ้นได้ โดยการเข้าถึงหัวข้อที่คุณสนใจสังเกตเกี่ยวกับผู้ใช้ในช่วงสัปดาห์ที่ผ่านมา ทั้งนี้ขึ้นอยู่กับ Use Case ของคุณ

เรียกใช้ 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 หัวข้อ หรือการสาธิตส่วนหัว และใช้หนึ่งในรายการเหล่านี้เป็นจุดเริ่มต้นสำหรับโค้ดของคุณ

คุณใส่องค์ประกอบ <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 ของคำขอ fetch()/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 ทำเครื่องหมายโดยเบราว์เซอร์ว่าสังเกตได้ และรวมการเข้าชมหน้าปัจจุบันในการคำนวณหัวข้อยอดนิยมของ Epoch ถัดไปของผู้ใช้ การตอบกลับของเซิร์ฟเวอร์จะต้องรวม Observe-Browsing-Topics: ?1 ด้วย

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

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

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

คุณจะเพิ่มแบ็กเอนด์สำหรับ 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 API

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

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

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

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