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

Google 広告の UI にはレポート機能が用意されています。レポートを作成するには、Google 広告アカウントにログインします。左側の [キャンペーン] をクリックし、[分析情報とレポート] をクリックします。レポートを最初から作成するには、[レポート エディタ] をクリックします。

このガイドでは、Google 広告管理画面の一般的なレポートのコンセプトと命名規則を、Google Ads Query Language（GAQL）と Google Ads API を使用して生成できるレポートにマッピングします。UI のプロンプトに沿って、要件に最適なレポートを作成することもできます。

ツールとリソース

UI 画面を API にマッピングする際の詳細な例と自動化されたヘルプについては、次のリソースをご覧ください。

• クエリのクックブック: 一般的な Google 広告の UI 画面に表示されるデータを複製する GAQL クエリのコレクション。
• Google Ads API Reporting Extension: Google 広告の管理画面内で API リソースとフィールド名を直接特定するのに役立つ Chrome 拡張機能。

一般的な UI 用語

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

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

列

UI の列は、GAQL で リソース フィールド、セグメント フィールド、または指標の SELECT 句を使用することに相当します。

パフォーマンス データの表の列についてをご覧ください。

期間

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

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

フィルタ

UI のフィルタは、GAQL の WHERE 句の 1 つ以上の条件に相当します。

パフォーマンス データにフィルタをかけるをご覧ください。

セグメンテーション

より詳細な統計情報を確認するには、データをセグメントで分割します。たとえば、Google ディスプレイ ネットワークとは別に、Google 検索ネットワークに固有のインプレッション数を表示したいとします。その場合は、レポートをネットワーク別に分割します。SELECT 句にセグメント フィールドを含める方法については、セグメンテーションをご覧ください。

ページネーション

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

next_page_token を介して GoogleAdsService.Search でレポートを取得する場合、結果のページングを利用できます。ページングなしで結果セット全体を取得するには、GoogleAdsService.SearchStream を使用します。

結果を並べ替える

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

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

ダウンロード形式

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

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

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

UI からレポートのスケジュール設定とメール送信を行うことはできますが、これらの機能は API ではサポートされていません。

API リソースに UI ビューをマッピングする

一般的な UI ビューと対応する GAQL リソース名のリストは次のとおりです。

UI ビュー	GAQL リソース名 （FROM 句で指定）
アカウント	customer
キャンペーン、 キャンペーンの詳細	campaign
広告グループ、 広告グループの詳細	ad_group
Ad, Final 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
[ユーザー] > [ユーザー属性] > [年齢]	age_range_view
[ユーザー] > [ユーザー属性] > [性別]	gender_view
ロケーション	location_view
[コンテンツ] > [トピック]	topic_view
[地域] > [地域別レポート]	geographic_view

^* 検索広告とオーガニック検索のレポートを生成するには、Google Search Console アカウントを Google 広告アカウントに顧客レベルでリンクする必要があります。

前の表の例として、次の 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'