报告类型:productTarget

主推产品组的效果指标和配置属性。Google Ads PLA 广告系列使用主推产品组来指定 Google Merchant Center 账号中的哪些产品应触发产品详情广告(购物广告),以在 Google 上的相关搜索结果中展示。主推产品组和 PLA 广告系列已被 Google Ads 购物广告系列取代。在 DS 中,您仍然可以请求针对在升级为购物广告系列之前归因于 PLA 广告系列的历史指标生成报表。

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

请求摘录

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

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

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

columnName说明行为类型可过滤
status 主推产品组的状态:ActivePausedRemoved。请注意,广告系列、广告组、主推产品组和广告都有自己的状态。查看状态 属性 Status
engineStatus 外部引擎账号中主推产品组的其他状态。可取的状态包括“review”“campaign paused”等(具体取决于外部账号类型)。 属性 String
creationTimestamp 创建主推产品组的时间戳,采用 ISO 8601 格式。 属性 Timestamp
lastModifiedTimestamp 主推产品组最近一次修改的时间戳,采用 ISO 8601 格式。 属性 Timestamp
agency 代理机构名称。 属性 String
agencyId DS 代理机构 ID。 属性 ID
advertiser 广告客户名称。 属性 String
advertiserId DS 广告客户 ID。 属性 ID
account 引擎账号名称。 属性 String
accountId DS 引擎账号 ID。 属性 ID
accountEngineId 外部引擎账号中账号的 ID。 属性 String
accountType 引擎账号类型:Google AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 属性 Engine type
campaign 广告系列名称。 属性 String
campaignId DS 广告系列 ID。 属性 ID
campaignStatus 包含此商品的广告系列的状态。 属性 Status
adGroup 广告组名称。 属性 String
adGroupId DS 广告组 ID。 属性 ID
adGroupStatus 包含此项目的广告组的状态。 属性 Status
productTargetId DS 主推产品组 ID。 属性 ID
productTargetFilter 过滤 Google Merchant Center 账号中具有此主推产品组的产品。您可以使用产品 ID、品牌等属性指定匹配条件。 属性 String
productTargetEngineId 外部引擎账号中主推产品组的 ID。 属性 ID
productTargetLandingPage 该值表示用户在点击您的购物广告后将会访问的最终到达网址。请参阅购物广告着陆页 属性 String
productTargetClickserverUrl DS 用于跟踪活动的网址。点击购物广告的用户会先访问 Clickserver 网址,然后重定向至最终着陆页。请参阅购物广告着陆页 属性 String
productTargetLabels 直接分配给此主推产品组的标签名称;未包含继承的标签。 属性 String list
productTargetMaxCpc 替换广告组的最高每次点击费用,并设置每当有用户点击针对此特定主推产品组的产品广告时您愿意支付的最高金额。如果此字段为空,则主推产品组将使用广告组的最高每次点击费用。 属性 Money
effectiveProductTargetMaxCpc 对此主推产品组有效的最高每次点击费用。此值要么与广告组的最高每次点击费用相同,要么是主推产品组自己的最高每次点击费用(如果主推产品组覆盖了广告组的设置)。 属性 Money
productTargetMaxBid 如果此主推产品组由 DS 出价策略管理,则该出价策略的出价绝不会超过此限制。请参阅向主推产品组应用出价策略 属性 Money
productTargetMinBid 如果此主推产品组由 DS 出价策略管理,则该出价策略的出价绝不会低于此限制。请参阅向主推产品组应用出价策略 属性 Money
effectiveBidStrategyId 分配给此实体或由该实体继承的出价策略的 DS ID。 属性 ID
effectiveBidStrategy 分配给此实体或由该实体继承的出价策略的名称。 属性 String
bidStrategyInherited 指明此实体的出价策略是否继承。 属性 Boolean
effectiveLabels 继承或直接分配给此主推产品组的所有标签的名称。 属性 String list
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