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

特定のソースまたはトリガーを優先するように 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}`
  })
);

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

ソース側の優先度とは異なり、トリガー側の優先度はイベントレベル レポートでのみ使用できます。

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

ただし、クリックのレポート数には 3 つの上限があるため、登録（3 回目のコンバージョン）後の後続のレポート（購入レポートを含む）はすべてデフォルトで除外されます。

代わりに、より重要だと考えるコンバージョンのレポート（購入レポートなど）を受け取るように API を設定できます。

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

特定のソースイベントでアトリビューションがトリガーされたときに、そのソースのアトリビューションの最大数（クリックに 3 つ、ビューに 1 つ）に達すると、ブラウザは次の処理を行います。

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

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

優先値が設定されていない場合、ブラウザはデフォルトの動作にフォールバックします。つまり、クリックに関する 3 回目のコンバージョン、またはビューの初回のコンバージョンより後に発生したコンバージョンは除外されます。

コード例（checkout タイプのコンバージョンを優先する）を確認する

次のステップ

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