广告的效果指标和配置属性。
此报告只能通过异步请求（即通过 Reports.request() 方法）返回。
请求摘录
请发送常规 Reports.request() 请求正文，但指定 "reportType": "ad"。
{
...
"reportType": "ad",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
针对您要在报告中返回或过滤的每列，指定下表中列出的 columnName。您还可以选择指定 headerText、startDate 和 endDate。
请注意，某些列无法过滤；请参阅下表中的“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
|---|---|---|---|---|
status |
广告的状态：Active、Paused 或 Removed。请注意，广告系列、广告组、关键字和广告都有自己的状态。请参阅状态。 |
特性 | Status |
兼容 |
engineStatus |
广告在外部引擎帐号中的其他状态。可能的状态（取决于外部帐号类型）包括 active、eligible、creative deleted、creative approved family safe 等。 |
特性 | 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 |
兼容 |
adGroup |
广告组名称。 | 特性 | String |
兼容 |
adGroupId |
DS 广告组 ID。 | 特性 | ID |
兼容 |
adGroupStatus |
包含此项的广告组的状态。 | 特性 | Status |
兼容 |
ad |
广告名称。 | 特性 | String |
兼容 |
adId |
DS 广告 ID。值 0 表示未归因该广告。 | 特性 | ID |
兼容 |
adEngineId |
外部引擎帐号中的广告 ID。 | 特性 | ID |
兼容 |
isUnattributedAd |
指明此行中的指标是否无法归因于特定广告。例如，如果广告的格式不受支持或 Clickserver 网址不正确，就会阻止 DS 将指标归因于广告。 | 特性 | Boolean |
兼容 |
adHeadline |
广告标题。 | 特性 | String |
兼容 |
adHeadline2 |
广告标题 2；不适用于某些引擎。 | 特性 | String |
兼容 |
adHeadline3 |
广告标题 3；不适用于某些引擎。 | 特性 | String |
兼容 |
adDescription1 |
广告内容描述第 1 行。 | 特性 | String |
兼容 |
adDescription2 |
广告内容描述第 2 行；不适用于某些引擎。 | 特性 | String |
兼容 |
adDisplayUrl |
广告显示网址。 | 特性 | String |
兼容 |
adLandingPage |
广告着陆页。请参阅着陆页网址和 Clickserver 网址。 | 特性 | String |
兼容 |
adType |
广告类型：Text、Product、Dynamic search、Mobile app install、Call-Only、Expanded text 或 Expanded dynamic search。 |
特性 | Ad type |
兼容 |
adPromotionLine |
广告促销行。产品广告的简短促销信息。 | 特性 | String |
兼容 |
adLabels |
直接分配给此广告的标签名称；不包括继承的标签。 | 特性 | String list |
兼容 |
adPathField1 |
广告路径字段 1. 路径字段 1 和 2 与 adDisplayUrl 组合在一起，形成广告上显示的网址。 | 特性 | String |
兼容 |
adPathField2 |
广告路径字段 2. 路径字段 1 和 2 与 adDisplayUrl 组合在一起，形成广告上显示的网址。 | 特性 | String |
兼容 |
effectiveLabels |
沿用或直接分配给此广告的所有标签的名称。 | 特性 | String list |
兼容 |
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 |
兼容 |