このガイドでは、Google 広告管理画面のレポートのコンセプトと命名規則について説明します。 Google 広告クエリ言語（GAQL）を使って生成できるレポートと、 Google Ads API
UI でよく使われる用語
次の表は、管理画面で使用される一般的な用語の一部と、 Google 広告クエリ言語（GAQL）へのマッピング
| UI | GAQL |
|---|---|
| 列 | GAQL クエリの SELECT 句に含まれるリソース、セグメント フィールド、指標。 |
| 期間 | 期間は WHERE
句 に対するフィルタリングsegments.date。 |
| フィルタ | WHERE 句内の 1 つ以上の条件。 |
| セグメント フィールド | セグメント フィールドを追加してセグメンテーションを適用する 必要があります |
| ページ分け | ページングによって、 複数のページに分けることができます |
列
管理画面の列は [リソース フィールド、セグメント フィールド GAQL の指標。
フィルタリング
期間
Google 広告の管理画面には、アカウントの統計情報を表示する表と、 統計情報の期間を設定できます
GAQL でも同じコントロールが可能です。
GAQL の WHERE 句内の segments.date
なります。
フィルタ
UI のフィルタは、WHERE 句を使用します。
セグメンテーション
データをセグメントごとに分割すると、掲載結果をより詳細に把握できます。たとえば そのキャンペーンタイプ別のインプレッション数や Google 検索ネットワークと Google ディスプレイ ネットワークとの区別はありません。この例では ネットワーク別にデータを分割します詳しくは、 セグメント フィールドを含める方法に関するセグメンテーション 指定します。
ページネーション
管理画面でレポートを操作するには、 ページを切り替えたり、表示するページの数を選択したりできる サイズを指定して表示することもできます。
結果のページ分割は、
GoogleAdsService.Search～
next_page_token。結果セット全体を取得する
ページ分けなしにする場合は、
GoogleAdsService.SearchStream。
並べ替えの結果
UI では、列を選択して結果を並べ替えることができます。
GAQL では、ORDER BY を使用して 句と LIMIT 句 並べ替えることができます
ダウンロード形式
管理画面では、CSV、TSV、 XML。
この API の出力形式は直接サポートされないため、 必要があります。詳しくは、 CSV フォーマットを クライアントです。
レポートのスケジュール設定とメール送信
レポートのスケジュール設定とメール送信は UI では利用できるが、 できます。
事前定義レポート
Google 広告の管理画面で事前定義レポートのリストを作成できます。
基本的な事前定義レポートとそれに対応する GAQL リソースのリストです 名前
| 基本の事前定義レポート | GAQL リソース名 （FROM 句で指定） |
|---|---|
| アカウント | お客様 |
| キャンペーン、 キャンペーンの詳細 |
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 レポートを比較する際の最も一般的な違いの一つは、 UI では削除されたエンティティが暗黙的に除外されますが、API では除外されません。
デフォルトの UI ビューを再現するには、フィルタを追加する必要があります。通常、
status フィールドを使用して、削除された行を除外します。次に例を示します。
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"