Topics API 停用和自定义

用户和开发者应该能够微调 Topics API,以提高内容相关性。本页将指导您如何管理和自定义 Topics API,以满足用户的偏好设置和需求。

以用户的身份退出

用户必须能够:

  • 了解 Topics API 的用途。
  • 识别与用户的浏览活动相关联的主题。
  • 了解 API 何时处于使用状态。
  • 具有启用或停用 API 的控件。
  • 控制与 API 调用方共享哪些主题。

Topics API 提供简单易懂的分类,方便用户了解和控制浏览器可能会为他们建议的主题。Chrome 会在 chrome://settings/adPrivacy/interests 上提供 Topics API 的相关信息和设置。

用户可以通过以下方式屏蔽不想与 API 调用方分享的主题类别:

  • 屏蔽浏览器已分配给他们的主题。
  • chrome://settings/adPrivacy/interests/manage 中主动屏蔽不感兴趣的广泛主题类别。在这种情况下,用户不必等到分配主题之后就会屏蔽该主题。
Chrome 设置屏幕显示已屏蔽的“美容与健身”和“食品和饮料”主题,以此为例说明了如何主动屏蔽主题。
在此示例中,用户选择屏蔽主题“美容与健身"和“食品和饮品”。系统不会与发布商分享这些感兴趣的主题。

在无痕模式下,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.