Google 広告の管理画面にはレポート機能が用意されています。レポートを作成するには、Google 広告アカウントにログインし、左側のナビゲーション メニューで [キャンペーン] をクリックしてから、[分析情報とレポート] をクリックします。レポートをゼロから作成するには、[レポート エディタ] をクリックします。
このガイドでは、Google 広告の管理画面における一般的なレポートのコンセプトと命名規則を、Google 広告クエリ言語（GAQL）と Google Ads API を使用して生成できるレポートにマッピングします。UI のプロンプトに沿って、要件に最適なレポートを作成することもできます。
ツールとリソース
UI 画面を API にマッピングする際の詳細な例と自動化されたヘルプについては、次のリソースをご覧ください。
- クックブックのクエリ: Google 広告の一般的な管理画面に表示されるデータを複製する GAQL クエリのコレクション。
- Google Ads API Reporting Extension: Google 広告の管理画面内で API リソースとフィールド名を直接特定するのに役立つ Chrome 拡張機能。
一般的な UI 用語
次の表に、UI で使用される一般的な用語と、Google 広告クエリ言語（GAQL）へのマッピングをまとめます。
| UI | GAQL |
|---|---|
| 列 | GAQL クエリの SELECT 句内のリソース、セグメント フィールド、指標。 |
| 期間 | 期間は、segments.date でフィルタリングする WHERE 句にマッピングされます。 |
| フィルタ | WHERE 句の 1 つ以上の条件。 |
| セグメント フィールド | GAQL クエリにセグメント フィールドを含めることで、セグメンテーションを適用します。 |
| ページ分け | Pagingは、クエリの結果セットを複数のページに分割します。 |
列
UI の列は、GAQL でリソース フィールド、セグメント フィールド、指標に SELECT 句を使用することと同じです。
詳しくは、掲載結果の表の列についてをご覧ください。
期間
Google 広告の管理画面には、アカウントの統計情報を表示する表と、これらの統計情報の期間を制御するプルダウン メニューがあります。
GAQL でも、GAQL クエリの WHERE 句で segments.date をフィルタすることで、同じように制御できます。
フィルタ
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 などのファイルに直接フォーマットしないため、クライアント アプリケーションでレスポンスをフォーマットする必要があります。クライアントで CSV 形式を実装する方法については、キャンペーン レポートを CSV 形式にするコードサンプルをご覧ください。
レポートのスケジュール設定とメール送信
レポートのスケジュール設定とメール送信は UI から行うことができますが、これらの機能は API ではサポートされていません。
UI ビューを API リソースにマッピングする
一般的な UI ビューと対応する GAQL リソース名のリストを次に示します。
| UI ビュー | 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 |
| [オーディエンス] > [ユーザー属性] > [年齢] | age_range_view |
| [オーディエンス] > [ユーザー属性] > [性別] | gender_view |
| 地域 | location_view |
| [コンテンツ] > [トピック] | topic_view |
| [地域] > [地域別レポート] | geographic_view |
* 検索広告とオーガニック検索のレポートを生成するには、Google Search Console アカウントを顧客レベルで Google 広告アカウントにリンクする必要があります。
上の表の例として、次の GAQL クエリを使用すると、過去 7 日間のアカウント レポートを集計できます（指標を日別に分類する場合は、SELECT 句に segments.date を追加します）。
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 フィールドを使用してフィルタを追加し、削除された行を除外します（または、ENABLED エンティティと PAUSED エンティティを明示的に含めます）。次に例を示します。
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'