获取效果数据

通过每天查询一天的数据,您可以快速查询性能数据,而不会超出配额。

您必须选择希望在数据中包含哪些信息:哪些搜索类型(网页、图片、视频等) 以及哪些维度(网页、查询、国家/地区或设备),以及是否按网页或媒体资源对结果进行分组。查询页面和/或查询字符串时,部分数据可能会被丢弃(查看原因)。

概览

  1. 我们建议您每天使用下述查询样式之一针对一天的数据运行查询。针对一天的数据运行每日查询不应超过您的每日配额。数据通常在 2-3 天后提供;您可以运行过去 10 天的按日期分组的简单查询,了解最近获得的数据。在编写查询时:
    • 选择是按网页还是按资源对结果进行分组。
    • 选择查询所需的完整计数还是更多维度。注意:必须使用两步流程查询搜索结果呈现数据(AMP、蓝色链接、富媒体搜索结果等)。
  2. 通过重新运行同一查询来遍历结果,在请求中将 startRow 值增加 25000,直到出现最后一页(不含 0 行的响应)。
  3. (可选)使用另一个 type 参数运行同一查询。

以下是单个查询的伪代码示例。您可以针对要应用数据的每个 type 值每天运行一次

int maxRows = 25000; // Current max response size
int i = 0;
do {
  response = Request(startDate = 3_days_ago,
                     endDate = 3_days_ago,
                     ... add dimensions, type ...
                     rowLimit = maxRows,
                     startRow = i * maxRows);
  i++;
  …  // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows

数据量限制

除了 API 用量配额之外,针对每种搜索类型(网页、图片等,按点击排序),Search Analytics 方法每天最多公开 5 万行数据。

查询详情

您可以查询按网页或媒体资源分组的数据。

按网页分组

为了计算准确的数量,必须省略网页和查询维度,如下所示:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web",
"aggregationType": "byPage"
  • startDate / endDate:选择一个日期,方法是选择相同的日期。
  • dimensions:可以选择包含 country 和/或 device
  • type:根据需要在单独的查询中枚举每个 type
  • aggregationType:必须为 byPage

如要了解更多详情(包括网页和/或查询信息),请运行如下所示的查询:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"
  • startDate / endDate:选择一个日期,方法是选择相同的日期。
  • dimensions:包括 page。可以选择包含 querycountrydevice 的任意组合。
  • type:根据需要在单独的查询中枚举每个 type

按资源分组

为了计算准确的数量,必须省略网页和查询维度,如下所示:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"
  • startDate / endDate:选择一个日期,方法是选择相同的日期。
  • dimensions:可以选择包含 country 和/或 device
  • type:可根据需要在单独的查询中枚举每个 type

如要获取更详细的信息(包括查询、国家/地区和/或设备信息),请牺牲一些数据,运行如下查询:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"
  • startDate / endDate:选择一个日期,方法是选择相同的日期。
  • dimensions:可根据需要包含 querycountrydevice 的任意组合。
  • type:根据需要在单独的查询中枚举每个 type

按网页或资源对结果进行分组

按网页(而非资源)对结果进行分组时,展示次数、点击次数、排名和点击率的计算方式有所不同。了解详情

请求更多详情时,我为什么会丢失数据?

如果您按网页和/或查询分组,我们的系统可能会删除一些数据,以便能用合理的计算资源在合理的时间内计算结果。

获取搜索结果呈现数据

搜索结果外观不是一列,也不是任何其他维度。因此,如果您想查看自己网站的搜索结果呈现信息,则必须按以下流程操作:

  1. searchAppearance 指定为唯一的维度,该维度会按搜索结果呈现类型对所有数据进行分组,不含其他维度。
  2. (可选)运行第二个查询,并按第 1 步中列出的某个搜索结果呈现类型进行过滤,然后为该查询添加任意所需维度(页面、国家/地区、查询等)。

要检索有关多个搜索呈现类型的数据,您必须针对第 1 步中列出的每个搜索呈现类型运行第二步。

第一个查询

获取您网站上搜索结果呈现类型的列表。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

成效

您网站的类型为 INSTANT_APP、AMP_BLUE_LINK 等。

 "rows": [
  {
   "keys": [
    "INSTANT_APP"
   ],
   "clicks": 443024.0,
   "impressions": 4109826.0,
   "ctr": 0.10779629113251997,
   "position": 1.088168452873674
  },
  {
   "keys": [
    "AMP_BLUE_LINK"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090884E7,
   "ctr": 0.025152999692701676,
   "position": 7.313451603790653
  },...

第二个查询

按第 1 步中找到的某个搜索结果呈现类型,以及您喜欢的任何维度(网页、设备等)进行过滤。我们在此处按 AMP_BLUE_LINK 过滤。

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "device" // and/or page, country, ...
  ],
  "dimensionFilterGroups": [
    {
      "filters": [
        {
          "dimension": "searchAppearance",
          "operator": "equals",
          "expression": "AMP_BLUE_LINK"
        }
      ]
    }
  ]
}

成效

按设备类型细分的 AMP_BLUE_LINK

"rows": [
  {
   "keys": [
    "MOBILE"
   ],
   "clicks": 429887.0,
   "impressions": 1.7090783E7,
   "ctr": 0.025153148337323107,
   "position": 7.31339517914422
  },
  {
   "keys": [
    "DESKTOP"
   ],
   "clicks": 0.0,
   "impressions": 66.0,
   "ctr": 0.0,
   "position": 12.257575757575758
  },
...