Bản minh hoạ API Chủ đề

Thử nghiệm và tìm hiểu cách suy ra chủ đề từ tên máy chủ với quá trình thiết lập tối giản.

Trạng thái triển khai

Bản minh hoạ Topics API cho biết cách chủ đề được suy ra từ tên máy chủ. Bạn có thể xem trước những chủ đề được quan sát khi truy cập trang web minh hoạ mà không yêu cầu thiết lập rất ít.

Bản minh hoạ của chúng tôi là bản xem trước minh hoạ hầu hết các tính năng của Topics API để bạn làm quen với cách triển khai API này.

Bạn cũng có thể chạy colab Chủ đề để dùng thử mô hình phân loại Chủ đề.

Video sau đây trình bày cách hoạt động của bản minh hoạ.

Kiểm thử bằng chrome://flags hoặc cờ tính năng

Có 2 cách để dùng thử Topics API với tư cách là một người dùng duy nhất; bạn cần chạy Chrome 101 trở lên:

  • Bật API trong trang Chrome chrome://flags/#privacy-sandbox-ads-apis:

    Bật Topics API bằng trang chrome://flags/#privacy-sandbox-ads-apis
    Trang chrome://flags/#privacy-sandbox-ads-apis nơi bạn có thể bật hoặc tắt API.

  • Chạy Chrome qua dòng lệnh với cờ sau:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Bản minh hoạ Topics API

Bản minh hoạ chủ đề cho thấy cách sử dụng cờ bổ sung để điều chỉnh các chế độ cài đặt, chẳng hạn như thời lượng của thời gian bắt đầu của hệ thống. Nếu bạn truy cập Topics API bằng cách chạy Chrome bằng cờ hiệu dòng lệnh, đừng đặt chrome://flags, vì các API này có thể ghi đè các chế độ cài đặt dòng lệnh.

Chạy Chromium bằng cờ giải thích cách đặt cờ khi chạy Chrome và các trình duyệt dựa trên Chromium khác từ dòng lệnh, mặc dù bản minh hoạ này chỉ dành riêng cho Google Chrome.

Bản minh hoạ tiêu đề Topics API

Bản minh hoạ tại topics-fetch-demo.glitch.me cho biết cách sử dụng các tiêu đề của yêu cầu và phản hồi fetch() để truy cập vào các chủ đề cũng như đánh dấu các chủ đề đó là đã quan sát được.

Truy cập vào tiêu đề của yêu cầu Sec-Browsing-Topics

Thay vì sử dụng document.browsingTopics() từ iframe để xem các chủ đề cho người dùng, phương thức gọi API có thể truy cập vào các chủ đề đã quan sát được từ tiêu đề yêu cầu Sec-Browsing-Topics của một yêu cầu tìm nạp() có chứa {browsingTopics: true} trong tham số tuỳ chọn của nó, hoặc từ chính tiêu đề của một yêu cầu XHR giúp đặt thuộc tính deprecatedBrowsingTopics thành true.

Ví dụ:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

Trong các trình duyệt hỗ trợ API, yêu cầu fetch() sẽ bao gồm tiêu đề Sec-Browsing-Topics liệt kê các chủ đề được ghi nhận đối với tên máy chủ của URL yêu cầu: trong ví dụ này là topics-server.glitch.me.

Nếu không quan sát thấy chủ đề nào cho tên máy chủ và người dùng này, thì tiêu đề sẽ được đưa vào nhưng giá trị sẽ trống. Nói cách khác, tiêu đề Sec-Browsing-Topics trong một yêu cầu fetch() chỉ bao gồm các chủ đề đã được ghi nhận cho trình duyệt của người dùng hiện tại bởi phương thức gọi có nguồn gốc khớp với tên máy chủ của URL yêu cầu. Điều này giống như khi bạn gọi document.browsingTopics() từ một iframe để xem các chủ đề đã quan sát đối với người dùng hiện tại.

Tiêu đề của yêu cầu sẽ được gửi theo yêu cầu miễn là tiêu đề đó có chính sách về quyền thích hợp đang được áp dụng, bối cảnh an toàn và chế độ cài đặt của người dùng cho phép. Chủ đề không được cung cấp trong tiêu đề cho yêu cầu điều hướng.

Tiêu đề của yêu cầu Chủ đề có dạng như sau:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Ví dụ này bao gồm 2 chủ đề trong hệ thống phân loại Chủ đề là 186 và 265, cùng với thông tin phiên bản của từng chủ đề.

Việc đưa tiêu đề chủ đề vào các yêu cầu về XHR chỉ tạm thời hoạt động và chúng tôi sẽ ngừng hỗ trợ trong tương lai.

Đánh dấu chủ đề là đã quan sát bằng Observe-Browsing-Topics

Nếu một yêu cầu có tiêu đề Sec-Browsing-Topics và nội dung phản hồi cho yêu cầu đó lại có tiêu đề Observe-Browsing-Topics: ?1, thì các chủ đề trong tiêu đề của yêu cầu sẽ được trình duyệt đánh dấu là đã quan sát. Các chủ đề được quan sát đủ điều kiện để tính toán bằng Topics API. Cơ chế này được thiết kế để phù hợp với chức năng được cung cấp bằng cách sử dụng API JavaScript từ iframe.

Ảnh chụp màn hình dưới đây cho thấy các chủ đề được ghi lại từ hoạt động truy cập vào các trang web trên trang minh hoạ API.

Trang minh hoạ Topics API trên glitch.me
Bản minh hoạ glitch.me về việc dùng thử API.

Danh sách này trình bày các trang web mà bạn có thể truy cập qua bản minh hoạ để ghi lại những chủ đề bạn quan tâm. Như bạn có thể thấy, danh mục Nghệ thuật & Giải trí/Hài kịch trong ảnh chụp màn hình không phải là chủ đề của một trong những trang web này, vì vậy, chủ đề được ghi lại này là một chủ đề được thêm vào dưới dạng chủ đề ngẫu nhiên 5%.

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

Bạn có thể kiểm tra xem chủ đề nào là chủ đề thật và chủ đề nào là ngẫu nhiên trên thẻ Trạng thái chủ đề trên trang chrome://topics-internals. Ảnh chụp màn hình này cho thấy ví dụ về nhiều phiên duyệt web.

Thẻ Trạng thái Chủ đề cung cấp thông tin về các chủ đề được ghi nhận.
Thẻ Trạng thái của chủ đề hiển thị các chủ đề thực và ngẫu nhiên.

Các bước tiếp theo

Nếu bạn là nhà phát triển công nghệ quảng cáo, hãy thử nghiệm và tham gia bằng Topics API. Đọc hướng dẫn cho nhà phát triển để biết thêm tài nguyên chuyên sâu.

Thu hút và chia sẻ ý kiến phản hồi