HTMLImageElement: 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 HTMLImageElement
-Interfaces ruft das attributionsrc
-Attribut eines <img>
-Elements ab und setzt es programmatisch, wodurch der Wert dieses Attributs widergespiegelt wird. attributionsrc
gibt an, dass Sie möchten, dass der Browser einen Attribution-Reporting-Eligible
-Header zusammen mit der Bildanforderung 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 bildbasierte Attributionsquelle oder Attributionstrigger entsprechend zu registrieren. Welcher Antwortheader zurückgesendet werden soll, hängt vom Wert des Headers Attribution-Reporting-Eligible
ab, der die Registrierung ausgelöst hat.
Die Quelle/der Trigger wird registriert, sobald der Browser die Antwort mit der Bilddatei erhält.
Hinweis: Beachten Sie, dass Benutzer das Bild möglicherweise überhaupt nicht wahrnehmen können — es könnte sich um ein 1x1 transparentes Tracking-Pixel handeln, das nur für die Attribution-Berichterstattung verwendet wird.
Siehe die Attribution Reporting API für weitere Details.
Wert
Ein String. Es gibt zwei Versionen dieser Eigenschaft, die Sie abrufen und festlegen können:
-
Ein leerer String, also
imgElem.attributionSrc=""
. Dies gibt an, dass Sie möchten, dass derAttribution-Reporting-Eligible
-Header an denselben Server gesendet wird, auf den dassrc
-Attribut verweist. Dies ist in Ordnung, wenn Sie die Registrierung der Attributionsquelle oder des Triggers auf demselben Server steuern. Bei der Registrierung eines Attributionstriggers ist diese Eigenschaft optional, und ein leerer String wird verwendet, wenn sie weggelassen wird. -
Ein Wert, der eine oder mehrere URLs enthält, zum Beispiel:
jsimgElem.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 von Ihnen kontrollierten Server befindet oder Sie die Registrierung der Attributionsquelle auf einem anderen Server steuern möchten. In diesem Fall können Sie eine oder mehrere URLs als Wert von
attributionSrc
angeben. Wenn die Ressourcenanforderung erfolgt, wird derAttribution-Reporting-Eligible
-Header zusätzlich zur Ursprungs-URL der Ressource an die inattributionSrc
angegebenen URLs gesendet. Diese URLs können dann mit einemAttribution-Reporting-Register-Source
oderAttribution-Reporting-Register-Trigger
-Header als passend antworten, um die Registrierung abzuschließen.Hinweis: Die Angabe mehrerer URLs bedeutet, dass mehrere Attributionsquellen auf derselben Funktion registriert werden können. Beispielsweise könnten Sie verschiedene Kampagnen haben, deren Erfolg Sie messen möchten, indem Sie unterschiedliche Berichte zu unterschiedlichen Daten generieren.
Beispiele
Setzen eines leeren attributionSrc
<img src="advertising-image.png" />
const imgElem = document.querySelector("img");
imgElem.attributionSrc = "";
Setzen eines attributionSrc mit URLs
<img src="advertising-image.png" />
// 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 imgElem = document.querySelector("img");
imgElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
Spezifikationen
Specification |
---|
Attribution Reporting # dom-htmlattributionsrcelementutils-attributionsrc |
Browser-Kompatibilität
BCD tables only load in the browser