このページは Cloud Translation API によって翻訳されました。

管理画面でのレポート

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

一般的な UI 用語

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

UI	GAQL（GAQL）
列	GAQL クエリの SELECT 句内の任意のリソース、セグメントフィールド、または指標。
期間	期間は、`segments.date` でフィルタリングされた WHERE 句にマッピングされます。
フィルタ	WHERE 句の 1 つ以上の条件。
セグメントフィールド	GAQL クエリにセグメントフィールドを追加して、セグメントを適用します。
ページ分け	Paging は、クエリの結果セットを複数のページに分割します。

Columns

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

フィルタ処理

期間

Google 広告の管理画面には、アカウントの統計情報を表示する表と、掲載結果の期間を指定するプルダウンメニューがあります。GAQL でも、GAQL クエリの WHERE 句で segments.date をフィルタすることで、同じ制御を行うことができます。

フィルタ

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

セグメンテーション

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

ページ分け

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

GoogleAdsService.Search でレポートを取得すると、next_page_token を使用して、UI と同様の方法で結果をページ分割できます。

ただし、GoogleAdsService.SearchStream を使用して、ページ分けを使用せずに結果セット全体を取得することもできます。

注文

UI では、列を選択して結果を特定の列で並べ替えます。GAQL では、ORDER BY 句と LIMIT 句を使用してクエリ結果を変更できます。

ダウンロード形式

レポートは、さまざまな形式（csv、tsv、xml など）で UI からダウンロードできます。API は書式設定やファイル出力をサポートしていません。ユースケースに応じて、次のいずれかのレポート例を拡張することをおすすめします。

以下に、クライアントに CSV 形式を実装する方法を示す Ruby の例を示します。

campaign_report_to_csv.rb

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

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

事前定義レポート

Google 広告の管理画面から、事前定義レポートのリストを作成できます。以下に、基本的な事前定義レポートと対応する GAQL リソース名のリストを示します。

基本的な事前定義レポート	GAQL リソース名（FROM 句で指定）
アカウント	お客様
キャンペーン、キャンペーンの詳細	キャンペーン
広告グループ、広告グループの詳細	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

API で上記の GAQL を実行するには、次のいずれかのレポート例をご覧ください。

一般的な違い

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

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

たとえば、キャンペーンを取得する場合は次のようなクエリを使用します。

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