在产品目录 Feed 中定义并通过付费搜索广告售出的产品的效果指标、配置属性和产品目录属性。
只有异步请求(即通过 Reports.request() 方法)。
由于事件在特定日期发生,因此请求此报告时必须指定 timeRange。 您可以指定以下任一项:
请求摘录
发送普通
Reports.request()
请求正文,但请指定 "reportType": "productLeadAndCrossSell"
。
{ ... "reportType": "productLeadAndCrossSell", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
对于您想在报告中返回或过滤的每一列,
指定下表中列出的 columnName
。
您还可以视需要指定
headerText、
startDate,
和 endDate。
请注意,有些列无法过滤;指“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
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 |
是 |
crossSellAverageUnitPrice |
报告的商品销售平均价格(因对其他商品进行广告宣传而售出的商品) | 指标 | Money |
是 |
crossSellCostOfGoodsSold |
某产品因对其他产品进行广告宣传而售出的总费用。 | 指标 | Money |
是 |
crossSellGrossFromUnitsSold |
由于对其他产品进行广告宣传而售出产品产生的总收入。 | 指标 | Money |
是 |
crossSellGrossProfitMargin |
特定商品因对其他商品进行广告宣传而售出的毛利润率。 | 指标 | Number |
是 |
crossSellRevenueFromUnitsSold |
交叉销售产生的总收入(由于对其他产品进行广告宣传而产生的收入)。 | 指标 | Money |
是 |
crossSellUnitsSold |
通过交叉销售而售出的件数。(因对其他产品进行广告宣传而售出的件数。) | 指标 | Number |
是 |
leadAverageUnitPrice |
报告的商品平均销售价格(因对商品进行广告宣传而售出的商品)。 | 指标 | Money |
是 |
leadCostOfGoodsSold |
通过对产品进行广告宣传而售出产品产生的总销售成本。 | 指标 | Money |
是 |
leadGrossProfitFromUnitsSold |
由于对产品进行广告宣传而售出产品产生的总收入。 | 指标 | Money |
是 |
leadGrossProfitMargin |
因对特定商品进行广告宣传而直接产生的毛利润率。 | 指标 | Number |
是 |
leadRevenueFromUnitsSold |
因对商品进行广告宣传而产生的商品总收入。 | 指标 | Money |
是 |
leadUnitsSold |
由于对产品进行广告宣传而售出的件数。 | 指标 | Number |
是 |
productUnitsSold |
特定产品的销售总数。 | 指标 | Number |
是 |
productRevenueFromUnitsSold |
商品产生的总收入(使用每件商品报告的价格)。 | 指标 | Money |
是 |
productAverageUnitPrice |
针对产品销售报告的平均价格(使用每个产品上报告的价格)。 | 指标 | Money |
是 |
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 |
是 |