Fence: setReportEventDataForAutomaticBeacons() метод

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из самых широко используемых браузеров.

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

Метод setReportEventDataForAutomaticBeacons() интерфейса Fence задает данные события, которые будут отправлены при навигации внутри <fencedframe>. Эти данные будут отправлены через автоматический маяк на один или несколько определенных URL-адресов, зарегистрированных через метод registerAdBeacon() интерфейса Protected Audience API для сбора данных отчёта о результатах аукциона объявлений.

Примечание: reportEvent() предоставляет аналогичную отправку данных отчёта, но в этом случае отправка выполняется через явный вызов метода, а не при навигации.

Синтаксис

setReportEventDataForAutomaticBeacons(event)

Параметры

event

объект, представляющий данные для отправки. Возможные свойства:

eventType

строка, представляющая тип события, который сообщается. Доступные значения:

reserved.top_navigation_start: событие, срабатывающее при начале навигации верхнего уровня.
reserved.top_navigation_commit: событие, срабатывающее при завершении навигации верхнего уровня.

eventData

строка, представляющая данные для отправки.

destination

массив, содержащий один или несколько перечисленных значений, представляющих типы пунктов назначения. Это вовлеченные стороны, которые получат данные на свои зарегистрированные URL-адреса (т.е. через registerAdBeacon()). Доступные значения:

"buyer": участник торгов в аукционе объявлений.
"seller": продавец верхнего уровня, проводящий аукцион объявлений.
"component-seller": продавец компонента в многоуровневом аукционе.
"direct-seller": продавец, который непосредственно провёл аукцион, в котором покупатель участвовал. Если аукцион объявлений был одноуровневым, используется значение "seller". Если аукцион был многоуровневым, используется значение "component-seller".
"shared-storage-select-url": место хранения API Shared Storage, как определено в вызове метода Window.sharedStorage.selectURL().

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

логическое значение. Если установлено в true, автоматический маяк будет отправлен только для следующего события, и маяки не будут отправляться для последующих событий, пока setReportEventDataForAutomaticBeacons() не будет вызван снова. Например, при использовании с обработчиком click, это можно использовать для отправки данных маяка только для определённых навигаций верхнего уровня, а не для каждой навигации верхнего уровня. По умолчанию это значение false.

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

Ничего (Undefined).

Примеры

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: "reserved.top_navigation_start",
  eventData: "an example string",
  destination: ["seller", "buyer"],
});

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

Спецификация
Fenced Frame # dom-fence-setreporteventdataforautomaticbeacons

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setReportEventDataForAutomaticBeacons`	115	115	Нет	101	Нет	115	Нет	77	Нет	23.0	115
`start_commit_eventType`	120 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	120 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	Нет	106 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	Нет	120 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	Нет	80 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	Нет	25.0 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.	120 Ранее был доступен только один `eventType`, `reserved.top_navigation`, но он был заменён новыми значениями.

См. также

Фреймы с ограниченным доступом на developers.google.com
Проект Privacy Sandbox на developers.google.com

© 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/Fence/setReportEventDataForAutomaticBeacons