特定のソースまたはトリガーを優先するように 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 回目のコンバージョンの後に発生したコンバージョンはすべて破棄されます。
サンプルコードを確認する: 「購入手続き」タイプのコンバージョンを優先する
次のステップ
ソースとトリガーの設定については、以下をご覧ください。
- アトリビューション ソースを登録します。
- アトリビューション トリガーを登録します。