アトリビューション トリガーを登録する

アトリビューション トリガーを登録してコンバージョンをカウントする方法をご覧ください。

アトリビューション トリガーは、コンバージョンを取得するようブラウザに指示するイベントです。

このドキュメントの手順に沿って操作すると、トリガーを登録して、ブラウザが関連するソースイベント（広告のインプレッションまたは広告クリック）に結び付けたコンバージョンを登録できます。

登録方法

トリガーを登録するには、HTML 要素または JavaScript 呼び出しを使用します。

  • <img> タグ
  • <script> タグ
  • fetch 個の電話番号
  • XMLHttpRequest

これにより、ネットワーク リクエストが生成され、トリガー登録の HTTP レスポンス ヘッダーで応答できます。

コンバージョンのアトリビューションを行うトリガーを登録する

トリガーの登録は、 アトリビューション ソース イベントの登録を行います。詳しい手順については、後で説明します。概要は次のとおりです。

  1. トリガーの登録を開始します。ピクセルまたは fetch() 呼び出しを使用して以下を行います。 できます。

  2. トリガーで応答してトリガーの登録を完了する 登録ヘッダーです。

    ピクセル リクエストの受信時に、 通常の src 属性で定義されたエンドポイント、または attributionsrc の使用を選択し、それを指定した場合: attributionsrc 値 - ヘッダー Attribution-Reporting-Register-Trigger で応答します。

    このヘッダーでは、表示するトリガーデータを指定します 最終的なレポートが作成されますすべてのレスポンスでこのヘッダーを設定できます。データ アナリストが destination に一致するサイトからのリクエストに対するレスポンス 照合されます。ヘッダーを受信すると、 一致するソースが検索され、レポートのスケジュールが設定されます。

    イベントレベル レポートの例:

    {
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}

    概要レポートの例:

    {
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}
で確認できます。

サブドメインを扱う

destination が https://advertiser.example の場合、両方のコンバージョン https://advertiser.example とそのサブドメイン（https://shop.advertiser.example など）は、アトリビューションの対象となります。

destination が https://shop.advertiser.example の場合、https://advertiser.example と https://shop.advertiser.example を関連付けることができます。

必須属性と省略可能な属性

HTML 要素を使用するか、JavaScript 呼び出しを行ってトリガーを登録すると、 attributionsrc の使用が必要になる場合があります または attributionReporting。これらがいつ適用されるかについては、次の表をご覧ください。 必要ありません。

attributionsrc が省略可の場合、使用すると、リクエストは Attribution Reporting の対象になることを示します。以下をご使用の場合: attributionsrc の場合、ブラウザは Attribution-Reporting-Eligible ヘッダー。また、アプリからウェブへの 測定: attributionsrc が存在する場合、ブラウザは Attribution-Reporting-Support ヘッダー。

登録方法 きっかけ
<a> タグ なし: アンカーはトリガーを登録できません。
<img> タグ attributionsrc は省略可です。ヘッダー トリガーを登録するにはこれで十分です
<script> タグ attributionsrc は省略可です。ヘッダー トリガーを登録するにはこれで十分です
fetch 個の電話番号 attributionReporting オプションは次のとおりです。 required。
XMLHttpRequest attributionReporting オプションは次のとおりです。 required。
window.open() 該当なし: window.open はトリガーを登録できません。

ステップ 1: トリガーの登録を開始する

トリガーは、ピクセル（<img> タグ）またはスクリプトタグを使用して登録できます。

新規または既存のコンバージョン ピクセルを使用する

次の例では、attributionsrc 属性を追加して、既存の画像のアトリビューションをトリガーします。

attributionsrc のオリジンは、ソースの登録を実施したオリジンと一致する必要があります。

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

次の例では、新しいコンバージョン ピクセル attributionsrc 属性を追加して、アトリビューションをトリガーします。

src のオリジンは、ソースの登録を実施したオリジンと一致する必要があります。

<img src="https://adtech.example/conversionpixel"
     attributionsrc>
<ph type="x-smartling-placeholder">

スクリプトタグの使用

スクリプトタグを使用してトリガーの登録を実行できます。<img> と同じように動作します。次のコードサンプルは、fetch() と XMLHttpRequest()（XHR）の使用方法を示しています。

このコードは、attributionsrc を使用した HTML リクエストの動作を効果的にシミュレートします。

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();
<ph type="x-smartling-placeholder">

attributionsrc（値あり / なし）

attributionsrc は、値の有無にかかわらず追加できます。

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

attributionsrc の値を設定する場合は、1 つ以上の URL をスペースで区切って指定できます。

URL を使用すると、ブラウザから別のキープアライブ取得リクエストが開始されます。 （Attribution-Reporting-Eligible リクエストを含む）ごとの URL できます。

これは、イベントにレスポンスを返してトリガーの登録を行う場合に便利です。 要素のメイン リクエストとは別のリクエストになります。

たとえば、画像要素でトリガーを登録する必要がある場合、 画像レスポンスを実際に制御できない場合があります。この場合は、 リクエストに対するレスポンスとしてトリガー登録ヘッダーを送信する構成 完全に制御できます。方法 attributionsrc に明示的な値を指定する場合、 追加のリクエストを行い、その宛先を設定します。

ステップ 2: ヘッダーで応答する

ブラウザ リクエストを受け取ったら、レスポンスに Attribution-Reporting-Register-Trigger ヘッダーを含めます。

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

次のステップ

詳しくは、アトリビューション ソースを登録する方法をご覧ください。