广告系列的效果指标和配置属性。
此报告只能通过异步请求(即通过 Reports.request() 方法)返回。
请求摘录
请发送常规 Reports.request() 请求正文,但指定 "reportType": "campaign"
。
{ ... "reportType": "campaign", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName
。您还可以选择指定 headerText、startDate 和 endDate。
请注意,某些列无法过滤;请参阅下表中的“可过滤”。
columnName | 说明 | 行为 | 类型 | 可过滤 |
---|---|---|---|---|
status |
campaignStatus 属性的别名。 |
特性 | Status |
兼容 |
engineStatus |
广告系列在外部引擎帐号中的其他状态。可能的状态(取决于外部帐号类型)包括 disapproved 、budget constrained 等。 |
特性 | 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 |
广告系列的状态:Active 、Paused 或 Removed 。请注意,广告系列、广告组、关键字、广告和定位条件都有自己的状态。请参阅状态。 |
特性 | Status |
兼容 |
campaignEngineId |
外部引擎帐号中的广告系列的 ID。 | 特性 | ID |
兼容 |
campaignStartDate |
广告系列的开始日期。 | 特性 | Date |
兼容 |
campaignEndDate |
广告系列的结束日期。 | 特性 | Date |
兼容 |
bingAdsBudgetType |
如何控制 Bing Ads 广告系列的预算:Daily budget 、Monthly even spend 、Monthly accelerated spend 、Daily accelerated spend 或 Daily even spend 。 |
特性 | Microsoft Advertising budget type |
兼容 |
dailyBudget |
广告系列的每日预算。 | 特性 | Money |
兼容 |
monthlyBudget |
广告系列的每月预算。 | 特性 | Money |
兼容 |
deliveryMethod |
广告系列的预算投放方式:Standard 或Accelerated 。 |
特性 | Budget delivery method |
兼容 |
adWordsBidStrategy |
Google Ads 用于此广告系列的出价策略:Manual cpc 、Manual cpm 、Percent cpa 、Budget optimizer 或 Conversion optimizer 。使用 DS 出价策略的广告系列会设为Manual cpc 或Manual cpm 。 |
特性 | AdWords bid strategy |
兼容 |
yahooJapanBidStrategy |
Yahoo!JAPAN 对此广告系列使用:Manual cpc 或 Budget optimizer 。使用 DS 出价策略的广告系列设为了“Manual cpc ”。 |
特性 | Yahoo! JAPAN bid strategy |
兼容 |
keywordNearMatchEnabled |
是否为广告系列启用了关键字“近似匹配”:Enabled 或 Disabled 。 |
特性 | Keyword match setting |
兼容 |
campaignMobileBidAdjustment |
针对移动设备调整出价。例如,0.2 表示增加 20%,因此移动设备出价是默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 特性 | Number |
兼容 |
campaignTabletBidAdjustment |
针对平板电脑调整出价的百分比。例如,0.2 表示增加 20%,因此平板电脑出价是默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 特性 | Number |
兼容 |
campaignDesktopBidAdjustment |
桌面设备出价的调整百分比。例如,0.2 表示增加 20%,因此桌面设备出价是默认出价的 1.2 倍。有效值的范围因外部引擎而异。 | 特性 | Number |
兼容 |
networkTarget |
广告系列将投放到的广告网络类型。 | 特性 | String |
否 |
yahooGeoTargets |
Yahoo Search Marketing 广告系列的地理位置定位。请参阅下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
campaignLabels |
直接分配给此广告系列的标签名称;不包含继承的标签。 | 特性 | String list |
兼容 |
campaignType |
表示广告系列的类型:Manual 、Inventory 、Inventory - PLA 、Shopping 、Comparison shopping 、Mobile app install 、Universal app 或 Smart shopping 。 |
特性 | Campaign type |
兼容 |
effectiveBidStrategyId |
分配给此实体或由此实体继承的出价策略的 DS ID。 | 特性 | ID |
兼容 |
effectiveBidStrategy |
分配给此实体或由此实体继承的出价策略的名称。 | 特性 | String |
兼容 |
bidStrategyInherited |
指明是否沿用此实体的出价策略。 | 特性 | Boolean |
兼容 |
deviceTargets |
广告系列一级的设备定位条件;Desktop 、Mobile 、Tablet 或 Other 的组合。 |
特性 | String |
否 |
effectiveDeviceTargets |
广告系列一级的设备定位条件;Desktop 、Mobile 、Tablet 或 Other 的组合。 |
特性 | String |
否 |
languageTargets |
广告系列级的语言定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
countryTargets |
广告系列中包含的目标国家/地区。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
provinceTargets |
广告系列中包含的省/自治区/直辖市定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
metroTargets |
广告系列中包含的都市圈定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
cityTargets |
广告系列中包含的城市定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
effectiveCountryTargets |
广告系列中包含的目标国家/地区。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
effectiveProvinceTargets |
广告系列中包含的省/自治区/直辖市定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
effectiveMetroTargets |
广告系列中包含的都市圈定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
effectiveCityTargets |
广告系列中包含的城市定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
excludedCountryTargets |
国家/地区定位条件已从广告系列中排除。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
excludedProvinceTargets |
省/直辖市/自治区定位条件已从广告系列中排除。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
excludedMetroTargets |
都市圈定位条件已从广告系列中排除。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
excludedCityTargets |
从广告系列中排除了城市定位条件。下载上传模板和地理位置/语言代码。 | 特性 | String |
否 |
effectiveLabels |
沿用或直接分配给此广告系列的所有标签的名称。 | 特性 | String list |
兼容 |
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 |
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 |
兼容 |
searchImpressionShare |
仅适用于 Google Ads 和 Bing Ads。您在搜索网络中实际获得的展示次数除以您有资格获得的展示次数估算值所得到的百分比。以 0.1 到 1 之间的数字返回,如果比值小于 0.1,则返回字符串 < 10% 。 |
指标 | Impression share |
兼容 |
searchBudgetLostImpressionShare |
仅适用于 Google Ads 和 Bing Ads。广告因预算不足而未能在搜索网络上获得的展示次数所占的百分比。以 0 到 0.9 之间的数字返回;如果比值大于 0.9,则返回字符串 > 90% 。 |
指标 | 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 |
兼容 |
displayBudgetLostImpressionShare |
仅限 Google Ads。广告因预算不足而未能在展示广告网络上获得的展示次数所占的百分比。以 0 到 0.9 之间的数字返回;如果比值大于 0.9,则返回字符串 > 90% 。 |
指标 | Impression share |
兼容 |
displayRankLostImpressionShare |
仅限 Google Ads。广告因广告评级不佳而未能在展示广告网络上获得的展示次数所占的百分比。以 0 到 0.9 之间的数字返回;如果比值大于 0.9,则返回字符串 > 90% 。 |
指标 | Impression share |
兼容 |
qualityScoreAvg |
仅适用于 Google Ads 和 Bing Ads。报表范围内所有日期和关键字引擎质量得分 (QS) 的按展示次数加权的平均值。 | 指标 | Number |
兼容 |
topOfPageBidAvg |
仅限 Google Ads。此列可以估算出在报表时间范围内广告需要经常显示在搜索结果上方页首位置所需的平均 CPC 出价。 | 指标 | Money |
兼容 |
absoluteTopImpressionPercentage |
在自然搜索结果上方作为头条广告进行展示的次数所占百分比。 | 指标 | Impression share |
兼容 |
searchAbsoluteTopImpressionShare |
您在绝对页首(自然搜索结果上方的首条广告)获得的展示次数除以您有资格获得的估算页首展示次数所得到的百分比。 | 指标 | Impression share |
兼容 |
topImpressionPercentage |
广告在自然搜索结果上方任意位置进行展示的次数所占百分比。 | 指标 | Impression share |
兼容 |
searchTopImpressionShare |
您在顶部位置(自然搜索结果上方的任意位置)实际获得的展示次数除以您有资格获得的预估展示次数所得到的百分比。 | 指标 | Impression share |
兼容 |
searchBudgetLostAbsoluteTopImpressionShare |
估算您的广告因预算不足而未能在自然搜索结果上方作为首条广告进行展示的频率。 | 指标 | Impression share |
兼容 |
searchBudgetLostTopImpressionShare |
帮助您了解广告因预算不足而未能在自然搜索结果上方任意位置展示的频率。 | 指标 | 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 |
兼容 |