HTMLAnchorElement: attributionSrc 屬性

值

一個字串。此屬性有兩個版本可供獲取和設定。

• 空字串，即 aElem.attributionSrc=""。這指定您希望將 Attribution-Reporting-Eligible 標頭髮送到 href 屬性指向的同一伺服器。當您在同一伺服器上處理歸因來源註冊時，這是可以的。

• 包含一個或多個 URL 的值，例如

  js

  aElem.attributionSrc =
    "https://a.example/register-source https://b.example/register-source";
  

  這在所請求的資源不在您控制的伺服器上，或者您只想在不同的伺服器上處理歸因來源註冊的情況下很有用。在這種情況下，您可以將一個或多個 URL 指定為 attributionSrc 的值。當發生資源請求時，除了資源來源之外，Attribution-Reporting-Eligible 標頭還將傳送到 attributionSrc 中指定的 URL。這些 URL 然後可以響應 Attribution-Reporting-Register-Source 來註冊來源。

  注意：指定多個 URL 意味著可以在同一功能上註冊多個歸因源。例如，您可能正在嘗試衡量不同廣告系列的成功，這涉及生成關於不同資料的不同報告。

示例

設定空的 attributionSrc

<a href="https://shop.example"> Click to visit our shop </a>

const aElem = document.querySelector("a");
aElem.attributionSrc = "";

設定包含 URL 的 attributionSrc

<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}`;

規範

瀏覽器相容性

另見

• 歸因報告 API.