跳至內容

什麼是 Google Search Console 的大量資料匯出?

成效報表與資料

大量資料匯出是 Search Console 的一項設定,每天會將資源的成效資料傳送到你自己 Google Cloud 專案中的 BigQuery 資料集。它包含 Search Console 擁有的每一列資料,罕見查詢也會以不含查詢文字的資料列形式保留,而且不受 16 個月的限制:資料會持續累積,直到你自行刪除為止。匯出只會從你啟用的那一天開始,超出 BigQuery 免費用量的儲存空間與查詢費用則由你負擔。

它能提供報表和 API 做不到的哪些功能

成效報表Search Analytics API大量資料匯出
資料列數每個表格或匯出檔 1,000 列每種搜尋類型每天最多 50,000 列所有資料列
歷史資料16 個月16 個月從設定當天開始,保留到你刪除為止
罕見(匿名化)查詢不顯示於表格,但計入總計同左以空查詢的資料列形式保留
費用免費不產生 Cloud 帳單,但有配額限制BigQuery 儲存與查詢費用
所需投入無程式碼與 OAuthCloud 專案與 SQL

開始之前

  • 你需要擁有 Search Console 資源的擁有者權限。
  • 你需要一個已啟用計費功能的 Google Cloud 專案。
  • 在該專案中,前往 API 和服務 > 已啟用的 API 和服務,啟用 BigQuery API 和 BigQuery Storage API。

如何設定大量資料匯出

  1. 在 Cloud 控制台中,開啟 IAM 與管理,然後選擇授予存取權。
  2. 新增主體 search-console-data-export@system.gserviceaccount.com,並指派兩個角色:BigQuery 工作使用者和 BigQuery 資料編輯者,然後儲存。
  3. 在 Search Console 中,開啟設定 > 大量資料匯出。
  4. 輸入 Cloud 專案 ID(不是專案編號)。
  5. 選擇資料集名稱。預設為 searchconsole,所有名稱都必須以此開頭,且匯出到同一專案的每個資源都需要各自的資料集。
  6. 請謹慎選擇資料集位置:匯出開始後,Google 不支援變更位置。
  7. 選擇繼續。第一次匯出會在 48 小時內送達,內容涵蓋執行當天的資料。

資料表建立後,你可以設定分區到期時間(14 天或更長)來限制儲存空間。請勿新增或修改欄位:結構描述一旦變更,匯出就會失敗。

BigQuery 中會有哪些資料

  • searchdata_site_impression:依資源彙總的成效資料,與 Search Console 中圖表的總計相同。沒有 URL 欄位。
  • searchdata_url_impression:依 URL 彙總,每種搜尋外觀各有一個欄位(例如 is_job_listing),另有 is_anonymized_discover 標記。
  • ExportLog:每個資料表每次成功匯出會新增一列。每當 Google 以修正後的資料重寫某一天的資料時,其 epoch_version 就會增加。

日期採用太平洋時間。資料列並未預先彙總,因此計算指標時一律要使用 SUM()。排名位置從零開始並以加總方式儲存,所以平均排名在網站資料表中是 SUM(sum_top_position) / SUM(impressions) + 1,在 URL 資料表中則改用 sum_position,公式相同。

以下是查詢上個月熱門網頁搜尋查詢的入門範例:

SELECT
  query,
  SUM(clicks) AS clicks,
  SUM(impressions) AS impressions,
  SUM(sum_top_position) / SUM(impressions) + 1 AS avg_position
FROM `your-project.searchconsole.searchdata_site_impression`
WHERE data_date BETWEEN '2026-09-01' AND '2026-09-30'
  AND search_type = 'WEB'
  AND query != ''
GROUP BY query
ORDER BY clicks DESC
LIMIT 100

請務必以 data_date 篩選。資料表依日期分區,因此日期篩選條件才能避免每次查詢都掃描(並計費)你的整個歷史資料。

限制與失敗情況

  • 不會回溯。 設定之前的資料,只能透過 API 或報表取得。
  • 失敗會中斷匯出。 發生錯誤後,Search Console 會在隔天重試,並將尚未匯出的資料保留約一週。連續失敗約一個月後,就會完全停止匯出。匯出失敗或恢復時,擁有者和完整使用者會收到電子郵件通知。
  • 缺漏可能無法補回。 Google 的資料異常頁面記載,部分資源的匯出缺少 2026 年 2 月 28 日和 3 月 1 日的資料,且無法復原。建議定期將 ExportLog 與日曆比對。
  • 停止匯出。 在設定頁面中選擇停用匯出,匯出會在 24 小時內停止。現有的資料表會保留在 BigQuery 中。

你需要它嗎?

如果你需要每一筆長尾查詢、每個 URL 的搜尋外觀標記,或要與公司其他資料進行 SQL 聯結,那麼答案是需要。如果你主要是想在一般報表中查看超過 16 個月的歷史資料,AutoPSEO 的已儲存資源就能做到,而且不需要 Cloud 專案:開啟完整儲存後,它會回填 16 個月的資料,之後每天為網頁搜尋儲存最多 25,000 列查詢、頁面以及查詢加頁面的資料,最長保留十年。這比所有資料列少,但對大多數網站來說已綽綽有餘。請參閱管理、Search Console 會保留資料多久以及 Search Console API。

資料來源:Google 的大量資料匯出總覽、設定、監控、資料表參考以及範例查詢。

讓你的 SEO 內容自動運行

連結 Search Console 與你的網站,AutoPSEO 會立即掃描並規劃首批主題。無需信用卡。