レポート

レポートには、アカウント内のさまざまなリソースに関する情報が表示されます。キャンペーン、広告グループ、それらの統計情報に関する情報の取得、アカウントの変更履歴の取得などを行うことができます。レポート インフラストラクチャは Google Ads API によってサポートされており、GAQL を使用して、設定するフィールド、指標、条件を指定します。

レポートには主に 2 つのメカニズムがあります。どちらも同じ種類のクエリを受け入れますが、主に結果の返し方が異なります。

どちらの場合も、次のクエリを使用します。

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
これにより、検索結果のフラットな辞書のような表現が返されます。row["campaign.id"] や row["metrics.impressions"] などの辞書を直接使用する場合と同様に、フィールドにアクセスできます。この形式を使用すると、exportToSheet() メソッドを使用して結果をスプレッドシートに直接エクスポートできます。これは Google Ads API が結果を返すデフォルトの形式ではないため、場合によっては一部のフィールドがこの形式で使用できないことがあります。その場合は、代わりに search を使用してください。
AdsApp.search()
これにより、さまざまなフィールドを持つ GoogleAdsRow オブジェクトのリストが返されます。各フィールドにはサブフィールドが含まれる場合があります。そのため、row.campaign.id と row.metrics.impressions にアクセスしてデータを取得します。これは、データをプログラムで処理する予定の場合に一般的に役立ちます。一部のフィールドは、フラットな表現に変換できない場合にのみ search 形式で利用できることがあります。

レポートの例

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

このビューの使用方法の詳細については、AdsApp.report のドキュメントをご覧ください。

検索の例

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

使用可能なすべての設定については、Adsapp.search のドキュメントをご覧ください。