HTMLAnchorElement: attributionSrc-Eigenschaft
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the attribution reporting API.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die attributionSrc-Eigenschaft der HTMLAnchorElement-Schnittstelle holt und setzt das attributionsrc-Attribut auf einem <a>-Element programmatisch und spiegelt den Wert dieses Attributs wider. 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 mit der navigationsbasierten Attributionsquelle verbundenen Quelldaten (wie im Attribution-Reporting-Register-Source-Antwortheader bereitgestellt), wenn er die Navigationsantwort erhält.
Weitere Details finden Sie in der Attribution Reporting API.
Hinweis:
<a>-Elemente können nicht als Attributionstrigger, 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 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 nicht auf einem von Ihnen kontrollierten Server liegt oder Sie einfach 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 Origin der Ressource an die imattributionSrcangegebenen URLs gesendet. Diese URLs können dann mit einemAttribution-Reporting-Register-Sourceantworten, um die Quelle zu registrieren.Hinweis: Das Angeben mehrerer URLs bedeutet, dass mehrere Attributionsquellen auf derselben Funktion registriert werden können. Sie könnten beispielsweise unterschiedliche Kampagnen haben, deren Erfolg Sie messen möchten und die unterschiedliche Berichte zu unterschiedlichen Daten generieren.
Beispiele
Setzen eines leeren attributionSrc
<a href="https://shop.example"> Click to visit our shop </a>
const aElem = document.querySelector("a");
aElem.attributionSrc = "";
Setzen eines 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}`;