HTMLAnchorElement: attributionSrc-Eigenschaft
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, bevor Sie diese produktiv verwenden.
Die attributionSrc
-Eigenschaft des HTMLAnchorElement
-Interfaces ruft das attributionsrc
-Attribut eines <a>
-Elements ab und setzt dieses programmatisch, wodurch der Wert dieses Attributs widergespiegelt wird. attributionsrc
gibt an, dass Sie möchten, dass der Browser einen Attribution-Reporting-Eligible
-Header sendet. Serverseitig 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
-Antwortheader bereitgestellt), wenn er die Navigationsantwort erhält.
Weitere Details finden Sie in der Attribution Reporting API.
Note:
<a>
-Elemente können nicht als Attributionstrigger verwendet werden, nur als Quellen.
Wert
Ein String. Es gibt zwei Versionen dieser Eigenschaft, die Sie erhalten und setzen können:
-
Leerer String, d.h.
aElem.attributionSrc=""
. Dies gibt an, dass derAttribution-Reporting-Eligible
-Header an denselben Server gesendet werden soll, auf den dashref
-Attribut verweist. 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 in Fällen, in denen die angeforderte Ressource sich nicht auf einem Server befindet, den Sie kontrollieren, oder Sie die Registrierung der Attributionsquelle auf einem anderen Server handhaben möchten. In diesem Fall können Sie eine oder mehrere URLs als Wert von
attributionSrc
angeben. Wenn die Ressourcenanforderung auftritt, wird derAttribution-Reporting-Eligible
-Header sowohl an die inattributionSrc
angegebenen URLs als auch an den Ursprungsort der Ressource gesendet. Diese URLs können dann mit einemAttribution-Reporting-Register-Source
-Header antworten, um die Quelle zu registrieren.Hinweis: Die Angabe mehrerer URLs bedeutet, dass mehrere Attributionsquellen auf derselben Funktion registriert werden können. Sie könnten beispielsweise verschiedene Kampagnen haben, deren Erfolg Sie messen möchten, was das Erstellen unterschiedlicher Berichte über unterschiedliche Daten umfasst.
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, die URLs enthält
<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 |
Browser-Kompatibilität
BCD tables only load in the browser