报告类型:关键字

关键字的效果指标和配置属性。

此报告只能通过异步请求(即通过 Reports.request() 方法)返回。

请求摘录

请发送常规 Reports.request() 请求正文,但指定 "reportType": "keyword"

{
...
  "reportType": "keyword",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

针对您要在报告中返回或过滤的每列,指定下表中列出的 columnName。您还可以选择指定 headerTextstartDateendDate。 请注意,某些列无法过滤;请参阅下表中的“可过滤”。

columnName说明行为类型可过滤
status 关键字的状态:ActivePausedRemoved。请注意,广告系列、广告组、关键字和广告都有自己的状态。请参阅状态 特性 Status 兼容
engineStatus 关键字在外部引擎帐号中的其他状态。可能的状态(取决于外部帐号类型)包括 criterion rarely servedcriterion below first page bidcriterion low quality scorereviewcampaign paused 等。 特性 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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaiduComparison Shopping 特性 Engine type 兼容
campaign 广告系列名称。 特性 String 兼容
campaignId DS 广告系列 ID。 特性 ID 兼容
campaignStatus 包含此项的广告系列的状态。 特性 Status 兼容
adGroup 广告组名称。 特性 String 兼容
adGroupId DS 广告组 ID。 特性 ID 兼容
adGroupStatus 包含此项的广告组的状态。 特性 Status 兼容
keywordId DS 关键字 ID。值 0 表示关键字未归因。 特性 ID 兼容
keywordMatchType 关键字匹配类型:BroadExactPhraseContent 特性 Match type 兼容
keywordText 关键字文本。 特性 String 兼容
keywordEngineId 外部引擎帐号中的关键字的 ID。 特性 ID 兼容
keywordMaxCpc 覆盖广告组的最高每次点击费用,并设置一个当有人点击该特定关键字的广告时,您愿意支付的最高金额。如果此字段为空,关键字将使用广告组的最高每次点击费用。 特性 Money 兼容
effectiveKeywordMaxCpc 此关键字有效的最高每次点击费用。此值与广告组的最高 CPC 相同,或者如果关键字替换了广告组的设置,则此值与关键字的最高 CPC 相同。 特性 Money 兼容
keywordLandingPage 用户点击您的广告后将会访问的最终到达网址。请参阅着陆页网址和 Clickserver 网址 特性 String 兼容
keywordClickserverUrl DS 用于跟踪活动的网址。点击广告后,系统会先访问 Clickserver 网址,然后再重定向到最终着陆页。请参阅着陆页网址和 Clickserver 网址 特性 String 兼容
isDisplayKeyword 指明这是否是用于显示展示广告和展示位置报告的占位符关键字。 特性 Boolean 兼容
keywordMaxBid 如果此关键字由 DS 出价策略管理,则出价策略的出价绝不会超过此限制。请参阅将出价策略应用于关键字 特性 Money 兼容
keywordMinBid 如果此关键字是由 DS 出价策略管理,则该出价策略的出价绝不会低于该出价。请参阅将出价策略应用于关键字 特性 Money 兼容
keywordUrlParams 着陆页中添加了额外的网址参数。请参阅添加网址参数 特性 String 兼容
bingKeywordParam2 Bing Ads 关键字的参数 2。 特性 String 兼容
bingKeywordParam3 Bing Ads 关键字的参数 3。 特性 String 兼容
keywordLabels 直接分配给此关键字的标签的名称;继承的标签不包括在内。 特性 String list 兼容
qualityScoreCurrent 仅适用于 Google Ads 和 Bing Ads。相应关键字质量得分 (QS) 的最新值。请注意,无论报表的时间范围如何,此列始终会报告关键字的最新质量得分。 特性 Integer 兼容
topOfPageBidCurrent 仅限 Google Ads。此列可以估算出要将您的广告定期显示在搜索结果上方页首位置所需的当前 CPC 出价。请注意,无论报表的时间范围如何,此列始终都会报告当前所需的每次点击费用。 特性 Money 兼容
effectiveBidStrategyId 分配给此实体或由此实体继承的出价策略的 DS ID。 特性 ID 兼容
effectiveBidStrategy 分配给此实体或由此实体继承的出价策略的名称。 特性 String 兼容
bidStrategyInherited 指明是否沿用此实体的出价策略。 特性 Boolean 兼容
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 兼容
qualityScoreAvg 仅适用于 Google Ads 和 Bing Ads。报表范围内所有日期和关键字引擎质量得分 (QS) 的按展示次数加权的平均值。 指标 Number 兼容
topOfPageBidAvg 仅限 Google Ads。此列可以估算出在报表时间范围内广告需要经常显示在搜索结果上方页首位置所需的平均 CPC 出价。 指标 Money 兼容
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 兼容
ad 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中的广告名称。 细分 String 兼容
adId 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列会返回每行中广告的 DS ID。 细分 ID 兼容
isUnattributedAd 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列表示此行中的指标是否无法归因于特定广告。 细分 Boolean 兼容
adHeadline 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中的广告标题。 细分 String 兼容
adHeadline2 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中广告的标题 2。不适用于某些引擎。 细分 String 兼容
adHeadline3 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中广告的标题 3。不适用于某些引擎。 细分 String 兼容
adDescription1 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行广告的第 1 行说明。 细分 String 兼容
adDescription2 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中广告的第 2 行说明。 细分 String 兼容
adDisplayUrl 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中广告的显示网址。 细分 String 兼容
adLandingPage 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列返回每行中广告的着陆页。 细分 String 兼容
adType 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列会返回每行中投放的广告类型:TextProduct 细分 Ad type 兼容
adPromotionLine 按广告对报告进行细分;每一行及其汇总指标都会被拆分到多行中,每个广告最多对应一行。此列会返回每行中产品广告的促销行。 细分 String 兼容