文件
Data Studio:使用 AutoPSEO 資料建立報表
AutoPSEO 沒有專屬的 Data Studio 連接器。你可以改用 Google 的 Search Console 連接器、上傳 CSV,或使用透過 REST API 持續更新的 Google 試算表。
AutoPSEO 並未提供 Data Studio(Google 的儀表板工具,前身為 Looker Studio)專用的連接器,但你仍有三種方式可以在其中呈現 AutoPSEO 的數據:使用 Google 自家的 Search Console 連接器取得原始資料、上傳從 AutoPSEO 報表匯出的 CSV,或是透過排程腳本從 AutoPSEO 的 REST API 取得資料並寫入 Google 試算表。該選哪一種,取決於儀表板需要多即時,以及你需要的是 AutoPSEO 的分析結果,還是只要原始指標。
方案 1:Google 的 Search Console 連接器
Google 的連接器會直接讀取 Search Console,因此只能取得原始指標,不包含 AutoPSEO 的任何分析。根據 Google 的連接器說明文件:
- 連接器提供兩種資料表:Site Impression 與 URL Impression,每個資料來源只能使用其中一種。若要在同一份報表中同時呈現兩者,請新增兩個資料來源。
- 你至少需要具備該 Search Console 資源的檢視權限,且兩項產品必須使用同一個 Google 帳戶登入。
- Site Impression 涵蓋網頁、圖片、影片與新聞搜尋結果;URL Impression 則額外包含 Discover 與 Google News。
新增方式:選擇 建立 → 資料來源 → Search Console,選取網站、資料表與預設搜尋類型,然後按一下 連線。
方案 2:上傳 AutoPSEO 匯出的 CSV
若是一次性或每月更新的儀表板,可以從任一報表匯出資料表(匯出資料),再透過 Data Studio 的 CSV 檔案上傳連接器加入。Google 的上傳需求決定了匯出時該如何設定:
- 欄位必須以逗號分隔,因此請先將 帳戶 → CSV 匯出格式 設為 標準 (US / UK)。
- 檔案必須為 UTF-8 編碼並包含標題列,AutoPSEO 匯出的檔案皆符合此條件。
- 加入同一資料集的每個檔案,其欄位與欄位順序都必須完全相同,因此每次都要匯出同一份報表,並使用相同的欄位與比較設定。
- 新檔案會直接附加到資料集,且不會移除重複資料,因此請勿上傳日期範圍重疊的檔案。
- 單一檔案上限為 100 MB,每位使用者的上傳儲存空間為 2 GB。
百分比會以含百分號的格式匯出(27.03%),因此上傳後請確認各欄位的資料類型。
方案 3:透過 REST API 更新的 Google 試算表
若希望儀表板自動保持最新,可以讓排程工作把 AutoPSEO 的數據寫入 Google 試算表,再將該試算表連接到 Data Studio。每當報表發出查詢時,Google 的試算表連接器都會檢查是否有變更的數值與新增的列。
- 在 AutoPSEO 中開啟 MCP & API,建立一組權限範圍為 唯讀 的 API 金鑰。金鑰只會顯示一次,請將它存放在排程工作的機密設定中。
- 由排程工作(Google Apps Script、cron 工作或工作流程工具皆可)呼叫 REST API,並將資料列寫入試算表。
- 在 Data Studio 中,使用 Google 試算表連接器加入該試算表,並勾選 使用第一列做為標題。
以下是取得近 28 天熱門查詢的呼叫範例:
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."
每個回應皆為 JSON,結果位於 data 之下,呼叫的詳細資訊則位於 meta 之下。REST API 提供的 19 項 Search Console 與 GA4 工具,與 MCP 伺服器完全相同:資源、搜尋分析資料列、熱門查詢、頁面與國家/地區、期間比較、排名變動、新增與流失的排名、內容衰退、關鍵字自我競爭、CTR 基準、頁面搶排名、URL 檢查、網站地圖、註解,以及 GA4 總覽、細項分析與關鍵事件。熱門查詢與熱門頁面最多回傳 1,000 列,熱門國家/地區最多 300 列,而 search-analytics 在使用一到兩個維度時,最多可回傳 5,000 列原始資料。每組金鑰每分鐘限呼叫 60 次,每個帳戶每小時限 1,000 次;https://app.autopseo.com/v1/openapi.json 提供的 OpenAPI 3.1 文件則說明了每一個參數。
如何選擇
| 你的需求 | 建議方案 |
|---|---|
| 由 Google 持續更新的原始點擊與曝光資料 | Google 的 Search Console 連接器 |
| 某份 AutoPSEO 報表的每月快照 | 上傳 CSV |
| 定期取得 AutoPSEO 的分析結果,例如排名變動或內容衰退 | 透過 REST API 更新的 Google 試算表 |
如果建立儀表板的主要目的只是向客戶呈現數據,那麼分享報表連結或排程發送的 Slack 或 Teams 報表可能更省事。我們的常見問題〈在 Looker Studio 中使用 Search Console〉對 Google 的連接器有更深入的說明。