HTMLScriptElement: свойство attributionSrc

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

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

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

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

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

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

Примечание: В качестве альтернативы, JavaScript-источники или триггеры атрибуции могут быть зарегистрированы путём отправки запроса fetch() содержащего опцию attributionReporting (либо установленную непосредственно в вызове fetch(), либо в объекте Request, переданном в вызов fetch()), или путём отправки объекта XMLHttpRequest с вызовом setAttributionReporting() на объекте запроса.

Дополнительную информацию см. в разделе API отслеживания атрибуции.

Значение

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

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

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

Примеры

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

<script src="advertising-script.js"></script>

const scriptElem = document.querySelector("script");
scriptElem.attributionSrc = "";

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

<script src="advertising-script.js"></script>

// 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 scriptElem = document.querySelector("script");
scriptElem.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/HTMLScriptElement/attributionSrc