與其他廣告活動類型一樣,您可以使用 GoogleAdsService.SearchStream 擷取智慧廣告活動的屬性和成效指標。
智慧廣告活動指標可從 campaign 資源取得,而特定搜尋字詞的指標則可從 smart_campaign_search_term_view 資源取得。在 smart_campaign_search_term_view 中,search_term 欄位會顯示產生結果的相符查詢。如要擷取智慧廣告活動的運作狀態和資格詳細資料 (例如審查中狀態、不符合資格的原因或曝光時間戳記),請使用SmartCampaignSettingService.GetSmartCampaignStatus,如「廣告活動狀態」一文所述。
智慧廣告活動最近 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 個搜尋字詞,以及這些字詞的費用。請注意,segments.date 子句中省略了 SELECT,因此系統會彙整每個搜尋字詞在整個 30 天日期範圍內的曝光次數和費用。
SELECT
campaign.id,
campaign.name,
metrics.impressions,
metrics.cost_micros,
smart_campaign_search_term_view.search_term
FROM smart_campaign_search_term_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 10
擷取 KeywordThemeConstant 的屬性
由於 KeywordThemeConstants 是從非客戶專屬的大型資料集擷取,因此無法一次掃描整個 keyword_theme_constant 資源。如要擷取個別 KeywordThemeConstants,您必須查詢 campaign_criterion 資源,找出與廣告活動相關聯的關鍵字主題資源名稱,然後使用這些資源名稱查詢 keyword_theme_constant 資源。
SELECT
campaign.id,
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
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
以下說明如何從項目編號 R.70 Smart Campaign Search Term View 擷取必要欄位,以及相關聯的廣告活動和搜尋字詞:
SELECT
campaign.id,
campaign.name,
smart_campaign_search_term_view.search_term,
metrics.clicks,
metrics.cost_micros
FROM smart_campaign_search_term_view
每間商店的指標
以下查詢包含智慧廣告活動的所有可用商店指標。這些欄位也可以在單一查詢中與其他欄位合併:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
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
WHERE campaign.advertising_channel_type = 'SMART'
以小時為單位區隔的電話通話
以下說明如何擷取下午 12 點到下午 5 點之間的電話通話指標 (segments.hour 值為 12 到 16,其中每個整數代表從該小時開始的 1 小時時間範圍):
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
segments.hour,
metrics.phone_calls
FROM campaign
WHERE campaign.advertising_channel_type = 'SMART'
AND segments.hour BETWEEN 12 AND 16