报告类型:productAdvertised

在产品目录 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 商品条目的 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 商品项目的销售渠道属性:Online 或 Local。 属性 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 是