出价策略的效果指标和配置属性。
只有异步请求(即通过 Reports.request() 方法)。
请求摘录
发送普通
Reports.request()
请求正文,但请指定 "reportType": "bidStrategy"
。
{ ... "reportType": "bidStrategy", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
对于您想在报告中返回或过滤的每一列,
指定下表中列出的 columnName
。
您还可以视需要指定
headerText、
startDate,
和 endDate。
请注意,有些列无法过滤;指“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
status |
出价策略的状态:Active 、Paused 或 Removed 。 |
属性 | Status |
是 |
creationTimestamp |
创建出价策略的时间戳,采用 ISO 8601 格式。 | 属性 | Timestamp |
是 |
lastModifiedTimestamp |
出价策略最近一次修改的时间戳,采用 ISO 8601 格式。 | 属性 | Timestamp |
是 |
agency |
代理机构名称。 | 属性 | String |
是 |
agencyId |
DS 代理机构 ID。 | 属性 | ID |
是 |
advertiser |
广告客户名称。 | 属性 | String |
是 |
advertiserId |
DS 广告客户 ID。 | 属性 | ID |
是 |
bidStrategyId |
DS 出价策略 ID。 | 属性 | ID |
是 |
bidStrategy |
出价策略名称。 | 属性 | String |
是 |
bidStrategyGoal |
出价策略的目标:Position 、Conversions 、Revenue 、Clicks 或 Advanced targeting 。 |
属性 | Bid strategy goal |
是 |
floodlightOptimizationEnabled |
出价策略是否定位特定的 Floodlight 活动。 | 属性 | Boolean |
是 |
ersTarget |
出价策略的目标 ERS(有效收入分成)比率。 | 属性 | Number |
是 |
cpaTarget |
出价策略的目标每次转化费用。 | 属性 | Money |
是 |
roasTarget |
出价策略的目标广告支出回报率。 | 属性 | Number |
是 |
lowPosition |
展示广告所需的最低理想位置(数字上更大)。例如,在位置范围 2 - 5 中,5 为 lowPosition 。 |
属性 | Number |
是 |
highPosition |
期望展示广告的最高排名(数值较小)。例如,在位置范围 2 - 5 中,2 为 highPosition 。 |
属性 | Number |
是 |
bidStrategyMinBid |
此出价策略中关键字的最低出价。 | 属性 | Money |
是 |
bidStrategyMaxBid |
此出价策略中关键字的最高出价。 | 属性 | Money |
是 |
monthlySpendTarget |
此出价策略的每月目标支出。如果需要,DS 会提高出价,以确保支出此金额。 | 属性 | Money |
是 |
floodlightActivityTargetIds |
此出价策略要定位的 Floodlight 活动 ID 列表(以英文逗号分隔)。 | 属性 | 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 |
是 |