报告类型：产品广告

在产品目录 Feed 中定义并在购物广告系列中宣传的产品的效果指标、配置属性和产品目录属性。

此报告只能通过异步请求（即通过 Reports.request() 方法）返回。

请求摘录

请发送常规 Reports.request() 请求正文，但指定 "reportType": "productAdvertised"。 

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

针对您要在报告中返回或过滤的每列，指定下表中列出的 columnName。您还可以选择指定 headerText、startDate 和 endDate。 请注意，某些列无法过滤；请参阅下表中的“可过滤”。

columnName说明行为类型可过滤
status 商品目录帐号中显示的商品状态：Active 或 Removed。 特性 Status 兼容
creationTimestamp 产品目录帐号中的产品创建时间戳，采用 ISO 8601 格式。 特性 Timestamp 兼容
lastModifiedTimestamp 商品的最近修改时间戳，与商品目录帐号中所示的修改类似，采用 ISO 8601 格式。 特性 Timestamp 兼容
agency 代理机构名称。 特性 String 兼容
agencyId DS 代理机构 ID。 特性 ID 兼容
advertiser 广告客户名称。 特性 String 兼容
advertiserId DS 广告客户 ID。 特性 ID 兼容
productId 商品的商品 ID。 特性 String 兼容
productCountry 商品的产品目录 Feed 注册的国家/地区。 特性 String 兼容
productLanguage 为商品目录 Feed 设置的注册语言。 特性 String 兼容
productMpn 商品的 MPN 属性（制造商部件号）。 特性 String 兼容
productColor 商品商品的 color [颜色] 属性。 特性 String 兼容
productSize 商品商品的 size 属性。 特性 String 兼容
productMaterial 商品的 material [材质] 属性。 特性 String 兼容
productPattern 商品的 pattern [图案] 属性。 特性 String 兼容
productAvailability 商品的 availability [库存状况] 属性。 特性 Product availability 兼容
productGender 商品的 gender [适用性别] 属性。 特性 String 兼容
productAgeGroup 商品的 age group [年龄段] 属性。 特性 String 兼容
productLandingPageUrl 商品商品的着陆页属性。 特性 String 兼容
productCategory 商品商品的 Google 商品类别属性。 特性 String 兼容
productCategoryLevel1 商品商品的 Google 商品类别级别 1 属性。 特性 String 兼容
productCategoryLevel2 商品的 Google 商品类别级别 2 属性。 特性 String 兼容
productCategoryLevel3 商品的 Google 商品类别级别 3 属性。 特性 String 兼容
productCategoryLevel4 商品商品的 Google 商品类别级别 4 属性。 特性 String 兼容
productCategoryLevel5 商品商品的 Google 商品类别级别 5 属性。 特性 String 兼容
productBrand 商品的 brand [品牌] 属性。 特性 String 兼容
productGtin 商品商品的 GTIN 属性（全球贸易项目代码）。 特性 String 兼容
productPrice 商品的 price [价格] 属性。 特性 Money 兼容
productSalePrice 商品的 price [价格] 属性。 特性 Money 兼容
productTypeLevel1 商品商品的第 1 类商品属性。 特性 String 兼容
productTypeLevel2 商品商品类型 2 项属性。 特性 String 兼容
productTypeLevel3 商品商品类型 3 项属性。 特性 String 兼容
productTypeLevel4 商品商品的商品类型 4 级属性。 特性 String 兼容
productTypeLevel5 商品的商品类型 leve 5。 特性 String 兼容
productCondition 商品的 condition [使用情况] 属性。 特性 String 兼容
productCustomLabel0 商品商品的自定义标签 0 属性。 特性 String 兼容
productCustomLabel1 商品的自定义标签 1 属性。 特性 String 兼容
productCustomLabel2 商品的自定义标签 2 属性。 特性 String 兼容
productCustomLabel3 商品的自定义标签 3 属性。 特性 String 兼容
productCustomLabel4 商品的自定义标签 4 属性。 特性 String 兼容
productCostOfGoodsSold 在商品目录 Feed 中指定的商品的销售总费用。 特性 Money 兼容
productStoreId 在本地商品目录广告中宣传商品的商店。这应与本地商品 Feed 中使用的商店 ID 一致。 特性 String 兼容
productChannel 商品条目的销售渠道属性：Online 或 Local。 特性 Product channel 兼容
productChannelExclusivity 商品的渠道独家性属性。 特性 Product channel exclusivity 兼容
productItemGroupId 商品的商品组 ID 属性。 特性 String 兼容
productTitle 商品的标题属性。 特性 String 兼容
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 兼容
floodlightGroup 按 Floodlight 组细分报表；每行及其汇总指标会被拆分成多行，每个 Floodlight 组最多一行。此列返回每行的 Floodlight 活动组名称。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 String 兼容
floodlightGroupId 按 Floodlight 组细分报表；每行及其汇总指标会被拆分成多行，每个 Floodlight 组最多一行。此列返回每行的 DS Floodlight 组 ID。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 ID 兼容
floodlightGroupTag 按 Floodlight 组细分报表；每行及其汇总指标会被拆分成多行，每个 Floodlight 组最多一行。此列返回每行的 Floodlight 组代码。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 String 兼容
floodlightActivity 按 Floodlight 活动细分报表；每行及其汇总指标会被拆分为多行，每个 Floodlight 活动最多占一行。此列返回每行的 Floodlight 活动名称。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 String 兼容
floodlightActivityId 按 Floodlight 活动细分报表；每行及其汇总指标会被拆分为多行，每个 Floodlight 活动最多占一行。此列返回每行的 DS Floodlight 活动 ID。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 ID 兼容
floodlightActivityTag 按 Floodlight 活动细分报表；每行及其汇总指标会被拆分为多行，每个 Floodlight 活动最多占一行。此列返回每行的 Floodlight 活动代码。请注意，某些指标没有细分的 Floodlight 值，例如点击次数和访问次数。 细分 String 兼容
accountId DS 引擎帐号 ID。 细分 ID 兼容
campaignId 按广告系列细分此报表。此行会返回与该行关联的 DS 广告系列 ID。 细分 ID 兼容
adGroupId 按广告组细分报告。此行返回与该行关联的广告组 ID。 细分 ID 兼容