与其他广告系列类型一样,您可以使用
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 个搜索字词及其费用。请注意,SELECT 子句中省略了 segments.date,以便按搜索字词汇总整个 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