查詢每日的資料量,即可快速查詢效能資料,而且不會超過配額。
您必須選擇要納入資料中的資訊:哪些搜尋類型 (網頁、圖片、影片等) 以及指定維度 (網頁、查詢、國家/地區或裝置),以及是否要依網頁或資源將結果分組。查詢網頁和/或查詢字串時,某些資料可能會遭到捨棄 (瞭解原因)。
總覽
- 建議您使用下方所述的查詢樣式,每天執行查詢,涵蓋一天的資料。每日查詢一天的資料不應超過每日配額。系統通常需 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 方法每天最多能為每種搜尋類型 (網頁、圖片等) 顯示 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 }, ...