您可以針對每天的資料量執行每日查詢,在不超出配額的情況下快速查詢效能資料。
您必須選擇您要在資料中加入哪些資訊:網頁、圖片、影片等搜尋類型。 以及哪些維度 (網頁、查詢、國家/地區或裝置),以及是否要依網頁或資源將結果分組。查詢網頁和/或查詢字串時,部分資料可能會遭到捨棄 (原因)。
總覽
- 我們建議您每天使用下方所述的查詢樣式,針對每天 1 天的資料執行查詢。針對某一天的資料執行每日查詢,不會超過每日配額。系統通常會在 2 至 3 天後提供資料;您可以查詢過去 10 天依日期分組的簡易查詢,藉此瞭解最近可用的資料。撰寫查詢:
- 選擇要依網頁或資源分組結果。
- 選擇您要在查詢中納入更完整的計數或維度。注意:您必須使用兩步驟程序來查詢搜尋外觀資料 (AMP、藍色連結、複合式搜尋結果等)。
- 重新執行相同的查詢即可瀏覽結果,並將要求中的
startRow
值提高 25,000,直到達到最後一頁 (含有 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 (分析) 方法還顯示了每種搜尋類型 (網頁、圖片等) 每天最多 50,000 列的資料 (按點擊次數排序)。
查詢詳細資料
依網頁分組
如為準確計數,您必須省略網頁和查詢維度,如下所示:
"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 }, ...