在产品目录 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 |
兼容 |