分割

细分功能在 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,并且指标会根据广告组级别的 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"
      }
    }
  ]
}

adGroupresource_name 字段始终会返回,因为 ad_groupFROM 子句中被指定为资源。

可选择的细分字段

并非所有细分字段都可在 FROM 子句中针对指定资源进行选择。 举例来说,假设您继续查询 ad_group 资源。如需从 ad_group 资源中选择某个细分字段,该字段必须存在于广告组的 Segments 列表中。Segments 列表是 ad_group 资源的元数据页面上可用字段表的黄色部分。

细分资源

从某些资源中进行选择时,您可以通过在 FROM 子句中选择相关资源的字段以及相应资源的字段,选择隐式联接相关资源。您可以在 FROM 子句中资源的元数据页面上的 Attributed Resources 列表中找到这些相关资源。对于 ad_group 资源,您会看到还可以从 campaign 资源中选择字段。任何 Attributed Resourcesresource_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_dateselectable_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.datesegments.weeksegments.monthsegments.quartersegments.year 这几个细分的作用如下:

  • 这些细分可以在 WHERE 子句中进行过滤,而无需出现在 SELECT 子句中。

  • 如果这些细分中的任何一个位于 SELECT 子句中,则必须在 WHERE 子句中指定由核心日期细分组成的有限日期范围。日期细分不一定需要与 SELECT 中指定的日期细分相同。

示例

无效:由于 segments.date 位于 SELECT 子句中,因此您需要在 WHERE 子句中为 segments.datesegments.weeksegments.monthsegments.quartersegments.year 指定有限的日期范围。
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
有效:此查询会返回日期范围内的广告系列名称和累积点击次数。请注意,segments.date 无需出现在 SELECT 子句中。
SELECT
  campaign.name,
  metrics.clicks
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
有效:此查询会返回日期范围内所有日期的广告系列名称和按日期细分的点击次数。
SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
有效:此查询会返回日期范围内所有天数按月细分的广告系列名称和点击次数。
SELECT
  campaign.name,
  metrics.clicks,
  segments.month
FROM campaign
WHERE segments.date > '2024-01-01'
  AND segments.date < '2024-02-01'
有效:此查询会返回按季度和月份细分的广告系列名称和点击次数,其中月份细分涵盖了相应年份范围内的所有月份。
SELECT
  campaign.name,
  metrics.clicks,
  segments.quarter,
  segments.month
FROM campaign
WHERE segments.year > 2019
  AND segments.year < 2024

search_term_view

search_term_view 资源也会按广告组(而不仅仅是搜索字词)进行隐式细分,这体现在其资源名称的结构中,该结构也包含广告组。因此,您会获得一些看似重复的行,这些行在结果中显示相同的搜索字词,但属于不同的广告组。

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2024-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2024-06-15"
      }
    }
  ]
}

虽然此示例中返回的两个对象看起来是重复的,但它们的资源名称实际上是不同的,尤其是在“广告组”部分。这意味着,搜索字词“google photos”在同一日期 (2024-06-15) 归因于两个广告组(ID 为 222222222233333333333)。因此,我们可以得出结论,该 API 正常运行,在这种情况下没有返回重复的对象。