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

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

サンプルコード prioritize conversions of type checkout を確認します。

次のステップ

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