您可以透過報表瞭解帳戶中各種資源。 您可以擷取廣告活動、廣告群組及其統計資料的相關資訊,以及帳戶的變更記錄等。報表基礎架構由 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
說明文件,瞭解所有可能的設定。