报告

与其他广告系列类型一样，您可以使用 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 项“智能广告系列搜索字词视图”中检索必填字段，以及关联的广告系列和搜索字词：

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:00 到下午 5:00 之间的所有来电指标（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
  AND segments.date DURING LAST_30_DAYS