管理画面内のレポート

このガイドでは、Google 広告管理画面のレポートのコンセプトと命名規則を、Google 広告クエリ言語（GAQL）と Google Ads API を使用して生成できるレポートにマッピングします。

一般的な UI 用語

次の表に、UI で使用される一般的な用語と、Google 広告クエリ言語（GAQL）へのマッピングを示します。

UI	GAQL
列	GAQL クエリの SELECT 句内のリソース、セグメント フィールド、指標。
期間	期間は、segments.date をフィルタする WHERE 句にマッピングされます。
フィルタ	WHERE 句の 1 つ以上の条件。
区画の分割フィールド	GAQL クエリにセグメント フィールドを含めて、セグメンテーションを適用します。
ページ分け	ページ分割では、クエリの結果セットが複数のページに分割されます。

列

UI の列は、GAQL のリソース フィールド、セグメント フィールド、指標と同等です。

フィルタリング

期間

Google 広告の管理画面には、アカウントの統計情報が表示される表と、これらの統計情報の期間を管理するためのプルダウン メニューがあります。

GAQL クエリの WHERE 句で segments.date をフィルタリングすると、GAQL でも同じ制御を行うことができます。

フィルタ

UI のフィルタは、GAQL の WHERE 句の 1 つ以上の条件と同等です。

セグメンテーション

データをセグメントごとに分割すると、掲載結果をより詳細に把握できます。たとえば、Google 検索ネットワークに固有のインプレッション数を Google ディスプレイ ネットワークとは別に確認したい場合があります。この場合は、レポートをネットワーク別に分割します。SELECT 句にセグメント フィールドを含める方法については、セグメンテーションをご覧ください。

ページネーション

UI でレポートを移動するには、各データ表の下部にあるコントロールを使用します。このコントロールを使用すると、ページを切り替えたり、定義されたサイズセットから表示する結果数を選択したりできます。

結果のページングは、GoogleAdsService.Search～next_page_token でレポートを取得するときに使用できます。ページ分割なしで結果セット全体をフェッチするには、GoogleAdsService.SearchStream を使用します。

結果の並べ替え

UI では、列を選択して結果を並べ替えることができます。

GAQL では、ORDER BY 句と LIMIT 句を使用してクエリ結果を並べ替えることができます。

ダウンロード形式

UI では、レポートを CSV、TSV、XML などのさまざまな形式でダウンロードできます。

この API は出力でさまざまな形式を直接サポートしていないため、ポスト処理を行う必要があります。クライアントで CSV 形式を実装する方法を示したコード例をご覧ください。

レポートのスケジュール設定とメール送信

レポートのスケジュール設定とメール送信は UI で使用できますが、API ではサポートされていません。

事前定義レポート

事前定義レポートのリストを作成するには、Google 広告の管理画面を使用します。

以下に、基本的な事前定義レポートと、それに対応する GAQL リソース名の一覧を示します。

基本的な事前定義レポート	GAQL リソース名 （FROM 句で指定）
アカウント	customer
キャンペーン キャンペーンの詳細	campaign
広告グループ 広告グループの詳細	ad_group
広告、 最終ページ URL	ad_group_ad
検索キーワード	keyword_view
検索語句	search_term_view
有料およびオーガニック	paid_organic_search_term_view
ランディング ページ	landing_page_view
展開後のランディング ページ	expanded_landing_page_view

上の表の例では、次の GAQL を使用してアカウント レポートを生成できます。

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

一般的な相違点

UI レポートと API レポートを比較する場合、最も一般的な違いの 1 つは、削除されたエンティティが UI では暗黙的に除外されるのに対し、API では除外されないことです。

デフォルトの UI ビューを複製するには、削除された行を除外するフィルタを追加する必要があります（通常は status フィールドを使用します）。次に例を示します。

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"