Заголовки: Sec-Browsing-Topics

Заголовок Sec-Browsing-Topics

Нестандартный: Эта функция не стандартизирована. Мы не рекомендуем использовать нестандартные функции в рабочей среде, поскольку поддержка в браузерах ограничена, а функция может измениться или быть удалена. Однако в некоторых случаях, когда стандартного варианта нет, она может стать подходящей альтернативой.

Устаревшая функция: Эта функция больше не рекомендуется. Хотя некоторые браузеры всё ещё могут её поддерживать, она уже могла быть удалена из соответствующих веб-стандартов, может находиться в процессе удаления или сохраняться только для обеспечения совместимости. Избегайте её использования и, если возможно, обновите существующий код; при принятии решения обратитесь к таблице совместимости внизу этой страницы. Учтите, что в любой момент функция может перестать работать.

Предупреждение: В настоящее время два поставщика браузеров выступают против этой функции. Подробности см. в разделе Позиции относительно стандартов.

Примечание: Для использования этой функции в приложениях необходимо пройти процесс регистрации.

HTTP-заголовок Sec-Browsing-Topics запроса отправляет вместе с соответствующим запросом выбранные темы текущего пользователя, которые рекламная платформа использует для выбора персонализированного объявления.

Если для вызывающего сайта Topics API не включён в успешно пройденный процесс регистрации в Privacy Sandbox, попытка создать или изменить Sec-Browsing-Topics завершается без уведомления, а все существующие заголовки Sec-Browsing-Topics удаляются.

Подробнее см. в разделе Использование Topics API.

Тип заголовка	Заголовок запроса
Запрещённый заголовок запроса	Да (префикс `Sec-`)

Синтаксис

Sec-Browsing-Topics: <array-of-observed-topics>

Директивы

Объект JSON, представляющий массив, содержащий до трёх объектов с выбранными текущим пользователем темами за последние три эпохи. Каждый объект содержит следующие свойства:

configVersion: Строка, идентифицирующая алгоритм (за исключением части, относящейся к модели), используемый для вычисления темы.
modelVersion: Строка, обозначающая модель, используемую для классификации строки (например, имени хоста веб-страницы) по идентификаторам тем.
taxonomyVersion: Строка, обозначающая используемую версию таксономии.
topic: Число, обозначающее идентификатор темы, по которому браузер может получить тему из таксономии (см. пример таксономии интересов).
version: configVersion, modelVersion и taxonomyVersion, объединённые двоеточиями (:).

Примеры

Точные значения свойств могут различаться в зависимости от реализации браузера. Пример заголовка в Chrome может выглядеть так:

Sec-Browsing-Topics: [{configVersion: "chrome.1", modelVersion: "1", taxonomyVersion: "1", topic: 43, version: "chrome.1:1:1"}]

Спецификации

Эта функция не входит в официальный стандарт, хотя она описана в неофициальном проекте предложения Topics API.

Совместимость с браузерами

	Настольные компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari в iOS	Samsung Internet	WebView для Android	WebView в iOS
`Sec-Browsing-Topics`	115	115	Нет	101	Нет	115	Нет	77	Нет	23.0	115	Нет

См. также

Topics API

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Sec-Browsing-Topics