报告类型：productGroup

产品组的效果指标和配置属性。产品组报告与关键字报告存在以下不同之处：了解详情。

只有异步请求（即通过 Reports.request() 方法）。

请求摘录

发送普通 Reports.request() 请求正文，但请指定 "reportType": "productGroup"。 

{
...
  "reportType": "productGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

对于您想在报告中返回或过滤的每一列， 指定下表中列出的 columnName。 您还可以视需要指定 headerText、 startDate, 和 endDate。 请注意，有些列无法过滤；指“可过滤”。

columnName说明行为类型可过滤
status 产品组的状态。始终为 Active。 属性 Status 是
engineStatus 外部引擎账号中产品组的其他状态。可取的状态包括“review”“campaign paused”等（具体取决于外部账号类型）。 属性 String 是
creationTimestamp 产品组创建的时间戳，采用 ISO 8601 格式。 属性 Timestamp 是
lastModifiedTimestamp 产品组最近一次修改的时间戳，采用 ISO 8601 格式。 属性 Timestamp 是
agency 代理机构名称。 属性 String 是
agencyId DS 代理机构 ID。 属性 ID 是
advertiser 广告客户名称。 属性 String 是
advertiserId DS 广告客户 ID。 属性 ID 是
account 引擎账号名称。 属性 String 是
accountId DS 引擎账号 ID。 属性 ID 是
accountEngineId 外部引擎账号中账号的 ID。 属性 String 是
accountType 引擎账号类型：Google AdWords、Bing Ads、Yahoo Japan Listing Ads、Yahoo Search Marketing、Yahoo Gemini、Baidu 或 Comparison Shopping。 属性 Engine type 是
campaign 广告系列名称。 属性 String 是
campaignId DS 广告系列 ID。 属性 ID 是
campaignStatus 包含此商品的广告系列的状态。 属性 Status 是
adGroup 广告组名称。 属性 String 是
adGroupId DS 广告组 ID。 属性 ID 是
adGroupStatus 包含此项目的广告组的状态。 属性 Status 是
productGroupId DS 产品组 ID。DS 会生成这些 ID，即使生成的产品组树状结构保持不变，这些 ID 也可能会发生变化。了解详情。 属性 ID 是
productGroup 用于定义产品组的条件，例如 AND(CATEGORY="Electronics",BRAND = "example")。 属性 String 否
productGroupPartitionType 产品组的划分类型：Subdivided、Excluded 或 Biddable。 属性 Product group partition type 是
productGroupLandingPage 产品组着陆页。请参阅着陆页网址和 Clickserver 网址。 属性 String 是
productGroupClickserverUrl DS 用于跟踪活动的网址。点击广告后，系统会先访问 Clickserver 网址，然后再重定向至最终着陆页。请参阅着陆页网址和 Clickserver 网址。 属性 String 是
productGroupMaxCpc 返回为此产品组设置的最高每次点击费用（如果有）。如果没有为此产品组设置最高 CPC，则此字段为空，且该产品组会继承广告组的最高每次点击费用设置。 属性 Money 是
effectiveProductGroupMaxCpc 对此产品组有效的最高每次点击费用。此值要么与广告组的最高每次点击费用相同，要么是主推产品组自己的最高每次点击费用（如果主推产品组覆盖了广告组的设置）。 属性 Money 是
productGroupMaxBid 如果此产品组由 DS 出价策略管理，则该出价策略的出价绝不会超过此限制。请参阅向产品组应用出价策略。 属性 Money 是
productGroupMinBid 如果此产品组由 DS 出价策略管理，则该出价策略的出价绝不会低于此限制。请参阅向产品组应用出价策略。 属性 Money 是
effectiveBidStrategyId 分配给此实体或由该实体继承的出价策略的 DS ID。 属性 ID 是
effectiveBidStrategy 分配给此实体或由该实体继承的出价策略的名称。 属性 String 是
bidStrategyInherited 指明此实体的出价策略是否继承。 属性 Boolean 是
effectiveLabels 沿用或直接分配给此产品组的所有标签的名称。 属性 String list 是
dfaActions Campaign Manager 操作的总次数。 指标 Integer 是
dfaRevenue Campaign Manager 交易产生的总收入。 指标 Money 是
dfaTransactions Campaign Manager 交易的总次数。 指标 Integer 是
dfaWeightedActions Campaign Manager 操作的加权总和。 指标 Number 是
dfaActionsCrossEnv 跨环境 Campaign Manager 操作的总次数。 指标 Number 是
dfaRevenueCrossEnv 跨环境 Campaign Manager 交易产生的总收入。 指标 Money 是
dfaTransactionsCrossEnv 跨环境 Campaign Manager 交易的总次数。 指标 Number 是
dfaWeightedActionsCrossEnv 跨环境 Campaign Manager 操作的加权总和。 指标 Number 是
avgCpc 平均每次点击费用。 指标 Money 是
avgCpm 平均每千次展示费用。 指标 Money 是
avgPos 平均排名。 指标 Number 是
clicks 汇总点击次数。 指标 Integer 是
cost 支付给引擎账号的总费用。 指标 Money 是
ctr 平均点击率。 指标 Number 是
impr 总展示次数。 指标 Integer 是
adWordsConversions 广告客户设置为在“Google Ads 转化次数”列中报告的数据。创建 Google Ads 转化操作后，该广告客户可以选择是否在“转化次数”报告列中统计这些转化。 指标 Number 是
adWordsConversionValue Google Ads 转化的总价值。 指标 Number 是
adWordsViewThroughConversions Google Ads 浏览型转化的总次数。 指标 Integer 是
visits DS 总访问次数。 指标 Integer 是
date 按天细分报告；每行及其汇总指标都会拆分为多行，每一天对应一行。此列会返回各行的日期。 细分 Date 是
monthStart 按月份细分报表；每行及其汇总指标都会拆分为多行，每行对应一个月份。此列会返回各行相应月份的第一天。 细分 Date 是
monthEnd 按月份细分报表；每行及其汇总指标都会拆分为多行，每行对应一个月份。此列会返回每行所在月份的最后一天。 细分 Date 是
quarterStart 按季度细分报告；每行及其汇总指标都会拆分为多行，每季度占一行。此列会返回每行相应季度的第一天。 细分 Date 是
quarterEnd 按季度细分报告；每行及其汇总指标都会拆分为多行，每季度占一行。此列会返回每行相应季度的最后一天。 细分 Date 是
weekStart 按周（从星期日到星期六）将报表细分；每行及其汇总指标都会拆分为多行，每一行对应一个星期。此列会返回每行的第一天（星期日）。 细分 Date 是
weekEnd 按周（从星期日到星期六）将报表细分；每行及其汇总指标都会拆分为多行，每一行对应一个星期。此列会返回每行的最后一天（星期六）。 细分 Date 是
yearStart 按年细分报告；每行及其汇总指标都会拆分为多行，每一行对应一年。此列返回每行当年的第一天。 细分 Date 是
yearEnd 按年细分报告；每行及其汇总指标都会拆分为多行，每一行对应一年。此列返回每行当年的最后一天。 细分 Date 是
deviceSegment 按设备细分报告；每行及其汇总指标都会拆分为多行，每个设备细分最多对应一行。此列会返回每行的设备细分。 细分 Device segment 是