レポート

レポートには、アカウントのさまざまなリソースに関する情報がすべて表示されます。 キャンペーンや広告グループ、それらのデータに関する情報を取得したり、 アカウントの履歴などを確認できます。レポート インフラストラクチャは、 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() メソッドを使用します。これは、検索結果に広告が表示されるネイティブ フォーマットではありません。 によって返されるため、一部の項目は使用できない場合があります。 必要があります。その場合は、代わりに 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 ドキュメントをご覧ください。