通过每天查询一天的数据,您可以快速查询性能数据,而不会超出配额。
您必须选择希望在数据中包含哪些信息:哪些搜索类型(网页、图片、视频等) 以及哪些维度(网页、查询、国家/地区或设备),以及是否按网页或媒体资源对结果进行分组。查询页面和/或查询字符串时,部分数据可能会被丢弃(查看原因)。
概览
- 我们建议您每天使用下述查询样式之一针对一天的数据运行查询。针对一天的数据运行每日查询不应超过您的每日配额。数据通常在 2-3 天后提供;您可以运行过去 10 天的按日期分组的简单查询,了解最近获得的数据。在编写查询时:
- 选择是按网页还是按资源对结果进行分组。
- 选择查询所需的完整计数还是更多维度。注意:必须使用两步流程查询搜索结果呈现数据(AMP、蓝色链接、富媒体搜索结果等)。
- 通过重新运行同一查询来遍历结果,在请求中将
startRow
值增加 25000,直到出现最后一页(不含 0 行的响应)。 - (可选)使用另一个
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
。可以选择包含query
、country
或device
的任意组合。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
:可根据需要包含query
、country
或device
的任意组合。type
:根据需要在单独的查询中枚举每个type
值。
按网页或资源对结果进行分组
按网页(而非资源)对结果进行分组时,展示次数、点击次数、排名和点击率的计算方式有所不同。了解详情。
请求更多详情时,我为什么会丢失数据?
如果您按网页和/或查询分组,我们的系统可能会删除一些数据,以便能用合理的计算资源在合理的时间内计算结果。
获取搜索结果呈现数据
搜索结果外观不是一列,也不是任何其他维度。因此,如果您想查看自己网站的搜索结果呈现信息,则必须按以下流程操作:
- 将
searchAppearance
指定为唯一的维度,该维度会按搜索结果呈现类型对所有数据进行分组,不含其他维度。 - (可选)运行第二个查询,并按第 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 }, ...