HTMLAnchorElement: свойство attributionSrc

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

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

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

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

Свойство attributionSrc интерфейса HTMLAnchorElement получает и устанавливает атрибут attributionsrc для элемента <a> программно, отражая значение этого атрибута. attributionsrc указывает, что вы хотите, чтобы браузер отправлял заголовок Attribution-Reporting-Eligible. На стороне сервера это используется для запуска отправки заголовка Attribution-Reporting-Register-Source в ответе, для регистрации источника атрибуции на основе навигации.

Браузер хранит данные источника, связанные с источником атрибуции на основе навигации (как указано в заголовке ответа Attribution-Reporting-Register-Source), при получении ответа на навигацию.

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

Примечание: <a> элементы нельзя использовать в качестве триггеров атрибуции, только в качестве источников.

Значение

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

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

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

Примеры

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

<a href="https://shop.example"> Click to visit our shop </a>

const aElem = document.querySelector("a");
aElem.attributionSrc = "";

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

<a href="https://ourshop.example"> Click to visit our shop </a>

// 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 aElem = document.querySelector("a");
aElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;

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

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

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

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for 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/HTMLAnchorElement/attributionSrc