Документ: метод browsingTopics()

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

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

Предупреждение: Эта функция в настоящее время противоречит двум производителям браузеров. См. раздел Позиции по стандартам ниже для получения подробностей о противостоянии.

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

Метод browsingTopics() интерфейса Document возвращает промис, который выполняется с массивом объектов, представляющих основные темы для пользователя, по одной из последних трех эпох. Эти темы могут быть возвращены платформе по рекламе в последующем запросе. По умолчанию, метод также вызывает запись браузером текущего посещения страницы, как наблюдаемой вызывающим элементом, так что имя хоста страницы позже может быть использовано в расчёте тем.

См. Использование API тем для получения более подробной информации.

Примечание: browsingTopics() не полагается на HTTP-заголовки для отправки тем и маркировки тем как наблюдаемых, как и другие функции API тем, но она несколько менее производительна. Рекомендуется использовать одну из функций, использующих HTTP-заголовки, обращаясь к browsingTopics() только в ситуациях, когда заголовки не могут быть изменены.

Синтаксис

browsingTopics()
browsingTopics(options)

Параметры

options Необязательно

Объект параметров, который может содержать следующие свойства:

skipObservation: Булевое значение, которое, если установлено в true, заставляет браузер не наблюдать темы при вызове browsingTopics(). По умолчанию false, что вызывает наблюдение за темами.

Возвращаемое значение

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

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

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

{
  configVersion: "chrome.1",
  modelVersion: "1",
  taxonomyVersion: "1",
  topic: 43,
  version: "chrome.1:1:1"
}

Исключения

NotAllowedError DOMException

Выбрасывается, если:

Использование API тем запрещено политикой browsing-topics Политики разрешений.
Вызывающая сторона не включила API тем в успешный процесс регистрации песочницы конфиденциальности.

Примеры

// Get an array of top topics for this user
const topics = await document.browsingTopics();

// Request an ad creative
const response = await fetch("https://ads.example/get-creative", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify(topics),
});

// Get the JSON from the response
const creative = await response.json();

// Display ad

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

Эта функция не является частью официального стандарта, хотя она указана в Черновике неофициального предложения API тем.

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`browsingTopics`	115	115	Нет	101	Нет	115	Нет	77	Нет	23.0	115

См. также

API тем

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/browsingTopics