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")

另请参阅

请查看我们的资源,以便更好地了解 Web 版 Topics API。