Метод Fence: reportEvent()

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

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

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

Метод reportEvent() интерфейса Fence инициирует отправку данных отчета через маяк по одному или нескольким конкретным URL-адресам, зарегистрированным с помощью метода registerAdBeacon() API защищенной аудитории, с целью сбора результатов аукциона по рекламе.

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

Синтаксис

reportEvent(event)

Параметры

event

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

Значение объекта определяет конкретное событие отчета, которое вы хотите отправить. Требуемые свойства следующие:
eventType

Строка, представляющая тип события, о котором сообщается, например, количество кликов по объявлению. Эта строка может быть любым релевантным именем события (например, click). Оно должно совпадать с типом события, указанным в соответствующем вызове registerAdBeacon() в работе API защищенной аудитории.

eventData

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

destination
Массив, содержащий один или несколько перечисленных значений, представляющих типы назначения. Это заинтересованные стороны, которые получат данные по своим зарегистрированным URL-адресам (т.е. через registerAdBeacon()). Возможные значения:
- "buyer": Предложение на аукционе по рекламе.
- "seller": Продавец верхнего уровня, проводящий аукцион по рекламе.
- "component-seller": Продавец компонента на аукционе с несколькими уровнями.
- "direct-seller": Продавец, который непосредственно провел аукцион, на котором покупатель сделал ставку. Если аукцион был одноуровневым, используемое значение будет "seller". Если аукцион был многоуровневым, используемое значение будет "component-seller".
- "shared-storage-select-url": Место хранения API хранилища общего доступа, как определено в вызове метода Window.sharedStorage.selectURL().
Значение строки представляет eventType, например "click" (см. предыдущее определение eventType). Когда строка eventType передается в качестве значения reportEvent(), она инициирует отправку всех вкладов Private Aggregation, которые были обусловлены этим типом события (например, через PrivateAggregation.contributeToHistogramOnEvent()).

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

Ничего (Undefined).

Примеры

window.fence.reportEvent({
  eventType: "click",
  eventData: JSON.stringify({ clickX: "123", clickY: "456" }),
  destination: ["buyer", "seller"],
});

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

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

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

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

См. также

Ограниченные фреймы на developers.google.com
Платформа конфиденциальности на 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/reportEvent