topics api 是 chrome 专属的非标准 https javascript 接口,需调用 navigator.getinterestcohort() 获取单主题字符串,无跨浏览器支持,不可用于精准广告投放。

Topics API 不是 HTML 功能,不能通过 HTML 标签、属性或纯前端配置启用;它是一个仅限 HTTPS 的 Chrome 浏览器原生 JavaScript API,且目前默认禁用、非标准、无跨浏览器支持。
Topics API 必须用 navigator.getInterestCohort() 调用
HTML 中写 <script>navigator.getInterestCohort()</script> 没用——必须在安全上下文(HTTPS)中,由 JS 主动调用并处理 Promise。它不响应 HTML 属性(如 browsingTopics 属性在 <iframe></iframe> 中已被 Chrome 移除),也不接受任何 HTML 配置参数。
常见错误现象:
- 本地 HTTP 环境下直接调用返回
TypeError: getInterestCohort is not a function - 在 iframe 里设
browsingTopics属性,但 Chrome 125+ 已忽略该属性,控制台无报错也无效果 - 未 await 或 .then() 处理 Promise,直接读
cohort.topic得到undefined
正确做法:
- 确保页面部署在 HTTPS 域名下(
http://localhost除外,开发可用) - 检查用户是否开启:Chrome 地址栏点击锁图标 → “网站设置” → “广告隐私” → 开启“允许网站查看您的兴趣”
- 只在需要时调用一次(每天最多一次有效请求),避免高频轮询
返回的 topic 是单个字符串,不是数组或完整画像
navigator.getInterestCohort() 返回的是一个 Promise,resolve 后是形如 {topic: "Fitness", modelVersion: "1.2", taxonomyVersion: "202404"} 的对象,topic 字段永远是单一字符串(例如 "HomeImprovement"),不是列表,也不带权重或置信度。
这意味着:
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 无法做多主题组合判断(比如“Fitness + Nutrition”联合定向)
- 不能用于人群包构建或后端标签同步——服务端根本收不到这个值
- 如果返回空字符串(
topic === ""),代表当前无可用主题,不要 fallback 到 UA 或 referrer 等替代方案(违反隐私沙盒设计初衷)
典型误用示例:cohort.topic.includes("Travel") 是安全的;但 cohort.topic.split("-") 会报错,因为它是字符串,不是编码串。
Chrome 外的浏览器完全不支持,且标准进程已停滞
截至 2026 年 5 月,navigator.getInterestCohort() 仅在 Chromium 内核浏览器(Chrome、Edge、Brave 等)中存在,Firefox 和 Safari 明确拒绝实现,WebKit 官方已声明“无计划支持”。W3C 未将其纳入标准轨道,WHATWG 也未收录,MDN 标记为 Non-standard 和 Experimental。
实际影响:
- 在 Safari 打开同一页面,
'getInterestCohort' in navigator为false,代码必须有降级逻辑 - 企业内网或 WebView 场景(如 Android WebView、iOS WKWebView)基本不可用,版本碎片严重
- 即使 Chrome 用户开启功能,也受“三周浏览窗口”“每日轮换”“主题粒度粗(共 348 个顶层类目)”等硬限制,无法支撑精细化运营
真要适配兴趣,优先走广告平台 SDK,不是 Topics API
Topics API 的唯一合理用途,是前端轻量语义适配:比如横幅文案从“新品上市”切换为“健身装备推荐”,前提是已有预置的几套文案模板,且不依赖服务端参与。
如果你的真实目标是“向特定兴趣人群精准推送横幅广告”,这条路走不通。可行路径只有:
- 接入腾讯 GDT、穿山甲、华为 Ads Kit 等平台 SDK,在
adParam中传入业务侧打标的人群 ID 或自定义标签(非 Topics) - 用第一方数据(登录态、浏览行为、搜索词)在服务端构建用户画像,再通过广告平台 API 请求定向广告
- 放弃客户端兴趣推断,改用地理围栏、设备类型、页面路径等确定性信号做基础分层
Topics API 的核心约束常被忽略:它不提供稳定 ID、不跨天持久、不保证存在、不支持调试验证——这些恰恰是广告投放最不能妥协的点。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










