カスタム レポート期間

カスタム レポート期間では、イベントレベル レポートが高速化され、集計可能レポートに選択したレポートが表示されます。

Attribution Reporting(Chrome 110 で提供)のカスタム レポート期間を使用すると、特定の期間の後に発生したコンバージョンを除外するようにブラウザを指定できます。

  • イベントレベルのレポートでは、レポート期間を設定すると、特定の期間の後に発生したコンバージョンを除外できるほか、レポートをより迅速に取得できます。目標によっては、トレードオフの見方もあります。レポート期間を使用すると、レポートへのアクセスは速くなりますが、一部のコンバージョンが失われる可能性があります。詳しくは、イベントレベルのセクションをご覧ください。
  • 集計可能レポートでは、レポート期間を使用して、特定の期間の後に発生したコンバージョンをフィルタできます。詳しくは、集計可能セクションをご覧ください。

カスタム レポート ウィンドウとは

カスタム レポート期間とは、ソースの登録後、このソースについて対応するタイプ(イベントまたは集計可能)のレポートを作成できる期間です。

イベントレベル レポートの場合、レポート ウィンドウは、対応するタイプのレポートが送信される最後の期間にもなります。

レポート期間に関する重要なポイント:

  • report_window が設定されていない場合は、expiry にフォールバックします。
  • expiry が設定されていない場合は、デフォルトの 30 日にフォールバックします。
  • カスタム レポートの最小期間は 1 日です。時間枠を 1 日未満に設定しても、値は 1 日内に収められます。イベントレベル レポートの例をご確認ください。
  • レポート期間は秒単位で定義されます。

なお、expiry の仕組みは変わりません。expiry は、アトリビューションの対象となるインプレッションまたはクリックを変更します。

イベントレベルのレポート: 迅速なレポート作成と部分的なレポート

デフォルトでは、イベントレベルのレポートは、組み込みのレポート ウィンドウのスケジュールに従って送信されます(クリック用に 3 つのウィンドウ、ビュー用に 1 つのウィンドウ)。

イベントレベル レポートでは、カスタム レポート ウィンドウで次のことができます。

  • レポートをすばやく入手できます。特に、カスタム レポート期間を使用すると、Chrome 110 より前の組み込み有効期限の 2 日間ではなく、クリックまたはインプレッションの 1 日後にレポートを取得できます。
  • 特定の期間の後に発生したコンバージョンを除外します。

イベントレベル レポートでレポート期間を使用するには、Attribution-Reporting-Register-Source ソース登録ヘッダーに event_report_window フィールドを追加します。

イベントレベル レポートは、遅くともレポート期間に達した直後に送信されるようにスケジュール設定されています。

イベントレベル レポート(クリック)のスケジュール例

有効期限 event_report_window クリックから 1 日後にコンバージョンが発生した場合、ブラウザは次のレポートを送信します。 発生したコンバージョンをフィルタで除外(未送信)したレポート:
デフォルト(30 日) (未設定) 約 2 日とクリックから 1 時間
デフォルトのレポート動作 - 組み込みウィンドウ #1
クリックから約 30 日間
カスタム、5 日に設定 (未設定) 約 2 日とクリックから 1 時間
デフォルトのレポート動作 - 組み込みウィンドウ #1
クリックから 5 日を超えている
デフォルト(30 日) 1 日に設定 クリックから約 1 日と 1 時間後

カスタム レポート ウィンドウによるカスタム動作。この方法では、最初の組み込み期間(2 日間)を待つ必要があるため、最初の行よりもこのレポートが早く取得されます。
クリックから 1 日以上後
カスタム、5 日に設定 1 日に設定 クリックから約 1 日と 1 時間後

カスタム レポート ウィンドウによるカスタム動作
クリックから 1 日以上後
デフォルト(30 日) 4 時間に設定 クリックから約 1 日と 1 時間後
カスタム レポート ウィンドウによるカスタム動作。これはクランプによるものです。最小レポート対象期間は 1 日です。レポート期間を 1 日未満(4 時間など)に設定しても、値は 1 日内に収められます。
クリックから 1 日以上後

イベントレベルのレポートやビューのスケジュール設定の例

有効期限 event_report_window クリックから 1 日後にコンバージョンが発生した場合、ブラウザは次のレポートを送信します。
デフォルト(30 日) (未設定) 約 30 日と視聴後 1 時間
レポートのデフォルトの動作
カスタム、5 日に設定 (未設定) 約 5 日間と視聴してから 1 時間
レポートのデフォルトの動作
デフォルト(30 日) 1 日に設定 約 1 日と視聴後 1 時間
カスタム レポート ウィンドウによるカスタム動作
カスタム、5 日に設定 1 日に設定 約 1 日と視聴後 1 時間
カスタム レポート ウィンドウによるカスタム動作

集計可能レポート: 部分的なレポート

集計可能レポートの場合、レポート期間のメリットは、特定の期間の後に発生したコンバージョンのみを除外することです。レポートをより早く取得するメリットはありません。

集計可能レポートにレポート期間を使用するには、Attribution-Reporting-Register-Source ソース登録ヘッダーに aggregatable_report_window フィールドを追加します。

これにより、特定の期間以降に発生するコンバージョンは除外されます。

集計可能レポートは、トリガーから 1 時間以内に送信されます。10 分から 1 時間の間にランダムに遅延します。

有効期限 aggregatable_report_window 発生したコンバージョンをフィルタで除外(未送信)したレポート:
デフォルト(30 日) (未設定) クリックまたは表示から 30 日を超えている
カスタム、5 日に設定 (未設定) クリックまたは表示から 5 日を超えている
デフォルト(30 日) 1 日に設定 クリックまたは表示から 1 日以上後
カスタム、5 日に設定 1 日に設定 クリックまたは表示から 1 日以上後
デフォルト(30 日) 4 時間に設定 クリックまたは表示から 1 日以上経過している。これはクランプによるものです。最小レポート対象期間は 1 日です。レポート期間を 1 日未満(4 時間など)に設定しても、値は 1 日内に収められます。

フィードバックを共有

この API に参加して試すことができます。