フィルタされた行の概要

エンドユーザーのプライバシー保護のために十分にデータが集計されていない行や、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. Ads Data Hub で [レポート] ページを開きます。
  2. 編集するレポートの名前をクリックします。
  3. [フィルタされた行の概要は自動的に生成されます] の横にある [編集 編集] をクリックします。
  4. [自動] をクリックしてオフにします。注: 自動モードを無効にすると、現在の構成が保持されます。必要に応じてこれらのルールを編集または削除します。
  5. 合計を使用して列を集計します。合計が集計のしきい値を下回っている場合は、フィルタされた行の概要は除外されます。
    1. [規則の追加] をクリックします。
    2. [列名] フィールドに集計する列の名前を入力します。
    3. [タイプ] リストから [合計] を選択します。
  6. 定数を使用して、フィルタされた行の概要のラベルを追加します。定数は、選択した列の有効なデータ型にする必要があります。
    1. [追加] をクリックします。
    2. フィルタされた行の概要のどの列に ID を表示するかを決定し、その列の名前を [列名] フィールドに入力します。
    3. [タイプ] リストから [定数] を選択します。
    4. [定数を指定する] フィールドに行のわかりやすい ID（「フィルタされた行の概要」など）を入力します。
  7. [完了] をクリックします。
  8. [保存] をクリックして変更を commit します。

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

自動モードを使用することをおすすめします。複数のテーブルのエクスポートで説明した 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 つのみを指定できます。フィルタされた行の概要に関するルールもここに適用されます（つまり、合計が集計のしきい値を下回った場合、フィルタされた行の概要は除外されます）。