分割

细分功能在 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 中指定的日期细分相同）。

示例

SELECT
  campaign.name,
  metrics.clicks,
  segments.date
FROM campaign

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 按预期运行，在这种情况下没有返回重复的对象。