このページは Cloud Translation API によって翻訳されました。

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

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

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

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

登録方法

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

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

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

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

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

トリガーの登録を開始します。ピクセルまたは fetch() 呼び出しを使用して以下を行います。できます。
トリガーで応答してトリガーの登録を完了する 登録ヘッダーです。

ピクセルリクエストの受信時に、通常の 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
  }
}
```

で確認できます。

注: ブラウザが、あるページの attributionsrc URL からアトリビューショントリガーのレスポンスを受け取ると、ローカルストレージルックアップが行われ、そのページが属する attributionsrc のオリジンとリンク先のサイトに一致するソースが検索されます。複数のソースが見つかった場合、ブラウザは最後に格納されたソースを選択します。ただし、ソースの優先度が異なる場合、ブラウザは最も優先度の高いソースを選択します。

サブドメインを扱う

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>

スクリプトタグの使用

スクリプトタグを使用してトリガーの登録を実行できます。<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();

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

注意: ブラウザは JSON 配列を想定しているため、event_trigger_data フィールドの値は角かっこで囲む必要があります。これはフィルタに役立ちます。

次のステップ

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