フィルタされた行の概要

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

重要なポイント: レポートを実行する際は、差分チェックではなくノイズを使用することをおすすめします。ノイズを使用する場合、差分チェックにより行がフィルタされないため、フィルタされた行の概要は不要です。詳細については、ノイズ注入をご覧ください。

重要: 集計要件は、フィルタされた行の概要の列にも適用されます。フィルタされた行の概要に含まれるユーザー数が 50 人未満、または行数が 2 行未満の場合、フィルタされた行の概要自体が除外されます。ただし、フィルタされた行の概要が除外されたことを警告するメッセージがジョブ ステータスの概要に表示されます。

例

次の例では、キャンペーン 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 を入力します。
7. ルールを削除するには、[削除] をクリックします。
8. すべてのルールを削除するには、[すべて削除] をクリックします。

複数のテーブルを使用する手動モード

自動モードを使用することをおすすめします。複数のテーブルのエクスポートで説明した 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_id は 0、ct はプライバシー チェックによって結果から除外された行の総数です。

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

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

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