报告类型：广告客户

广告客户的报表数据，包括：

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

请求摘录

发送普通 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`	跨环境 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`	是
`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。此列可以估算出在报表时间范围内要让广告定期显示在搜索结果上方页首位置所需的平均 CPC 出价。	指标	`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`	是