广告组级定位条件的效果指标，包括地理位置定位条件、动态广告定位条件、再营销名单定位条件、年龄/性别定位条件和未分类定位条件。某些目标仅适用于特定类型的引擎账号。
此报告只能通过异步请求（即通过 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 |
动态广告定位条件的最高每次点击费用 (CPC) 设置。 | 属性 | 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 |
为广告组定位条件生成的 ID DS。 | 属性 | 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 |
是 |