フィルタされた行の概要

エンドユーザーのプライバシー保護のために十分にデータが集計されていない行や、Ads Data Hub のその他のプライバシー チェックをクリアしていない行は、クエリの結果から除外されます。分析クエリのフィルタされた行の概要で、フィルタされた行の定数と総計を含む単一の行を返すよう設定することができます。これにより、合計インプレッション数や合計クリック数などの合計データに差異が生じるのを防ぎやすくなります。UI で作成された新しい分析クエリでは、フィルタされた行の概要がデフォルトで有効になります。フィルタされた行の概要は、オーディエンス クエリには適用されません。API を介して作成されたクエリでは、フィルタされた行の概要はデフォルトでは有効になっていません。

下記の例では、キャンペーン 124 と 125 を含む行がユーザー数 50 人の集計要件を満たしていないため、フィルタされます。

キャンペーン ID ユーザー数
123 400
124 45
125 6

ただし、フィルタされた行の概要を使用すると、フィルタされたデータを結合してユーザー数 50 人の集計要件を満たすこともできます。以下の例では、総計を使用してフィルタされたデータを集計し、定数を使用して行にラベルを付けています。

  • 総計によって、Users 列のフィルタされたデータを集計。
  • 定数(フィルタされた行の概要のラベル付けに使用)。Campaign ID 列で「フィルタされた行の概要」に設定。
キャンペーン ID ユーザー数
フィルタされた行の概要 51
123 400

自動モード

Ads Data Hub のデフォルトでは、UI を介して作成された新しいクエリの場合、フィルタされた行の概要が自動的に有効になります。クエリを編集すると、Ads Data Hub によって、選択した列を基に設定が自動的に調整されます。

  • 自動的に指定された設定を表示するには、[プロパティ] > [フィルタされた行の概要] に移動します。この設定は読み取り専用です。
  • 自動モードを無効にするには、[自動] 切り替えボタンをクリックします。現在の設定が保持され、自動モードは無効になります。
  • 自動モードを有効にするには、[自動] 切り替えボタンをクリックします。表示された [自動に切り替えますか?] というダイアログで、[リセットする] をクリックします。現在の設定が削除され、自動モードが有効になります。
  • API を使用して自動モードを切り替えるには、generateFilteredRowSummaryAutomatically を使用します。

手動モード

フィルタした行の概要を、保存したクエリに手動で追加する、または自動モードを無効にした後に手動で追加する手順は次のとおりです。

  1. 集計する列を確認します。
  2. クエリのエディタの右側にある [プロパティ] > [フィルタされた行の概要] で、[ルールを追加] をクリックします。
  3. [列名] フィールドに集計する列の名前を入力します。
  4. [タイプ] プルダウン メニューから [合計] を選択します。総計が集計のしきい値を下回っている場合は、フィルタされた行の概要は除外されます。
  5. 省略可: 前の手順と同じようにルールを追加できます。
  6. 省略可: 定数を使用してフィルタされた行の概要の ID を追加できます。定数は、選択した行の有効なデータ型にする必要があります。
    1. [列名] フィールドに列の名前を入力します。
    2. [タイプ] プルダウン メニューから [定数] を選択します。
    3. [定数を指定する] フィールドに行の ID を入力します。
  • ルールを削除するには、[削除] をクリックします。
  • すべてのルールを削除するには、[すべて削除] をクリックします。

複数のテーブルのエクスポートで説明した SQL 構文を使用して、複数のテーブルをエクスポートする場合は、列のオプションにフィルタされた行の概要を追加できます。


CREATE TABLE `myproject.mydataset.mytable` (
    campaign_id INT64 OPTIONS(merge_constant=0),
    ct INT64 OPTIONS(merge_type="SUM")
  ) 
OPTIONS(privacy_checked_export=true) AS
SELECT campaign_id, COUNT(*) AS ct GROUP BY campaign_id;

これにより、フィルタされた行の概要を含む結果テーブルが生成されます。ここで campaign_id0ct はプライバシー チェックによって結果から除外された行の総数です。

現在、フィルタされた行の概要で使用可能な列オプションは次のとおりです。

  • merge_type="SUM": 概要の行でフィルタされた値の合計を出力します。数値型でのみ有効です。
  • merge_constant=<value>: 概要の行に定数値を設定します。列と同じ型にする必要があります。
  • オプションが指定されていない列は、概要の行が NULL になります。

merge_type または merge_constant のいずれか 1 つのみを指定できます。フィルタされた行の概要に関するルールもここに適用されます(つまり、合計が集計のしきい値を下回った場合、フィルタされた行の概要は除外されます)。