本頁面由 Cloud Translation API 翻譯而成。

報表

與其他廣告活動類型一樣，您可以使用 GoogleAdsService.SearchStream 擷取智慧廣告活動的屬性和成效指標。

campaign 資源提供智慧廣告活動指標，smart_campaign_search_term_view 資源則可提供搜尋字詞專屬指標。在 smart_campaign_search_term_view 中，search_term 欄位會包含任何產生結果的相符查詢。

過去 30 天內智慧廣告活動的曝光次數和點擊次數

下方查詢會擷取所有智慧廣告活動最近 30 天內，每個搜尋字詞的曝光和點擊次數，並按日期區隔。

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.clicks,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS

按曝光次數顯示的前 10 大搜尋字詞

以下查詢會擷取過去 30 天內產生最多曝光的前 10 大搜尋字詞，以及其費用。

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  metrics.impressions,
  metrics.cost_micros,
  smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
ORDER BY metrics.impressions DESC
LIMIT 10

擷取 `KeywordThemeConstant` 的屬性

由於 KeywordThemeConstants 是從並非客戶專屬的大型資料集擷取，因此無法一次掃描整個 keyword_theme_constant 資源。如要擷取個別 KeywordThemeConstants，您必須查詢 campaign_criterion 資源，找出與廣告活動有關的關鍵字主題資源名稱，然後使用這些資源名稱來篩選 keyword_theme 資源。

SELECT
  campaign_criterion.type,
  campaign_criterion.status,
  campaign_criterion.criterion_id,
  campaign_criterion.keyword_theme.keyword_theme_constant
FROM campaign_criterion
WHERE campaign_criterion.type = KEYWORD_THEME

現在，請在以下查詢的 campaign_criterion.keyword_theme.keyword_theme_constant 欄位中使用資源名稱：

SELECT
  keyword_theme_constant.resource_name,
  keyword_theme_constant.display_name,
  keyword_theme_constant.country_code
FROM keyword_theme_constant
WHERE keyword_theme_constant.resource_name = 'keywordThemeConstants/40804~0'

報表功能相關規定

您的應用程式必須滿足一組最低基本功能 (RMF)，才能導入智慧廣告活動。

就報表而言，必須為使用者提供多個報表欄位。以下說明如何從 RMF 中的項目編號 R.20 廣告活動成效擷取必填欄位：

SELECT
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM campaign

以下說明如何從項目編號「R.70 智慧廣告活動搜尋字詞檢視」中擷取必填欄位：

SELECT
  metrics.clicks,
  metrics.cost_micros
FROM smart_campaign_search_term_view

個別商店指標

以下查詢包含所有可用的個別商店指標。這些欄位也可與單一查詢中的其他欄位合併：

SELECT
  metrics.all_conversions_from_click_to_call,
  metrics.all_conversions_from_directions,
  metrics.all_conversions_from_menu,
  metrics.all_conversions_from_order,
  metrics.all_conversions_from_other_engagement,
  metrics.all_conversions_from_store_visit,
  metrics.all_conversions_from_store_website
FROM campaign

按小時區隔的來電次數

以下說明如何擷取中午 12 點到下午 5 點的所有來電指標：

SELECT
  segments.hour,
  metrics.phone_calls
FROM campaign
WHERE segments.hour BETWEEN 12 and 17

傳送變更請求

報表