如同其他廣告活動類型,您可以使用 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