Google 広告管理画面のレポート

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

UI でよく使用される用語

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

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

列

UI の列は、GAQL の リソース フィールド、 セグメント フィールド、および 指標に相当します。

フィルタリング

レポートのデータをフィルタして整理できます。

期間

Google 広告 UI には、アカウントの統計情報を表示する表と、これらの統計情報の期間を制御するプルダウン メニューがあります。

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

フィルタ

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 広告 UI で事前定義レポートのリストを作成できます。

基本的な事前定義レポートと、対応する 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
コンテンツ > プレースメント	managed_placement_view
コンテンツ > 広告が表示された場所	group_placement_view
コンテンツ > 広告が表示された場所 > 詳細を表示	detail_placement_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"