报告类型:campaignTarget

广告系列定位目标的效果指标,包括地理位置定位目标(地理位置、邻近区域和附加地址信息)和再营销名单定位目标。某些目标仅适用于特定类型的引擎账号。

此报告只能通过异步请求(即通过 Reports.request() 方法)返回。

请求摘要

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

{
...
  "reportType": "campaignTarget",
  "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
account 引擎账号名称。 属性 String
accountId DS 引擎账号 ID。 属性 ID
accountEngineId 外部引擎账号中的账号的 ID。 属性 String
accountType 引擎账号类型:Google AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 属性 Engine type
campaign 广告系列名称。 属性 String
campaignId DS 广告系列 ID。 属性 ID
campaignStatus 包含此项的广告系列的状态。 属性 Status
engineRemarketingList 与目标相关联的再营销名单的名称。 属性 String
engineRemarketingListBidModifier 与目标相关联的出价调整。 属性 Number
locationTargetName 营业地点目标的名称。 属性 String
locationTargetBidModifier 与地理位置定位目标相关联的出价调整。 属性 Number
campaignTargetId DS 为广告系列目标生成的 ID。 属性 ID
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
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