用户和开发者应该能够微调 Topics API,以提高内容相关性。本页将指导您如何管理和自定义 Topics API,以满足用户的偏好设置和需求。
以用户的身份退出
用户必须能够:
- 了解 Topics API 的用途。
- 识别与用户的浏览活动相关联的主题。
- 了解 API 何时处于使用状态。
- 具有启用或停用 API 的控件。
- 控制与 API 调用方共享哪些主题。
Topics API 提供简单易懂的分类,方便用户了解和控制浏览器可能会为他们建议的主题。Chrome 会在 chrome://settings/adPrivacy/interests
上提供 Topics API 的相关信息和设置。
用户可以通过以下方式屏蔽不想与 API 调用方分享的主题类别:
- 屏蔽浏览器已分配给他们的主题。
- 在
chrome://settings/adPrivacy/interests/manage
中主动屏蔽不感兴趣的广泛主题类别。在这种情况下,用户不必等到分配主题之后就会屏蔽该主题。
在无痕模式下,API 调用方无法使用主题;当浏览记录被清除时,主题也会被一并清除。
在以下情况下,返回的主题列表将为空:
- 用户在浏览器设置中于
chrome://settings/adPrivacy/interests
选择停用 Topics API。 - 用户已清除其主题(使用位于
chrome://settings/adPrivacy/interests
的浏览器设置)或清除其 Cookie。 - 浏览器处于无痕模式。
- 用户屏蔽了所有可能的主题。
解释器详细介绍了隐私保护目标以及该 API 如何努力实现这些目标。
作为开发者选择停用
您可以选择对自己网站上的特定网页停用主题计算,方法是在网页上添加 Permissions-Policy: browsing-topics=()
Permissions-Policy 标头,以防止仅对该网页上的所有用户进行主题计算。您网站上的其他网页在之后的访问不会受到影响:如果您在某个网页上设置了政策来屏蔽 Topics API,则不会影响其他网页。
您还可以使用 Permissions-Policy
标头来控制第三方对 Topics API 的访问权限,从而控制哪些第三方有权访问您网页上的主题。使用 self
以及您想允许访问该 API 的任何网域作为标头的参数。例如,如需在除您自己的源和 https://example.com
之外的所有浏览上下文中完全禁止使用 Topics API,请设置以下 HTTP 响应标头:
Permissions-Policy: browsing-topics=(self "https://example.com")
See also
Check out our resources to better understand the Topics API on the Web.
- Check out Topics demos, collab and walkthrough videos.
- See the list of Chrome flags that allow developers to customize the Topics API for testing.
- See how users and developers can control the API.
- Check out the resources for technical explainers and support. Ask questions, engage and share feedback.