报告类型：广告客户

为广告客户生成报告的数据，包括：

广告客户的所有引擎账号和广告系列的效果指标。
广告客户的配置属性。

请求摘要

发送常规的 Reports.request() 或 Reports.generate() 请求正文，但指定 "reportType": "advertiser"。

{
...
  "reportType": "advertiser",
  "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`	是
`dfaAdvertiserId`	与此 DS 广告客户相关联的 Campaign Manager 广告客户的 ID。	属性	`ID`	是
`dfaNetworkId`	与此 DS 广告客户关联的 Campaign Manager 广告联盟的 ID。	属性	`ID`	是
`dfaNetworkTimeZone`	与此 DS 广告客户关联的 Campaign Manager 广告资源网的时区（采用 IANA 时区数据库格式），例如 `America/New_York`。	属性	`String`	是
`advertiserCurrencyCode`	广告客户的币种代码（采用 ISO 4217 格式）。	属性	`String`	是
`googleAnalyticsTimeZone`	与此 DS 广告客户关联的 Google Analytics 视图的时区。使用 IANA 时区数据库格式，例如 `America/New_York`。	属性	`String`	是
`dfaActions`	Campaign Manager 操作的总数。	指标	`Integer`	是
`dfaRevenue`	Campaign Manager 交易产生的总收入。	指标	`Money`	是
`dfaTransactions`	Campaign Manager 交易总数。	指标	`Integer`	是
`dfaWeightedActions`	Campaign Manager 操作的加权总和。	指标	`Number`	是
`dfaActionsCrossEnv`	跨环境广告系列管理中心操作的总数。	指标	`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`	是
`searchImpressionShare`	仅限 Google Ads 和 Bing Ads。您在搜索网络中实际获得的展示次数除以您有资格获得的展示次数估算值所得到的百分比。返回值为介于 0.1 和 1 之间的数字，如果份额低于 0.1，则返回字符串 `< 10%`。	指标	`Impression share`	是
`searchBudgetLostImpressionShare`	仅限 Google Ads 和 Bing Ads。广告因预算不足而未能在搜索网络上获得的展示次数所占的百分比。返回值为介于 0 和 0.9 之间的数字，如果份额大于 0.9，则返回字符串 `> 90%`。	指标	`Impression share`	是
`searchRankLostImpressionShare`	仅适用于 Google Ads 和 Bing Ads。广告因广告评级不佳而未能在搜索网络上获得的展示次数所占的百分比。返回值为介于 0 和 0.9 之间的数字，如果份额大于 0.9，则返回字符串 `> 90%`。	指标	`Impression share`	是
`displayImpressionShare`	仅限 Google Ads。您在展示广告网络中实际获得的展示次数除以您有资格获得的展示次数的估算值。返回值为介于 0.1 和 1 之间的数字，如果份额低于 0.1，则返回字符串 `< 10%`。	指标	`Impression share`	是
`displayBudgetLostImpressionShare`	仅限 Google Ads。该列是指广告因预算不足而未能在展示广告网络上获得的展示次数所占的百分比。返回值为介于 0 和 0.9 之间的数字，如果份额大于 0.9，则返回字符串 `> 90%`。	指标	`Impression share`	是
`displayRankLostImpressionShare`	仅限 Google Ads。广告因广告评级不佳而未能在展示广告网络上获得的展示次数所占的百分比。返回值为介于 0 和 0.9 之间的数字，如果份额大于 0.9，则返回字符串 `> 90%`。	指标	`Impression share`	是
`qualityScoreAvg`	仅限 Google Ads 和 Bing Ads。针对报告范围内的所有天数和关键字，按展示次数加权得出的引擎质量得分 (QS) 的平均值。	指标	`Number`	是
`topOfPageBidAvg`	仅限 Google Ads。大致估算的是，在报告所涵盖的时间范围内，要让您的广告经常出现在搜索结果上方的前列位置，您可能需要支付的每次点击费用出价的平均值。	指标	`Money`	是
`absoluteTopImpressionPercentage`	显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。	指标	`Impression share`	是
`searchAbsoluteTopImpressionShare`	您实际获得的绝对页首（自然搜索结果上方的首条广告）展示次数除以您有资格获得的估算页首展示次数所得的百分比。	指标	`Impression share`	是
`topImpressionPercentage`	广告在自然搜索结果上方任意位置展示的次数所占百分比。	指标	`Impression share`	是
`searchTopImpressionShare`	您在热门位置（自然搜索结果上方的任意位置）获得的展示次数相较于您有资格在热门位置获得的估算展示次数。	指标	`Impression share`	是
`searchBudgetLostAbsoluteTopImpressionShare`	估算您的广告因预算不足而未能在自然搜索结果上方作为首条广告展示的频率。	指标	`Impression share`	是
`searchBudgetLostTopImpressionShare`	有助于您了解您的广告因预算不足而未能在自然搜索结果上方任意位置进行展示的频率。	指标	`Impression share`	是
`searchRankLostAbsoluteTopImpressionShare`	估算您的广告因广告评级较低而未能在自然搜索结果上方作为首条广告展示的频率。	指标	`Impression share`	是
`searchRankLostTopImpressionShare`	估算您的广告因广告评级较低而未能在自然搜索结果上方任意位置展示的频率。	指标	`Impression share`	是
`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`	是