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

特定のソースまたはトリガーを優先するように 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 回目のコンバージョンまたは表示の 1 回目のコンバージョンの後に発生したコンバージョンはすべて破棄されます。

サンプルコードを確認する: 「購入手続き」タイプのコンバージョンを優先する

次のステップ

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