Thiết lập Topics API

Chuẩn bị môi trường để sử dụng, kiểm thử và phát triển các ứng dụng web bằng Topics API.

Xây dựng và kiểm thử cục bộ

Phần này mô tả cách thiết lập môi trường cục bộ để dùng thử Topics API với tư cách là nhà phát triển cá nhân. Bạn nên khám phá các bản minh hoạ để hiểu cách hoạt động của Topics trước khi bắt đầu triển khai.

Bật Topics trong trình duyệt

Để bật Topics API trong phiên bản Chrome của riêng bạn cho hoạt động kiểm thử cục bộ, bạn có hai lựa chọn:

  1. Bật tất cả các API Quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy.
  2. (Đề xuất) Chạy Chrome từ dòng lệnh bằng cờ Chromium bằng cách sử dụng các tham số dành riêng cho Topics API để định cấu hình khi cần. Bạn có thể kiểm soát chi tiết hơn các tính năng của Chủ đề bằng cách chạy Chrome từ dòng lệnh. Ví dụ: bạn có thể đặt các khoảng thời gian của Chủ đề (khung thời gian mà API dùng để tính toán mối quan tâm của người dùng) và định cấu hình hành vi của API theo nhu cầu của mình.

Đề xuất chính

  1. Đảm bảo bạn đóng và dừng tất cả các quy trình của Chrome trước khi bắt đầu quy trình mới bằng các cờ.
  2. Đảm bảo rằng bạn đã bật tất cả Ad Privacy API trong chrome://settings/adPrivacy.
  3. Nếu API không hoạt động như dự kiến, hãy thử các mẹo khắc phục sự cố của chúng tôi.
  4. Nếu bạn có thắc mắc, hãy xem các vấn đề trên GitHub đối với tài liệu giải thích.

Kiểm soát Topics API bằng cờ Chrome

Các cờ Chrome có thể sửa đổi hành vi của Topics API. Chạy Chrome qua dòng lệnh với các tham số được chỉ định để hỗ trợ kiểm thử. Ví dụ: bản minh hoạ tiêu đề đề xuất sử dụng các cờ sau:

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

Bảng sau đây giải thích từng thông số, giá trị mặc định và mục đích của thông số đó.

Tên cờ Giá trị mặc định Mô tả
BrowsingTopics đang bật Cho biết Topics API có được bật hay không.
PrivacySandboxAdsAPIsOverride đang bật Bật các API quảng cáo: Attribution Reporting API, Protected Audience API, Topics API, Fenced Frames API.
PrivacySandboxSettings4 đã vô hiệu Cho phép sử dụng phiên bản thứ tư của chế độ cài đặt giao diện người dùng Hộp cát về quyền riêng tư.
OverridePrivacySandboxSettingsLocalTesting đang bật Nếu được bật, trình duyệt sẽ không còn yêu cầu bật các chế độ cài đặt cơ bản để bật các tính năng của Hộp cát về quyền riêng tư.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck đã vô hiệu Nếu được bật, bước kiểm tra xem địa chỉ IP có thể định tuyến công khai hay không sẽ được bỏ qua khi xác định điều kiện để một trang được đưa vào tính toán chủ đề.
BrowsingTopics:number_of_epochs_to_expose 3 Số lượng giai đoạn để tính toán các chủ đề cần cung cấp cho một ngữ cảnh yêu cầu. Trình duyệt sẽ duy trì tối đa N+1 giai đoạn nội bộ.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Thời lượng của mỗi giai đoạn. Để gỡ lỗi, bạn nên đặt giá trị này thành (ví dụ) 15 giây thay vì 7 ngày mặc định.
BrowsingTopics:number_of_top_topics_per_epoch 5 Số lượng chủ đề được tính toán trên mỗi thời gian bắt đầu của hệ thống.
BrowsingTopics:use_random_topic_probability_percent 5 Xác suất mà một chủ đề riêng lẻ trong một khoảng thời gian là một chủ đề được trả về ngẫu nhiên từ toàn bộ dữ liệu phân loại chủ đề. Tính ngẫu nhiên được cố định cho một khoảng thời gian và trang web.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Số lượng kỷ nguyên dữ liệu sử dụng API (tức là các lượt quan sát chủ đề) sẽ được dùng để lọc các chủ đề cho một ngữ cảnh gọi.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 Số lượng tối đa các miền theo bối cảnh được quan sát để giữ lại cho mỗi chủ đề hàng đầu. Mục đích là giới hạn bộ nhớ đang dùng.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100.000 Số lượng mục tối đa được phép truy xuất từ cơ sở dữ liệu cho mỗi truy vấn đối với các bối cảnh sử dụng API. Truy vấn sẽ diễn ra một lần cho mỗi thời gian bắt đầu của hệ thống tại thời điểm tính toán chủ đề. Mục đích là giới hạn mức sử dụng bộ nhớ cao nhất.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 Số lượng tối đa các miền bối cảnh sử dụng API được phép lưu trữ cho mỗi lần tải trang.
BrowsingTopics:config_version 1 Mã hoá các thông số cấu hình Topics API. Mỗi số phiên bản chỉ được liên kết với một bộ cấu hình. Việc cập nhật các tham số cấu hình mà không cập nhật config_version thường sẽ ổn đối với kiểm thử cục bộ, nhưng trong một số trường hợp, việc này có thể khiến trình duyệt ở trạng thái không nhất quán và có thể dẫn đến sự cố trình duyệt, ví dụ: cập nhật number_of_top_topics_per_epoch.
BrowsingTopics:taxonomy_version 1 Phiên bản hệ thống phân loại mà API sử dụng.

Trước khi bạn bắt đầu triển khai

Trước khi bắt đầu triển khai, bạn nên xem các tài nguyên này để làm quen với Topics API.

  1. Xem tài liệu dành cho nhà phát triển:
    1. Hiểu mục đích của Topics API và vai trò của API này trong quảng cáo dựa trên mối quan tâm
    2. Tìm hiểu cách hoạt động của Chủ đề trên web.
    3. Hãy dùng thử các bản minh hoạ và xem video hướng dẫn về các bản minh hoạ, colab và công cụ của Topics.
    4. Phân nhánh các bản minh hoạ và chạy chúng trên trang web của riêng bạn.
    5. Hãy đọc giải thích về API để hiểu rõ hơn về các chi tiết.
  2. Tìm hiểu vai trò của API trong việc hỗ trợ mức độ liên quan của quảng cáo nếu trong tương lai, ngày càng có nhiều người dùng không sử dụng cookie của bên thứ ba.
  3. Để được thông báo về các thay đổi về trạng thái trong API, hãy tham gia danh sách gửi thư dành cho nhà phát triển và theo dõi thông tin cập nhật mới nhất về Topics.
  4. Đóng góp cho cuộc trò chuyện trên các vấn đề trên GitHub hoặc các cuộc gọi W3C.
  5. Nếu bạn gặp phải những thuật ngữ lạ, hãy xem bảng chú giải về Hộp cát về quyền riêng tư.
  6. Để biết thêm thông tin về các khái niệm trong Chrome, chẳng hạn như cờ Chrome, hãy xem các video và bài viết ngắn có tại goo.gle/cc.

Các bước tiếp theo

Hãy xem thông tin chi tiết về cách triển khai và mã mẫu để người gọi có thể quan sát và truy cập vào các chủ đề.
Tìm hiểu cách triển khai, kiểm thử và mở rộng quy mô các giải pháp dựa trên Chủ đề.