報表

報表會提供帳戶中所有不同資源的相關資訊。 您可以擷取廣告活動、廣告群組及其統計資料的相關資訊、變更帳戶的變更記錄等。報表基礎架構以 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說明文件。