特定のクリック、ビュー、またはコンバージョンを優先する

特定のソースまたはトリガーを優先するように API を構成します。

イベントレベル レポートまたは集計可能レポートで特定のクリックまたはビューを優先する

ソースサイドの優先度を使用すると、Attribution Reporting API のデフォルトの動作を変更できます。デフォルトのアトリビューション モデルはラストタッチです。つまり、コンバージョンは、一致する最新の参照元イベントに割り当てられます。イベントレベル レポートと集計可能レポートの両方で、この動作を調整できます。

デフォルトの優先度を変更するには、ソース登録ヘッダーに priority キーを追加します。

優先するソースには優先度を高く設定します。値が大きいほど優先度が高くなります。たとえば、priority が 2 のソースイベントは、priority が 1 のソースよりも優先されます。

優先度が最も高いソースイベントに一致するレポートのみが送信されます。

コード例

アトリビューションを変更して、最近のソース（最初のクリック）を選択します。

const currentTimestamp = Date.now();
const priority = -currentTimestamp;

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // … all usual fields for that header
    priority: `${priority}`
  })
);

イベントレベルのレポートで特定のコンバージョンを優先する

ソースサイドの優先度とは異なり、トリガーサイドの優先度の設定はイベントレベル レポートでのみ可能です。

ユーザーが広告をクリックして、広告主のサイトのトップページにアクセスし、商品ページにアクセスしてニュースレターに登録し、最終的に購入してコンバージョンに至ったとします。

ただし、クリック数のレポートは 3 件までという制限があるため、デフォルトでは、登録（3 回目のコンバージョン）以降のレポート（購入レポートを含む）はすべて破棄されます。

代わりに、より重要と思われるコンバージョン（購入レポートなど）のレポートが届くように API を設定できます。

そのためには、トリガー登録ヘッダーに priority キーを追加し、優先度を高く設定したいコンバージョンに優先度を高く設定します。

特定のソースイベントでアトリビューションがトリガーされたときに、このソースのアトリビューションの最大数（クリックの場合は 3 回、視聴の場合は 1 回）に達している場合、ブラウザは次のように動作します。

• 新しいレポートの優先度を、同じソースの既存のスケジュール設定レポートの優先度と比較します。

• 優先度が最も低いレポートを削除して、代わりに新しいレポートをスケジュール設定します。新しい報告が優先度が最も低い報告である場合、その報告は無視され、報告は届きません。

優先度が設定されていない場合、ブラウザはデフォルトの動作にフォールバックします。つまり、クリックで 3 件目、表示で 1 件目のコンバージョンの後に発生したコンバージョンは破棄されます。

サンプルコードを確認する: checkout タイプのコンバージョンを優先する

次のステップ

ソースとトリガーの設定については、以下をご覧ください。

• アトリビューション ソースを登録する。
• アトリビューション トリガーを登録する。