Tài nguyên hỗ trợ cho Topics API trên web

Tìm các đề xuất về cách gỡ lỗi, khắc phục sự cố và tài nguyên hỗ trợ cho Chủ đề trên web.

Khắc phục sự cố

Nếu thực hiện lệnh gọi document.browsingTopics() hoặc yêu cầu fetch() với tiêu đề Sec-Browsing-Topics được đặt, nhưng nhận được một mảng trống dưới dạng phản hồi, thì bạn có thể thực hiện một số bước gỡ lỗi để xác định nguyên nhân gốc rễ của vấn đề, cả trong môi trường phát triển cục bộ và trong hệ thống trực tiếp.

Gỡ lỗi cục bộ

Nếu bạn kiểm thử cục bộ, hãy đảm bảo rằng bạn đang chạy Chrome với các tham số bắt buộc.

  • Để bỏ qua quy trình đăng ký, hãy bật cờ chrome://flags/#privacy-sandbox-enrollment-overrides và thêm URL của trang web gọi Chủ đề.

  • Định cấu hình API Chủ đề để kiểm thử bằng cờ tính năng. Các cờ này cho phép bạn sửa đổi các tham số như thời lượng epoch, số lượng chủ đề hàng đầu và các tham số khác để bạn có thể thoải mái kiểm thử Chủ đề. Bạn có thể sử dụng các cờ tính năng được đề xuất sau:

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

  • Trước khi chạy Chrome bằng cờ, hãy đảm bảo bạn đã đóng tất cả các phiên bản và quy trình Chrome khác.

  • Hãy chắc chắn rằng:

    • Bạn đang sử dụng Chrome 101 trở lên.
    • Tập lệnh của bạn đã gọi Topics API để quan sát các chủ đề. Khi kiểm thử, bạn có thể mô phỏng hành vi của người dùng bằng cách truy cập vào các trang web mà bạn nhúng tập lệnh. Hãy tham khảo bản minh hoạ để biết ví dụ thực tế.
    • Bạn không chạy trình chặn quảng cáo hoặc ứng dụng hoặc tiện ích tương tự.
    • Bạn không ở Chế độ ẩn danh.
    • Từ chrome://settings/trackingProtection, tuỳ chọn Block all third-party cookies sẽ tắt.

Gỡ lỗi quá trình triển khai trực tiếp

Nếu bạn đang gọi Topics API từ một ứng dụng đang hoạt động trong tuần đầu tiên quan sát người dùng, thì kết quả sẽ là trống, vì ứng dụng của bạn có thể chưa quan sát được chủ đề của người dùng. Bạn có thể gỡ lỗi giải pháp theo các đề xuất của chúng tôi.

  • Đảm bảo trang web của bạn đã đăng ký Hộp cát về quyền riêng tư.
  • Kiểm thử mã giao diện người dùng để đảm bảo JavaScript hoạt động như mong đợi.
  • Kiểm thử phần phụ trợ để nhận kết quả về chủ đề.
    • Hãy nhớ đảm bảo rằng bạn đã định cấu hình đúng loại dữ liệu và thông số API phụ trợ.
    • Đảm bảo bạn đã định cấu hình phần phụ trợ để mở rộng quy mô một cách phù hợp.
  • Theo kinh nghiệm của chúng tôi, bạn cần phải chờ ít nhất 3 tuần trước khi bắt đầu nhận được kết quả phù hợp hơn về chủ đề.
  • Không phải người dùng nào cũng bật tính năng Chủ đề:
    • Người dùng có thể tắt Topics API một cách rõ ràng.
    • Trang của nhà xuất bản có thể kiểm soát chính sách về quyền và chọn không tham gia trang web của họ.
  • Thêm các chỉ số và khả năng quan sát vào môi trường này: bạn sẽ cần các chỉ số này để phân tích kết quả đầu tiên. Ví dụ về chỉ số:
    • Độ trễ của các lệnh gọi.
    • Lỗi HTTP trên các lệnh gọi chủ đề.
  • Hãy cố gắng hạn chế thay đổi đối với việc triển khai trong 3 tuần đầu tiên.

Tài nguyên