产品组的效果指标和配置属性。产品组报表与关键字报表之间存在若干差异;了解详情。
此报告只能通过异步请求(即通过 Reports.request() 方法)返回。
请求摘录
请发送常规 Reports.request() 请求正文,但指定 "reportType": "productGroup"
。
{ ... "reportType": "productGroup", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName
。您还可以选择指定 headerText、startDate 和 endDate。
请注意,某些列无法过滤;请参阅下表中的“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
status |
产品组的状态。始终为 Active 。 |
特性 | 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 AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison Shopping 。 |
特性 | Engine type |
兼容 |
campaign |
广告系列名称。 | 特性 | String |
兼容 |
campaignId |
DS 广告系列 ID。 | 特性 | ID |
兼容 |
campaignStatus |
包含此项的广告系列的状态。 | 特性 | Status |
兼容 |
adGroup |
广告组名称。 | 特性 | String |
兼容 |
adGroupId |
DS 广告组 ID。 | 特性 | ID |
兼容 |
adGroupStatus |
包含此项的广告组的状态。 | 特性 | Status |
兼容 |
productGroupId |
DS 产品组 ID。DS 会生成这些 ID,即使生成的产品组树状图保持不变,这些 ID 也可能会发生变化。欢迎了解详情。 | 特性 | ID |
兼容 |
productGroup |
用于定义产品组的条件,例如 AND(CATEGORY="Electronics",BRAND = "example")。 | 特性 | String |
否 |
productGroupPartitionType |
产品组的分区类型:Subdivided 、Excluded 或 Biddable 。 |
特性 | Product group partition type |
兼容 |
productGroupLandingPage |
产品组着陆页。请参阅着陆页网址和 Clickserver 网址。 | 特性 | String |
兼容 |
productGroupClickserverUrl |
DS 用于跟踪活动的网址。点击广告后,系统会先访问 Clickserver 网址,然后再重定向到最终着陆页。请参阅着陆页网址和 Clickserver 网址。 | 特性 | String |
兼容 |
productGroupMaxCpc |
返回已为此产品组设置的最高 CPC(如果有)。如果尚未为此产品组设置最高每次点击费用,则此字段为空,且产品组会沿用广告组的最高每次点击费用设置。 | 特性 | Money |
兼容 |
effectiveProductGroupMaxCpc |
此产品组有效的最高每次点击费用。该值与广告组的最高 CPC 相同,如果主推产品组覆盖了广告组的设置,则此值也会与主推产品组自己的最高 CPC 相同。 | 特性 | Money |
兼容 |
productGroupMaxBid |
如果该产品组由 DS 出价策略管理,则出价策略的出价绝不会超过此限制。请参阅将出价策略应用于产品组。 | 特性 | Money |
兼容 |
productGroupMinBid |
如果该产品组由 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 |
兼容 |