细分功能在 Google Ads 界面中作为一个单独的菜单提供,而在 Google Ads API 中,您只需向查询添加适当的字段即可实现。例如,如果将 segments.device
添加到查询中,生成的报告将针对 FROM
子句中的设备和指定资源的每个组合生成一行,并将统计值(展示次数、点击次数、转化次数等)划分到一起。
在 Google Ads 界面中,一次只能使用一个细分,但通过 API,您可以在同一查询中指定多个细分。
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions
FROM campaign
将此查询发送到 GoogleAdsService.SearchStream
的结果将类似于以下 JSON 字符串:
{
"results":[
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"10922"
},
"segments":{
"device":"MOBILE"
}
},
{
"campaign":{
"resourceName":"customers/1234567890/campaigns/111111111",
"name":"Test campaign",
"status":"ENABLED"
},
"metrics":{
"impressions":"28297"
},
"segments":{
"device":"DESKTOP"
}
},
...
]
}
请注意,在上面的示例结果中,第一个对象和第二个对象(包括资源名称)的属性相同。展示按设备细分,因此可以针对同一广告系列返回两个或更多对象。
隐式细分
每个报告最初都会按 FROM
子句中指定的资源进行细分。即使查询中未明确包含 resource_name 字段,系统也会返回 FROM
子句中资源的 resource_name 字段,并按该字段对指标进行细分。例如,如果您在 FROM
子句中指定 ad_group
作为资源,系统将自动返回 ad_group.resource_name
,并且指标将在广告组一级隐式细分。
对于这个查询
SELECT metrics.impressions
FROM ad_group
则会获得如下所示的 JSON 字符串:
{
"results":[
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/2222222222"
},
"metrics":{
"impressions":"237"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/33333333333"
},
"metrics":{
"impressions":"15"
}
},
{
"adGroup":{
"resourceName":"customers/1234567890/adGroups/44444444444"
},
"metrics":{
"impressions":"0"
}
}
]
}
请注意,始终会返回 adGroup
的 resource_name
字段,因为 ad_group
在 FROM
子句中被指定为资源。
可选择的细分字段
对于 FROM
子句中的给定资源,并非所有细分字段都可供选择。例如,我们将继续从 ad_group
资源进行查询。若要从 ad_group 资源中选择细分字段,该字段必须存在于 ad_group 的 Segments
列表中。Segments
列表是 ad_group
资源元数据页面上可用字段表的黄色部分。
细分资源
从某些资源中进行选择时,您可以选择隐式联接相关资源,只需在 FROM
子句中的资源字段旁边选择这些资源的字段即可。这些相关资源可以在 FROM
子句元数据页面中资源的 Attributed Resources
列表中找到。对于 ad_group
资源,您会看到还可以从 campaign
资源中选择字段。系统会自动返回任何 Attributed Resources
的 resource_name 字段,其中 SELECT
子句中至少包含一个字段,即使查询中未明确包含 resource_name 字段也是如此。
与选择 Attributed Resource
字段类似,您也可以选择 Segmenting Resource
字段。如果给定资源的元数据页面上具有 Segmenting Resources
列表,那么从列出的资源之一中选择字段会导致查询按 Segmenting Resource
的返回的 resource_name 进一步细分。例如,您会发现 campaign
资源被列为 campaign_budget
资源的 Segmenting Resource
。从 campaign_budget 资源中选择任意广告系列字段(如 campaign.name
)不仅会导致系统返回 campaign.name 字段,还会导致系统返回 campaign.resource_name
字段并对其进行细分。
细分和指标的选择性
给定的细分字段可能与某些其他细分字段或某些指标字段不兼容。如需确定哪些细分字段相互兼容,您可以在 SELECT
子句中查看细分的 selectable_with
列表。
对于 ad_group
资源,您可以选择 50 多个可用细分。不过,segments.hotel_check_in_date
的 selectable_with
列表是一小部分兼容细分的集合。这意味着,如果将 segments.hotel_check_in_date
字段添加到 SELECT
子句,则会将可以选择的可用细分限制为这两个列表的交集。
- 添加一些细分后,摘要行中的指标可能会降低
- 将
segments.keyword.info.match_type
添加到具有FROM ad_group_ad
的查询中,该段会告知查询仅获取具有关键字的数据行,并移除未与关键字关联的所有行。在这种情况下,指标会较低,因为它会排除所有非关键字指标。
WHERE 子句中细分的规则
当某个段出现在 WHERE
子句中时,它还必须在 SELECT
子句中。此规则的例外情况包括以下日期细分,它们称为“核心日期细分”:
segments.date
segments.week
segments.month
segments.quarter
segments.year
核心日期细分字段的规则
segments.date
、segments.week
、segments.month
、segments.quarter
和 segments.year
部分的作用如下:
这些细分可通过
WHERE
子句过滤,而不会出现在SELECT
子句中。如果其中任何细分包含在
SELECT
子句中,则必须在WHERE
子句中指定由核心日期细分组成的有限日期范围(这些日期细分不必与SELECT
中指定的日期细分相同)。
示例
无效:由于 segments.date 位于 SELECT 子句中,因此您需要在 WHERE 子句中为 segments.date 、segments.week 、segments.month 、segments.quarter 或 segments.year 指定有限日期范围。 |
SELECT campaign.name, metrics.clicks, segments.date FROM campaign |
有效:此查询会返回在该日期范围内产生的广告系列名称和点击次数。请注意,segments.date 不需要出现在 SELECT 子句中。 |
SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
有效:此查询会返回日期范围内所有日期的按日期细分的广告系列名称和点击次数。 |
SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
有效:此查询会返回日期范围内所有日期的按月细分的广告系列名称和点击次数。 |
SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01' |
有效:此查询会返回一年范围内所有月份按季度和月份细分的广告系列名称和点击次数。 |
SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year > 2015 AND segments.year < 2020 |
search_term_view
请注意,对于 search_term_view
资源,它也会按广告组(而不仅仅是搜索字词)隐式细分,这可以通过其资源名称的结构反映出来,该结构也包括广告组。因此,结果中会出现一些看似重复的行,包含相同的搜索字词,但实际上这些行属于不同的广告组:
{
"results":[
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"3"
},
"segments":{
"date":"2015-06-15"
}
},
{
"searchTermView":{
"resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
"searchTerm":"google photos"
},
"metrics":{
"impressions":"2"
},
"segments":{
"date":"2015-06-15"
}
}
]
}
虽然此示例中返回的两个对象似乎重复,但它们的资源名称实际上是不同的,特别是在“广告组”部分。也就是说,搜索字词“google photos”归因于同一日期(2015 年 6 月 15 日)这两个广告组(ID 为 2222222222
和 33333333333
)。因此,我们可以断定,API 按预期运行,在这种情况下没有返回重复的对象。