このガイドでは、Google 広告管理画面のレポートのコンセプトと命名規則を、Google 広告クエリ言語(GAQL)と Google Ads API を使用して生成できるレポートと対応付けています。
UI でよく使われる用語
次の表は、管理画面で使用される一般的な用語の一部と、Google 広告クエリ言語(GAQL)へのマッピングをまとめたものです。
UI | GAQL |
---|---|
列 | GAQL クエリの SELECT 句に含まれるリソース、セグメント フィールド、指標。 |
期間 | 期間は、segments.date でフィルタリングする WHERE 句にマッピングされます。 |
フィルタ | WHERE 句内の 1 つ以上の条件。 |
セグメント フィールド | GAQL クエリにセグメント フィールドを含めることで、セグメンテーションを適用します。 |
ページネーション | ページングによって、クエリの結果セットが複数のページに分割されます。 |
表示項目
UI の列は、GAQL のリソース フィールド、セグメント フィールド、指標に相当します。
フィルタリング
期間
Google 広告の管理画面には、アカウントの統計情報を表示する表と、統計情報の期間を指定するプルダウン メニューがあります。
GAQL クエリの WHERE 句で segments.date
でフィルタリングすることで、GAQL でも同じ制御が可能です。
フィルタ
管理画面のフィルタは、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 ではサポートされていません。
事前定義レポート
Google 広告の管理画面で事前定義レポートのリストを作成できます。
基本的な事前定義レポートとそれに対応する 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 |
上記の表の例として、次の 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"