广告组的效果指标和配置属性。
此报告只能通过异步请求（即通过 Reports.request() 方法）返回。
请求摘要
发送常规的 Reports.request() 请求正文，但指定 "reportType": "adGroup"。
{
...
"reportType": "adGroup",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
对于您希望在报告中返回或过滤的每列，请指定下表中列出的 columnName。
您还可以选择指定 headerText、startDate 和 endDate。
请注意，某些列无法过滤；请参阅下表中的“可过滤”列。
columnName | 说明 | 行为 | 类型 | 可过滤 |
|---|---|---|---|---|
status |
adGroupStatus 属性的别名。 |
属性 | Status |
是 |
engineStatus |
外部引擎账号中广告组的其他状态。可能的状态（取决于外部账号的类型）包括 eligible、campaign ended 等。 |
属性 | String |
是 |
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 |
是 |
adRotation |
广告组使用的广告投放轮播：Optimize 或 Rotate indefinitely。 |
属性 | String |
否 |
adGroup |
广告组名称。 | 属性 | String |
是 |
adGroupId |
DS 广告组 ID。 | 属性 | ID |
是 |
adGroupStatus |
广告组的状态：Active、Paused 或 Removed。请注意，广告系列、广告组、关键字、广告和目标各有各自的状态。查看状态。 |
属性 | Status |
是 |
adGroupEngineId |
外部引擎账号中的广告组的 ID。 | 属性 | ID |
是 |
adGroupStartDate |
广告组的开始日期。 | 属性 | Date |
是 |
adGroupEndDate |
广告组的结束日期。 | 属性 | Date |
是 |
adGroupSearchMaxCpc |
此广告组中搜索广告关键字的默认出价。 | 属性 | Money |
是 |
adGroupBroadMaxCpc |
此广告组中广泛匹配搜索广告关键字的默认出价（仅限 Bing Ads）。 | 属性 | Money |
是 |
adGroupExactMaxCpc |
此广告组中完全匹配关键字的默认出价（仅限 Bing Ads）。 | 属性 | Money |
是 |
adGroupPhraseMaxCpc |
此广告组中词组匹配搜索广告关键字的默认出价（仅限 Bing Ads）。 | 属性 | Money |
是 |
adGroupContentMaxCpc |
此广告组中内容关键字的默认出价。 | 属性 | Money |
是 |
adGroupMobileBidAdjustment |
移动设备出价调整百分比。例如，如果值为 0.2，则表示增加 20%，因此移动设备出价为默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 属性 | Number |
是 |
adGroupTabletBidAdjustment |
针对平板电脑调整出价的百分比。例如，0.2 表示增加 20%，因此平板电脑出价是默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 属性 | Number |
是 |
adGroupDesktopBidAdjustment |
桌面设备出价的调整百分比。例如，0.2 表示增加 20%，因此桌面设备出价是默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 属性 | Number |
是 |
adGroupType |
（仅适用于 Google Ads）表示广告组的类型：Standard、Dynamic 或 Showcase。 |
属性 | Ad group type |
是 |
bingAdsLanguage |
Bing Ads 广告组中的广告和关键字的语言。 | 属性 | Microsoft language code |
是 |
bingAdsAdDistributions |
Bing Ads 广告组使用的广告分发渠道；Search 和 Content 的组合。 |
属性 | String |
否 |
adGroupLabels |
直接分配给此广告组的标签的名称；不包括继承的标签。 | 属性 | String list |
是 |
effectiveBidStrategyId |
分配给此实体或由此实体继承的出价策略的 DS ID。 | 属性 | ID |
是 |
effectiveBidStrategy |
分配给此实体或由此实体继承的出价策略的名称。 | 属性 | String |
是 |
bidStrategyInherited |
指示此实体的出价策略是否是继承的。 | 属性 | Boolean |
是 |
deviceTargets |
广告组一级的设备定位条件；Desktop、Mobile、Tablet 或 Other 的组合。 |
属性 | String |
否 |
effectiveDeviceTargets |
广告组一级的设备定位条件，或从广告系列继承的定位条件；Desktop、Mobile、Tablet 或 Other 的组合。 |
属性 | String |
否 |
countryTargets |
广告组中包含的国家/地区目标值。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
provinceTargets |
广告组中包含的省级目标区域。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
metroTargets |
广告组中包含的都会区目标值。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
cityTargets |
广告组中包含的城市定位条件。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
effectiveCountryTargets |
广告组中包含的国家/地区目标对象，或从广告系列继承的国家/地区目标对象。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
effectiveProvinceTargets |
广告组中包含的省级目标对象，或从广告系列继承的省级目标对象。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
effectiveMetroTargets |
广告组中包含的或从广告系列继承的都会区目标。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
effectiveCityTargets |
广告组中包含的城市定位条件，或从广告系列继承的定位条件。下载上传模板和地理位置/语言代码。 | 属性 | String |
否 |
effectiveLabels |
继承或直接分配给此广告组的所有标签的名称。 | 属性 | String list |
是 |
engineRemarketingListTargetAll |
指示广告组是否仅使用再营销目标来调整出价。 可能的值：
|
属性 | Boolean |
是 |
clicksWithFeedItemShowing |
在 Feed 项展示期间点击广告中的任何链接。此列仅在 Feed 项报告或按 Feed 项列细分的报告中返回值。 | 指标 | Integer |
是 |
costWithFeedItemShowing |
在 Feed 项展示期间，所有广告的费用。此列仅在 Feed 项报告或按 Feed 项列细分的报告中返回值。 | 指标 | Money |
是 |
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 |
是 |
searchImpressionShare |
仅限 Google Ads 和 Bing Ads。您在搜索网络中实际获得的展示次数除以您有资格获得的展示次数估算值所得到的百分比。返回值为介于 0.1 和 1 之间的数字，如果份额低于 0.1，则返回字符串 < 10%。 |
指标 | 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 |
是 |
displayRankLostImpressionShare |
仅限 Google Ads。广告因广告评级不佳而未能在展示广告网络上获得的展示次数所占的百分比。返回值为介于 0 和 0.9 之间的数字，如果份额大于 0.9，则返回字符串 > 90%。 |
指标 | Impression share |
是 |
qualityScoreAvg |
仅限 Google Ads 和 Bing Ads。针对报告范围内的所有天数和关键字，按展示次数加权得出的引擎质量得分 (QS) 的平均值。 | 指标 | Number |
是 |
topOfPageBidAvg |
仅限 Google Ads。大致估算的是，在报告所涵盖的时间范围内，要让您的广告经常出现在搜索结果上方的前列位置，您可能需要支付的每次点击费用出价的平均值。 | 指标 | Money |
是 |
absoluteTopImpressionPercentage |
显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | 指标 | Impression share |
是 |
searchAbsoluteTopImpressionShare |
您实际获得的绝对页首（自然搜索结果上方的首条广告）展示次数除以您有资格获得的估算页首展示次数所得的百分比。 | 指标 | Impression share |
是 |
topImpressionPercentage |
广告在自然搜索结果上方任意位置展示的次数所占百分比。 | 指标 | Impression share |
是 |
searchTopImpressionShare |
您在热门位置（自然搜索结果上方的任意位置）获得的展示次数相较于您有资格在热门位置获得的估算展示次数。 | 指标 | 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 |
是 |
sitelinkDisplayText |
按站内链接对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个站内链接。此列会返回每行的站内链接显示文本。 | 细分 | String |
是 |
sitelinkDescription1 |
按站内链接对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个站内链接。此列会返回每行的站内链接广告内容描述 1。 | 细分 | String |
是 |
sitelinkDescription2 |
按站内链接对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个站内链接。此列会返回每行的站内链接广告内容描述 2。 | 细分 | String |
是 |
sitelinkLandingPageUrl |
按站内链接对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个站内链接。此列会返回每行站内链接的着陆页网址。 | 细分 | String |
是 |
sitelinkClickserverUrl |
按站内链接对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个站内链接。此列会返回每行站内链接的 Clickserver 网址。 | 细分 | String |
是 |
locationBusinessName |
按与商家资料账号相关联的升级版附加地址信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个有指标可用的营业地点。此列会针对每行返回相应营业地点的商家名称。 | 细分 | String |
是 |
locationCategory |
按与商家资料账号相关联的升级版附加地址信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个有指标可用的营业地点。此列会针对每行返回相应位置的类别。 | 细分 | String |
是 |
locationDetails |
按与商家资料账号相关联的升级版附加地址信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个有指标可用的营业地点。此列会返回每行相应位置的详细信息。 | 细分 | String |
是 |
locationFilter |
按与商家资料账号相关联的升级版附加地址信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个有指标可用的营业地点。此列会为每行返回相应位置的过滤条件。 | 细分 | String |
否 |
callPhoneNumber |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。此列会返回来电号码附加信息的电话号码。 | 细分 | String |
是 |
callCountryCode |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。此列会返回每行电话号码附加信息的国家/地区代码。 | 细分 | String |
是 |
callIsTracked |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。如果系统会跟踪来电扩展的来电，则此列会返回 true；否则，返回 false。 | 细分 | Boolean |
是 |
callCallOnly |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。如果附加电话信息仅显示电话号码，则此列会返回 true；如果附加电话信息同时显示电话号码和链接，则会返回 false。 | 细分 | Boolean |
是 |
callConversionTracker |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。此列会返回与 Feed 项关联的转化跟踪广告代码的名称（如果有）。 | 细分 | String |
是 |
callConversionTrackerId |
按附加电话信息对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个附加电话信息。此列会返回与来电扩展关联的转化跟踪广告代码的 ID（如果有）。 | 细分 | ID |
是 |
appId |
按应用扩展程序对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个应用扩展程序。此列会返回应用 ID（如果有）。 | 细分 | String |
是 |
appStore |
按应用扩展程序对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个应用扩展程序。此列会返回应用商店类型（Apple App Store、Google Play 商店），如果有的话。 | 细分 | App store |
是 |
feedItemId |
按 Feed 项对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个 Feed 项。此列会返回每行的 DS Feed 项行 ID。 | 细分 | ID |
是 |
feedId |
按 Feed 项对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个 Feed 项。此列会返回每行的 DS Feed 表 ID。 | 细分 | ID |
是 |
feedType |
按 Feed 项对报告进行细分；每行及其汇总指标都会拆分为多行，每行对应一个 Feed 项。此列会返回每行 Feed 项的类型。 | 细分 | Feed type |
是 |