与其他广告系列类型一样,您可以使用 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