报告类型:广告客户

广告客户的报表数据,包括:

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

请求摘录

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

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

针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName。您还可以选择指定 headerTextstartDateendDate。 请注意,某些列无法过滤;请参阅下表中的“可过滤”。

columnName说明行为类型可过滤
status 广告客户的状态:ActivePausedRemoved 特性 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 兼容