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.

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die attributionSrc-Eigenschaft der HTMLScriptElement-Schnittstelle liest und setzt das attributionsrc-Attribut an einem <script>-Element programmatisch und spiegelt dessen Wert wider. attributionsrc gibt an, dass Sie möchten, dass der Browser einen Attribution-Reporting-Eligible-Header zusammen mit der Skriptressourcenanfrage sendet.

Auf Serverseite wird dies verwendet, um das Senden eines Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Headers in der Antwort auszulösen, um eine JavaScript-basierte Attributionsquelle oder einen Attributionstrigger 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 Option attributionReporting enthält (entweder direkt in dem fetch()-Aufruf oder in einem Request-Objekt, das in den fetch()-Aufruf übergeben wird), oder indem ein XMLHttpRequest gesendet wird, mit setAttributionReporting(), das auf dem Anforderungsobjekt aufgerufen wird.

Weitere Einzelheiten finden Sie in der Attribution Reporting API.

Wert

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

Leerzeichen, d.h. scriptElem.attributionSrc="". Dies gibt an, dass der Attribution-Reporting-Eligible-Header an denselben Server gesendet werden soll, auf den das src-Attribut zeigt. Dies ist in Ordnung, wenn Sie die Registrierung der Attributionsquelle oder des Triggers auf demselben Server durchführen. Bei der Registrierung eines Attributionstriggers ist diese Eigenschaft optional und ein leerer Zeichenfolgenwert wird verwendet, wenn sie weggelassen wird.
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 einfach die Registrierung der Attributionsquelle auf einem anderen Server durchführen möchten. In diesem Fall können Sie einen oder mehrere URLs als Wert für attributionSrc angeben. Wenn die Ressourcenanforderung auftritt, wird der Attribution-Reporting-Eligible-Header an die im attributionSrc angegebenen URL(s) zusätzlich zur Ursprungsressource gesendet. Diese URLs können dann mit einem geeigneten Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Header antworten, um die Registrierung abzuschließen.

Hinweis: Das Angeben mehrerer URLs bedeutet, dass mehrere Attributionsquellen für dasselbe Feature registriert werden können. Sie haben möglicherweise zum Beispiel verschiedene Kampagnen, deren Erfolg Sie messen möchten, die das Generieren unterschiedlicher Berichte zu verschiedenen Daten beinhalten.

Beispiele

Setzen eines leeren attributionSrc

html

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

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

Setzen eines attributionSrc, das URLs enthält

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.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden