报告类型: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。 您还可以视需要指定 headerText、 startDate, 和 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 AdWords、Bing Ads、Yahoo Japan Listing Ads、Yahoo Search Marketing、Yahoo Gemini、Baidu 或 Comparison 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 是