报告类型:productAdvertised

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

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

请求摘录

发送普通 Reports.request() 请求正文,但请指定 "reportType": "productAdvertised"

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

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

columnName说明行为类型可过滤
status 产品目录账号中指定的产品状态:ActiveRemoved 属性 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 商品条目的 product type leve 1 属性。 属性 String
productTypeLevel2 商品条目的 product type leve 2 属性。 属性 String
productTypeLevel3 商品条目的 product type leve 3 属性。 属性 String
productTypeLevel4 商品条目的 product type 级别 4 属性。 属性 String
productTypeLevel5 商品条目的 product type leve 5 属性。 属性 String
productCondition 商品商品的 condition [使用情况] 属性。 属性 String
productCustomLabel0 商品条目的 custom label 0 [自定义标签 0] 属性。 属性 String
productCustomLabel1 商品项目的自定义标签 1 属性。 属性 String
productCustomLabel2 商品项目的自定义标签 2 属性。 属性 String
productCustomLabel3 商品项目的自定义标签 3 属性。 属性 String
productCustomLabel4 商品项目的自定义标签 4 属性。 属性 String
productCostOfGoodsSold 在产品目录 Feed 中指定的产品的销售总费用。 属性 Money
productStoreId 通过本地产品目录广告宣传产品的商店。这应与本地商品 Feed 中使用的商店 ID 一致。 属性 String
productChannel 商品项目的销售渠道属性:OnlineLocal 属性 Product channel
productChannelExclusivity 商品项目的渠道独家性属性。 属性 Product channel exclusivity
productItemGroupId 商品商品的商品组 ID 属性。 属性 String
productTitle 商品条目的 title 属性。 属性 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