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
- API Chủ đề đã hoàn tất giai đoạn thảo luận công khai và hiện khả dụng cho 99% người dùng, mở rộng lên tới 100%.
- Để cung cấp ý kiến phản hồi về API Chủ đề, hãy tạo một Vấn đề về Thông tin giải thích về chủ đề hoặc tham gia các cuộc thảo luận trong Nhóm kinh doanh quảng cáo trên web. Phần giải thích có một số câu hỏi mở vẫn cần được định nghĩa thêm.
- Tiến trình của Hộp cát về quyền riêng tư cung cấp tiến trình triển khai cho API Chủ đề và các đề xuất khác của Hộp cát về quyền riêng tư.
- API Chủ đề: bản cập nhật mới nhất trình bày chi tiết các thay đổi cũng như cải tiến đối với API Chủ đề và phương thức 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
: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.
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.
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
- GitHub: Đọc tài liệu giải thích về API Chủ đề, cũng như đặt câu hỏi và theo dõi nội dung thảo luận về các vấn đề trên kho lưu trữ API.
- W3C: Thảo luận về các trường hợp sử dụng trong ngành trong bài viết Cải thiện Nhóm doanh nghiệp kinh doanh quảng cáo trên web.
- Thông báo: Tham gia hoặc xem danh sách gửi thư.
- Hỗ trợ nhà phát triển Hộp cát về quyền riêng tư: Đặt câu hỏi và tham gia thảo luận về Kho lưu trữ hỗ trợ dành cho nhà phát triển Hộp cát về quyền riêng tư.
- Chromium: Báo cáo lỗi Chromium để đặt câu hỏi về hoạt động triển khai hiện có sẵn để kiểm tra trong Chrome.