报告类型:paidAndorg

paidAndorganic 报告可显示触发过您的广告在 Google 上展示和/或触发 Google 针对您的网站显示非付费(自然)搜索结果的搜索字词。如果您已为要针对其生成报表的引擎账号设置了付费搜索和自然搜索报表,则报表只会返回结果。

只有异步请求(即通过 Reports.request() 方法)。

请求摘录

发送普通 Reports.request() 请求正文,但请指定 "reportType": "paidAndOrganic"

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

对于您想在报告中返回或过滤的每一列, 指定下表中列出的 columnName。 您还可以视需要指定 headerTextstartDate, 和 endDate。 请注意,有些列无法过滤;指“可过滤”。

columnName说明行为类型可过滤
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
searchQuery Google 用户输入的搜索字词。 属性 String
serpType

Google 用户点击的搜索结果的类型。

可能的值包括:

  • 仅涵盖自然搜索:输入此查询的用户仅点击了未付费的搜索结果。
  • 仅限付费搜索:输入此查询的用户仅点击了广告。
  • 付费搜索和自然搜索:一些输入此查询的用户点击了未付费的搜索结果,另一些用户点击了广告(某些用户可能两者都点击了)。
属性 SERP type
paidClicks 用户在输入 searchQuery 后点击广告的次数。 指标 Integer
organicClicks 用户在输入 searchQuery 后,您网站的非付费搜索结果获得的点击次数。 指标 Integer
paidAndOrganicClicks 用户在输入 searchQuery 后,点击您的某个广告或您网站的非付费搜索结果的次数。 指标 Integer
paidImpressions 用户在输入搜索查询后,广告在搜索结果页或 Google 广告网络网站上展示的次数。 指标 Integer
organicQueries 用户输入 searchQuery 并至少看到您网站上一条自然搜索结果的总次数。 指标 Integer
paidAndOrganicQueries 用户输入 searchQuery 并看到您的至少一个广告或您网站中的至少一个自然搜索结果的总次数。 指标 Integer
paidCtr 广告的点击率,即用户在输入 searchQuery 后,看到您的广告并最终点击广告的频率。 指标 Number
organicCtr 显示看到您网站的非付费搜索结果的用户最终点击非付费结果并进入您网站的比率。 指标 Number
paidAndOrganicCtr 是指在看到您的某个广告或您网站的非付费搜索结果的用户中,点击其中任一广告或进入您网站的比率。 指标 Number
paidAvgPos 用户输入 searchQuery 后广告获得的平均排名。 指标 Number
organicAvgPos 您网站的非付费搜索结果的平均最高排名。 指标 Number
paidCostPerClick 广告的平均每次点击费用。指每次有人点击您的广告时您需要支付的平均金额。 指标 Money
date 按天细分报告;每行及其汇总指标都会拆分为多行,每一天对应一行。此列会返回各行的日期。 细分 Date
monthStart 按月份细分报表;每行及其汇总指标都会拆分为多行,每行对应一个月份。此列会返回各行相应月份的第一天。 细分 Date
monthEnd 按月份细分报表;每行及其汇总指标都会拆分为多行,每行对应一个月份。此列会返回每行所在月份的最后一天。 细分 Date
quarterStart 按季度细分报告;每行及其汇总指标都会拆分为多行,每季度占一行。此列会返回每行相应季度的第一天。 细分 Date
quarterEnd 按季度细分报告;每行及其汇总指标都会拆分为多行,每季度占一行。此列会返回每行相应季度的最后一天。 细分 Date
weekStart 按周(从星期日到星期六)将报表细分;每行及其汇总指标都会拆分为多行,每一行对应一个星期。此列会返回每行的第一天(星期日)。 细分 Date
weekEnd 按周(从星期日到星期六)将报表细分;每行及其汇总指标都会拆分为多行,每一行对应一个星期。此列会返回每行的最后一天(星期六)。 细分 Date
yearStart 按年细分报告;每行及其汇总指标都会拆分为多行,每一行对应一年。此列返回每行当年的第一天。 细分 Date
yearEnd 按年细分报告;每行及其汇总指标都会拆分为多行,每一行对应一年。此列返回每行当年的最后一天。 细分 Date
campaign 按广告系列细分报告;每行及其汇总指标都会拆分为多行,报告范围内的每个广告系列分别对应一行。此列会返回广告系列名称。 细分 String
campaignId 按广告系列细分报告;每行及其汇总指标都会拆分为多行,报告范围内的每个广告系列分别对应一行。此列会返回 DS 广告系列 ID。 细分 ID
adGroup 按广告组细分报告;每行及其汇总指标都会拆分为多行,报告范围内的每个广告组分别对应一行。此列会返回广告组名称。 细分 String
adGroupId 按广告组细分报告;每行及其汇总指标都会拆分为多行,报告范围内的每个广告组分别对应一行。此列会返回 DS 广告组 ID。 细分 ID
keywordId 按关键字细分报告;每行及其汇总指标都会拆分为多行,报告范围中的每个关键字各占一行。此列会返回 DS 关键字 ID。 细分 ID
keywordMatchType 按关键字细分报告;每行及其汇总指标都会拆分为多行,报告范围中的每个关键字各占一行。此列会返回关键字匹配类型。 细分 Match type
keywordText 按关键字细分报告;每行及其汇总指标都会拆分为多行,报告范围中的每个关键字各占一行。此列会返回关键字文字。 细分 String