カスタム レポート期間

カスタム レポート期間を使用すると、イベントレベル レポートをより速く提供したり、集計可能レポートの選択レポートを作成したりできます。

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

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

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

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

イベントレベル レポートの場合、レポート期間は、対応するタイプのレポートが送信される最後の期間としても機能します。

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

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

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

イベントレベルのレポート: レポートの迅速化と選択的なレポート作成

デフォルトでは、イベントレベル レポートは組み込みレポート期間のスケジュールに従って送信されます。クリックの場合は 3 つの期間、視聴の場合は 1 つの期間です。

イベントレベル レポートでは、カスタム レポート期間を使用して次のことができます。

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

イベントレベル レポートでレポート期間を使用するには、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 に参加して試すことができます。