報表

報表會提供帳戶中所有不同資源的相關資訊。 您可以擷取廣告活動、廣告群組及其統計資料的相關資訊、變更帳戶的記錄等。報表基礎架構由 Google Ads API 支援，並使用 GAQL 指定要設定的欄位、指標和條件。

回報機制主要有兩種。兩者接受的查詢類型相同，主要差異在於傳回結果的方式。

在這兩種情況下，我們都會使用下列查詢：

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 說明文件。