HTMLImageElement: свойство attributionSrc

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

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

Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

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

Свойство attributionSrc интерфейса HTMLImageElement получает и устанавливает атрибут attributionsrc элемента <img> программно, отражая значение этого атрибута. attributionsrc указывает, что вы хотите, чтобы браузер отправил заголовок Attribution-Reporting-Eligible вместе с запросом на изображение.

На стороне сервера это используется для запуска отправки заголовка Attribution-Reporting-Register-Source или Attribution-Reporting-Register-Trigger в ответе, чтобы зарегистрировать источник атрибуции или триггер атрибуции на основе изображения соответственно. Какой заголовок ответа должен быть отправлен, зависит от значения заголовка Attribution-Reporting-Eligible, который инициировал регистрацию.

Источник/триггер регистрируется после того, как браузер получит ответ, содержащий файл изображения.

Примечание: Помните, что пользователи могут вообще не видеть изображение — это может быть 1x1 прозрачный отслеживающий пиксель, используемый только для отчётов об атрибуции.

Более подробную информацию см. в разделе API отчётов об атрибуции.

Значение

Строка. Есть два варианта этого свойства, которые можно получить и установить:

Пустая строка, т.е. imgElem.attributionSrc="". Это указывает на то, что вы хотите, чтобы заголовок Attribution-Reporting-Eligible был отправлен на тот же сервер, что и атрибут src. Это нормально, когда вы обрабатываете регистрацию источника или триггера атрибуции на одном и том же сервере. При регистрации триггера атрибуции это свойство необязательно, и в случае пропуска будет использовано значение пустой строки.
Значение, содержащее один или несколько URL-адресов, например:
```
imgElem.attributionSrc =
  "https://a.example/register-source https://b.example/register-source";
```
Это полезно в случаях, когда запрашиваемый ресурс не находится на сервере, которым вы управляете, или вы просто хотите обработать регистрацию источника атрибуции на другом сервере. В этом случае вы можете указать один или несколько URL-адресов в качестве значения attributionSrc. При запросе ресурса заголовок Attribution-Reporting-Eligible будет отправлен на указанный(ые) URL-адрес(ы) в attributionSrc в дополнение к источнику ресурса. Затем эти URL-адреса могут ответить заголовком Attribution-Reporting-Register-Source или Attribution-Reporting-Register-Trigger для завершения регистрации.

Примечание: Указание нескольких URL-адресов означает, что можно зарегистрировать несколько источников атрибуции для одной функции. Например, у вас могут быть разные кампании, эффективность которых вы пытаетесь измерить, что подразумевает создание различных отчётов по разным данным.

Примеры

Установка пустого attributionSrc

<img src="advertising-image.png" />

const imgElem = document.querySelector("img");
imgElem.attributionSrc = "";

Установка attributionSrc, содержащего URL-адреса

<img src="advertising-image.png" />

// encode the URLs in case they contain special characters
// such as '=' that would be improperly parsed.
const encodedUrlA = encodeURIComponent("https://a.example/register-source");
const encodedUrlB = encodeURIComponent("https://b.example/register-source");

const imgElem = document.querySelector("img");
imgElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;

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

Спецификация
Отчёт об атрибуции # dom-htmlattributionsrcelementutils-attributionsrc

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari для iOS	Samsung Internet	WebView для Android
`attributionSrc`	125	125	Нет	111	Нет	125	Нет	83	Нет	27.0	125

См. также

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/HTMLImageElement/attributionSrc