HTMLAnchorElement: 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 HTMLAnchorElement-Schnittstelle ruft das attributionsrc-Attribut auf einem <a>-Element ab und setzt es programmgesteuert, wodurch der Wert dieses Attributs widergespiegelt wird. attributionsrc gibt an, dass Sie möchten, dass der Browser einen Attribution-Reporting-Eligible-Header sendet. Auf der Serverseite wird dies verwendet, um das Senden eines Attribution-Reporting-Register-Source-Headers in der Antwort auszulösen, um eine navigationsbasierte Attributionsquelle zu registrieren.
Der Browser speichert die Quelldaten, die mit der navigationsbasierten Attributionsquelle verbunden sind (wie im Attribution-Reporting-Register-Source-Antwort-Header angegeben), wenn er die Navigationsantwort erhält.
Weitere Details finden Sie in der Attribution Reporting API.
Hinweis:
<a>-Elemente können nicht als Attributionsauslöser, sondern nur als Quellen verwendet werden.
Wert
Ein String. Es gibt zwei Versionen dieser Eigenschaft, die Sie abrufen und setzen können:
-
Leerer String, d.h.
aElem.attributionSrc="". Dies gibt an, dass Sie möchten, dass derAttribution-Reporting-Eligible-Header an denselben Server gesendet wird, auf den dashref-Attribut zeigt. Dies ist in Ordnung, wenn Sie die Registrierung der Attributionsquelle auf demselben Server abwickeln. -
Wert, der eine oder mehrere URLs enthält, zum Beispiel:
jsaElem.attributionSrc = "https://a.example/register-source https://b.example/register-source";Dies ist nützlich, wenn die angeforderte Ressource sich nicht auf einem Server befindet, den Sie kontrollieren, oder Sie die Registrierung der Attributionsquelle auf einem anderen Server abwickeln möchten. In diesem Fall können Sie eine oder mehrere URLs als Wert von
attributionSrcangeben. Wenn die Ressourcenanforderung erfolgt, wird derAttribution-Reporting-Eligible-Header zusätzlich zum Ressourcenursprung an die inattributionSrcangegebenen URL(s) gesendet. Diese URLs können dann mit einemAttribution-Reporting-Register-Sourceantworten, um die Quelle zu registrieren.Hinweis: Die Angabe mehrerer URLs bedeutet, dass mehrere Attributionsquellen für dieselbe Funktion registriert werden können. Sie könnten beispielsweise verschiedene Kampagnen haben, deren Erfolg Sie messen möchten und die die Erstellung verschiedener Berichte mit unterschiedlichen Daten umfassen.
Beispiele
Setzen einer leeren attributionSrc
<a href="https://shop.example"> Click to visit our shop </a>
const aElem = document.querySelector("a");
aElem.attributionSrc = "";
Setzen einer attributionSrc mit URLs
<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}`;
Spezifikationen
| Specification |
|---|
| Attribution Reporting # dom-htmlattributionsrcelementutils-attributionsrc |