HTMLScriptElement: attributionSrc-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die attributionSrc-Eigenschaft der HTMLScriptElement-Schnittstelle liest und setzt das attributionsrc-Attribut eines <script>-Elements programmatisch und reflektiert den Wert dieses Attributs. attributionsrc gibt an, dass Sie möchten, dass der Browser einen Attribution-Reporting-Eligible-Header zusammen mit der Skriptquellenanfrage sendet.

Serverseitig wird dies verwendet, um das Senden eines Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Headers in der Antwort auszulösen, um eine auf JavaScript basierende Attributionsquelle bzw. einen Attribution-Trigger zu registrieren. Welcher Antwort-Header zurückgesendet werden sollte, hängt vom Wert des Attribution-Reporting-Eligible-Headers ab, der die Registrierung ausgelöst hat.

Hinweis: Alternativ können JavaScript-basierte Attributionsquellen oder Trigger registriert werden, indem eine fetch()-Anfrage gesendet wird, die die attributionReporting-Option enthält (entweder direkt im fetch()-Aufruf oder auf einem Request-Objekt, das in den fetch()-Aufruf übergeben wird), oder indem eine XMLHttpRequest mit setAttributionReporting() aufgerufen wird.

Weitere Details finden Sie in der Attribution Reporting API.

Wert

Ein String. Es gibt zwei Versionen dieser Eigenschaft, die Sie abrufen und setzen können:

Ein leerer String, d.h. scriptElem.attributionSrc="". Dies gibt an, dass Sie möchten, dass der Attribution-Reporting-Eligible-Header an denselben Server gesendet wird, auf den das src-Attribut verweist. Das ist in Ordnung, wenn Sie die Attributionsquellen- oder Triggerregistrierung auf demselben Server bearbeiten. Bei der Registrierung eines Attribution-Triggers ist diese Eigenschaft optional, und es wird ein leerer String verwendet, wenn sie ausgelassen wird.
Ein Wert, der eine oder mehrere URLs enthält, zum Beispiel:
js
```
scriptElem.attributionSrc =
  "https://a.example/register-source https://b.example/register-source";
```
Dies ist nützlich in Fällen, in denen die angeforderte Ressource nicht auf einem Server liegt, den Sie kontrollieren, oder wenn Sie die Registrierung der Attributionsquelle auf einem anderen Server verwalten möchten. In diesem Fall können Sie eine oder mehrere URLs als Wert von attributionSrc angeben. Wenn die Ressourcenanforderung erfolgt, wird der Attribution-Reporting-Eligible-Header an die in attributionSrc angegebene(n) URL(s) gesendet, zusätzlich zum Herkunftsserver der Ressource. Diese URLs können dann mit einem Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Header entsprechend antworten, um die Registrierung abzuschließen.

Hinweis: Die Angabe mehrerer URLs bedeutet, dass mehrere Attributionsquellen auf demselben Merkmal registriert werden können. Zum Beispiel könnten Sie unterschiedliche Kampagnen haben, deren Erfolg Sie messen möchten, was die Erstellung unterschiedlicher Berichte auf unterschiedlichen Daten beinhaltet.

Beispiele

Festlegen eines leeren attributionSrc

html

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

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

Festlegen eines attributionSrc mit URLs

html

<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}`;

Spezifikationen

Specification
Attribution Reporting # dom-htmlattributionsrcelementutils-attributionsrc

Browser-Kompatibilität

Siehe auch

Attribution Reporting API.