广告组级定位条件的效果指标,其中包括地理位置定位条件、动态广告定位条件、再营销名单定位条件、年龄/性别定位条件和未分类定位条件。某些定位条件仅适用于特定类型的引擎账号。
只有异步请求(即通过 Reports.request() 方法)。
请求摘录
      发送普通
      Reports.request()
      请求正文,但请指定 "reportType": "adGroupTarget"。
    
{
...
  "reportType": "adGroupTarget",
  "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 | 是 | 
| account | 引擎账号名称。 | 属性 | String | 是 | 
| accountId | DS 引擎账号 ID。 | 属性 | ID | 是 | 
| accountEngineId | 外部引擎账号中账号的 ID。 | 属性 | String | 是 | 
| accountType | 引擎账号类型: Google AdWords、Bing Ads、Yahoo Japan Listing Ads、Yahoo Search Marketing、Yahoo Gemini、Baidu或Comparison Shopping。 | 属性 | Engine type | 是 | 
| campaign | 广告系列名称。 | 属性 | String | 是 | 
| campaignId | DS 广告系列 ID。 | 属性 | ID | 是 | 
| campaignStatus | 包含此项目的广告系列的状态。 | 属性 | Status | 是 | 
| adGroup | 广告组名称。 | 属性 | String | 是 | 
| adGroupId | DS 广告组 ID。 | 属性 | ID | 是 | 
| adGroupStatus | 包含此项目的广告组的状态。 | 属性 | Status | 是 | 
| engineRemarketingList | 与定位条件相关联的再营销名单的名称。 | 属性 | String | 是 | 
| engineRemarketingListBidModifier | 与定位条件相关的出价调整。 | 属性 | Number | 是 | 
| dynamicSearchAdsTargetConditions | 动态广告定位条件在选择网站网域下的网页时所使用的条件。 | 属性 | String | 否 | 
| dynamicSearchAdsTargetCpcBid | 动态广告定位条件的最高每次点击费用设置。 | 属性 | Money | 是 | 
| dynamicSearchAdsTargetLandingPageUrl | 动态广告定位条件的网址模板。 | 属性 | String | 是 | 
| dynamicSearchAdsTargetCoverage | 广告客户网站上与动态广告定位条件相匹配的网页所占的百分比。 | 属性 | Number | 是 | 
| locationTargetName | 地理位置定位目标的名称。 | 属性 | String | 是 | 
| locationTargetBidModifier | 与地理位置定位目标相关联的出价调整。 | 属性 | Number | 是 | 
| ageTargetAgeRange | 目标年龄段的年龄段。 | 属性 | Age range | 是 | 
| ageTargetBidModifier | 与年龄定位条件相关的出价调整。 | 属性 | Number | 是 | 
| genderTargetGenderType | 性别定位条件的性别类型:男性、女性、未知。 | 属性 | Gender type | 是 | 
| genderTargetBidModifier | 与性别定位条件相关联的出价调整。 | 属性 | Number | 是 | 
| unclassifiedTargetName | 未分类定位条件的名称。 | 属性 | String | 是 | 
| unclassifiedTargetType | 未分类定位条件的类型: Dynamic search。 | 属性 | Unclassified target type | 是 | 
| adGroupTargetId | DS 为广告组定位条件生成的 ID。 | 属性 | ID | 是 | 
| 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 | 是 | 
| 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 | 是 | 
