Topics API 是谷歌Chrome推出的隐私优先广告分类机制，2023年起逐步替代第三方Cookie；它在本地将用户三周内访问的网站映射为最多3个宽泛主题（如“Fitness”），每周刷新且不上传服务器，需检测navigator.browsingTopics可用性、尊重用户开关并合规衔接广告投放与隐私保障。
Topics API 并不是 HTML5 原生标准的一部分，而是谷歌 Chrome 浏览器在 2023 年起逐步推出的隐私优先型广告分类机制，用于替代第三方 Cookie。它不依赖 HTML5 规范实现，但可被嵌入 HTML 页面（如 H5 游戏、PWA 或响应式网页）中调用，前提是运行在支持该 API 的 Chrome 版本（Dev/Canary/Beta 渠道早期启用，Stable 自 2024 年起逐步默认开启）。
Topics API 的核心逻辑：本地归类，不传原始行为
浏览器在本地分析用户近期（过去三周）访问过的前 5 个高相关性网站，自动映射到预定义的约 350 个宽泛主题（如 “Fitness”, “Travel”, “Automotive”），每个主题对应一个通用语义类别，不含具体 URL、搜索词或个人身份信息。每周刷新一次，且最多只向单个网站暴露 1–3 个主题——这些主题由浏览器本地生成并缓存，不会上传至服务器，也不跨站点共享。
前端集成要点：声明式调用 + 用户可控开关
开发者无需主动“收集”用户数据，只需在页面中通过 JavaScript 调用 Topics API 获取当前可用主题列表，再传递给广告平台（如 Google Ad Manager）。关键前提是尊重用户设置：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 必须检测
navigator.browsingTopics是否可用（仅 Chrome 支持，其他浏览器返回 undefined）； - 调用前应检查用户是否已开启 “Ad topics” 选项（可在 chrome://settings/privacySandbox 中查看）；
- 若用户禁用或未授权，API 返回空数组，此时应降级使用上下文广告（如页面关键词匹配）或不请求主题；
- 不可缓存、拼接或推断主题以构建用户画像——违反 Chrome 的使用政策将导致 API 调用被限制。
与广告投放链路的合规衔接
Topics 数据本身不能直接用于个性化重定向或跨站追踪。广告平台（如 AdSense、Ad Manager）需将主题作为粗粒度信号之一，结合上下文（页面内容）、地理位置（粗略区域）、设备类型等非识别性维度共同参与竞价。例如：
立即学习“前端免费学习笔记（深入）”；
- 某健康类 H5 游戏页面触发 Topics API 返回 [“Fitness”, “Health”]；
- 广告请求中附带这两个主题标签，同时页面 meta 标签声明 content=“fitness-game”；
- 广告平台匹配到运动饮料品牌广告主的出价策略中包含 “Fitness” 主题偏好，且该广告主未要求设备 ID 或邮箱等 PII；
- 最终展示广告不依赖用户历史行为回溯，也不记录本次主题选择结果用于后续建模。
必须同步落实的隐私保障动作
仅启用 Topics API 不等于满足 GDPR 或 CCPA 合规要求。还需：
- 在隐私政策中明确说明使用 Topics API 的目的、主题范围、用户控制方式（含截图指引如何关闭）；
- 确保页面全链路启用 HTTPS，防止 Topics 请求头被中间人劫持或污染；
- 避免在 Topics 调用前后注入可疑脚本（如未经审计的第三方统计 SDK），以防侧信道泄露；
- 若集成穿山甲、Unity Ads 等第三方 SDK，须确认其已适配 Topics 接口，并签署对应的数据处理协议（DPA）。
