Thiết lập Topics API

Hãy chuẩn bị sẵn sàng cho 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.

Tạo bản 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ộ để bạn có thể dùng thử Topics API với tư cách là một 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 Chủ đề trước khi tìm hiểu cách 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 nhằm kiểm thử cục bộ, bạn có hai lựa chọn:

  1. Bật tất cả API Quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy.
  2. (Nên dùng) Chạy Chrome từ dòng lệnh có cờ Chromium bằng cách sử dụng các thông số dành riêng cho Topics API để định cấu hình (nếu 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 mốc thời gian của Chủ đề (khoảng thời gian mà API sử 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 bạn.

Đề xuất chính

  1. Hãy nhớ đóng và dừng tất cả quy trình Chrome trước khi bắt đầu quy trình mới bằng cờ.
  2. Đảm bảo rằng tất cả các Ad Privacy API (API Quyền riêng tư trong quảng cáo) đều được bật trong chrome://settings/adPrivacy.
  3. Nếu API không hoạt động như mong đợi, 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ó câu hỏi, hãy xem các vấn đề trên GitHub để biết nội dung giải thích.

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

Cờ Chrome có thể sửa đổi hành vi của Topics API. Chạy Chrome từ dòng lệnh với các tham số được chỉ định để tạo điều kiện cho việc kiểm thử. Ví dụ: bản minh hoạ tiêu đề khuyên bạn nên 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 Liệu Topics API có được bật hay không.
PrivacySandboxAdsAPIsOverride đang bật Bật các API quảng cáo: Attribution Reporting (Báo cáo phân bổ), Protected Audience (Đối tượng được bảo vệ), Topics (Chủ đề), Topics API (Khung bảo vệ).
PrivacySandboxSettings4 đã vô hiệu Bật bản phát hành 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 bạn bật tuỳ chọn này, trình duyệt sẽ không yêu cầu bật 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ư nữa.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck đã vô hiệu Nếu được bật, việc kiểm tra xem địa chỉ IP có thể định tuyến công khai hay không sẽ bị bỏ qua khi xác định tí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 epoch để tính toán các chủ đề cần cung cấp cho ngữ cảnh yêu cầu. Trình duyệt sẽ lưu giữ tối đa N+1 epoch trong nội bộ.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Thời lượng của mỗi thời gian bắt đầu của hệ thống. Để gỡ lỗi, bạn có thể đặ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 theo thời gian bắt đầu của hệ thống.
BrowsingTopics:use_random_topic_probability_percent 5 Xác suất một chủ đề riêng lẻ trong một kỷ nguyên được trả về ngẫu nhiên từ toàn bộ hệ thống phân loại chủ đề. Sự ngẫu nhiên sẽ gắn liền với một thời gian bắt đầu của hệ thống và một trang web.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Số khoảng thời gian bắt đầu của dữ liệu sử dụng API (tức là quan sát chủ đề) sẽ được dùng để lọc các chủ đề cho 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 quan sát được cần giữ lại cho mỗi chủ đề hàng đầu. Ý định là giới hạn bộ nhớ đang sử dụng.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100.000 Số mục nhập tối đa được phép truy xuất từ cơ sở dữ liệu cho mỗi truy vấn về ngữ cảnh sử dụng API. Truy vấn sẽ xảy ra một lần mỗi khoảng 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 miền ngữ cảnh sử dụng API tối đa được phép lưu trữ mỗi khi tải trang.
BrowsingTopics:config_version 1 Mã hoá các thông số cấu hình API Chủ đề. Mỗi số phiên bản chỉ được liên kết với một nhóm 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ẽ không gây ra vấn đề gì khi kiểm thử cục bộ, nhưng trong một số trường hợp, trình duyệt có thể ở 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 lại các tài nguyên này để làm quen với API Chủ đề.

  1. Xem tài liệu dành cho nhà phát triển:
    1. Tìm 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 thử các bản minh hoạ và xem video hướng dẫn về các bản minh hoạ Chủ đề, tính năng cộng tác và công cụ.
    4. Phát triển nhánh các bản minh hoạ và chạy các bản minh hoạ đó từ trang web của riêng bạn.
    5. Hãy đọc nội dung giải thích về API để tìm hiểu thêm 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 trong tương lai, khi cookie của bên thứ ba không được cung cấp cho một tỷ lệ người dùng ngày càng tăng.
  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à chú ý theo dõi các bản cập nhật mới nhất về Chủ đề.
  4. Đóng góp vào cuộc trò chuyện về các vấn đề trên GitHub hoặc cuộc gọi W3C.
  5. Nếu bạn gặp các thuật ngữ lạ, hãy xem bảng chú giải thuật ngữ 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 của Chrome, chẳng hạn như cờ Chrome, hãy xem các video ngắn và bài viết 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ủ đề.