HTMLAnchorElement: attributionSrc プロパティ

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

attributionSrc はHTMLAnchorElement インターフェイスのプロパティで、<a> 要素のattributionsrc 属性をプログラムから取得および設定ます。attributionsrc は、ブラウザーにAttribution-Reporting-Eligible ヘッダーを送信するように指定します。サーバー側では、レスポンスでAttribution-Reporting-Register-Source ヘッダーを送信し、ナビゲーションベースの帰属元を登録するために使用されます。

ブラウザーは、ナビゲーションレスポンスを受信すると、ナビゲーションベースの帰属ソース（Attribution-Reporting-Register-Source レスポンスヘッダーで指定されたもの）に関連付けられたソースデータを格納します。

詳細は、帰属レポート API を参照してください。

メモ:<a> 要素は帰属のトリガーとして使用することはできず、ソースのみです。

値

文字列です。このプロパティには、取得や設定ができる 2 つのバージョンがあります。

空文字列、すなわちaElem.attributionSrc="" です。これは、href 属性が指し示すのと同じサーバーにAttribution-Reporting-Eligible ヘッダーが送信されることを指定します。この点は、帰属元の登録を同じサーバーで処理する場合は問題ありません。
1 つ以上の URL を含む値、例えば次のようなものです。
js
```
aElem.attributionSrc =  "https://a.example/register-source https://b.example/register-source";
```
これは、リクエストされたリソースが管理下のサーバーにない場合や、別のサーバーでの帰属元の登録を処理したい場合に便利です。この場合、attributionSrc の値として 1 つ以上の URL を指定することができます。リソースへのリクエストが発生すると、リソースのオリジンに加えて、attributionSrcで指定された URL にAttribution-Reporting-Eligible ヘッダーが送信されます。これらの URL は、ソースを登録するためにAttribution-Reporting-Register-Source で応答することができます。
メモ:複数の URL を指定するということは、同じ機能に複数の帰属ソースを登録できるということになります。例えば、成功を測定しようとしているさまざまなキャンペーンが、異なるデータに関する異なるレポートの生成に関与している場合、異なるキャンペーンを行うことができます。

例

空の attributionSrc の設定

html

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

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

URL を格納するアトリビューション Src を設定するには

html

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