多信號關鍵字營收歸因分析
您正在使用 BigQuery 中的 GSC 大量匯出和 GA4 匯出數據，進行關鍵字層級的營收歸因分析。輸出結果為一個可排序的 Markdown 表格，包含（查詢、頁面、意圖、點擊次數、歸因工作階段數、歸因轉換數、歸因營收、信心指數）以及簡短的摘要標題。
使用時機
當使用者想知道哪些查詢驅動了流量價值（工作階段、轉換、營收），而不僅僅是點擊次數時，觸發此技能。此方法論比標準的 ga4_gsc_query_revenue MCP 工具更細一層，因為它在分配 GA4 指標前先進行三信號（頁面 + 日期 + 裝置）連接，並套用意圖權重，讓品牌和交易查詢獲得比資訊性查詢更多的權重，最後進行重新正規化，使總計完全符合 GA4 的數據。
如果使用者只需要點擊佔比或像「我的網站為哪些關鍵字排名」這類一行式答案，請改用 ahrefs-quick-lookup 或預先建置好的 ga4_gsc_query_revenue 工具。
必要輸入
詢問缺少的參數。若使用者未指定，則使用表格中的預設值。
| 參數 | 預設值 | 說明 |
|---|---|---|
brand_terms | 必要 | 小寫陣列。第一層子字串比對。使用標準品牌形式（例如 ['snippet digital', 'snippetdigital']）。 |
brand_tokens | [] | 小寫陣列。第二層詞幹前綴標記。每個標記匹配任何單字的開頭，因此 'model' 會匹配到 'models'、'modelling'、'modeling'。建議用於多字品牌，以捕捉詞序和詞幹變體。 |
brand_min_token_matches | 2 | 查詢中必須出現多少個來自 brand_tokens 的標記，才會被視為品牌查詢。對於 2 字品牌，2 是正確的預設值。 |
brand_negative_terms | [] | 小寫陣列。第三層誤判防護。任何查詢若包含其中一個詞，絕對不會被視為品牌查詢。用於有歧義的單字品牌（例如 Apple 公司使用 ['apple pie', 'apple cider']）。 |
gsc_dataset | 必要 | 包含 searchdata_url_impression 的資料集，例如 searchconsole。 |
ga4_dataset | 必要 | GA4 匯出資料集，例如 analytics_123456789。 |
days | 28 | 從今天往前推的天數（再減 3 天，因為 GSC 有大約 3 天的延遲）。 |
min_clicks | 5 | 丟棄在時間範圍內總點擊數少於此值的查詢。 |
value_per_conversion | 0.0 | 如果 GA4 沒有貨幣價值，則為可選的固定潛在客戶價值。例如，設定為 499.0 作為固定轉換價值。 |
conversion_events | ['form_submit', 'generate_lead', 'purchase'] | 要計為轉換的 GA4 事件名稱。 |
意圖權重和意圖正則表達式也可配置（請參閱 attribution.sql 中的 DECLARE 區塊）。預設值適用於 B2B / 潛在客戶開發網站；電子商務網站可能希望將交易權重提高到 2.5。
品牌比對：如何填寫
在詢問使用者品牌詞彙時，請明確詢問兩個層級：
「您的品牌是什麼？請提供 1) 人們為您輸入的確切詞組（例如 'snippet digital'、'snippetdigital'），以及 2) 您品牌中要作為詞幹匹配的獨特單字（例如 'snippet'、'digital'）。」
對於大多數多字品牌，第二層應包含與第一層相同的單字，但拆分為個別標記。範例：
| 品牌 | brand_terms（第一層） | brand_tokens（第二層） | min |
|---|---|---|---|
| Coca-Cola | ['coca cola', 'cocacola', 'coke'] | ['coca', 'cola'] | 2 |
| Snippet Digital | ['snippet digital', 'snippetdigital'] | ['snippet', 'digital'] | 2 |
| UK Models | ['uk models', 'ukmodels'] | ['uk', 'model'] | 2 |
| Keyword Insights | ['keyword insights', 'keywordinsights'] | ['keyword', 'insights'] | 2 |
對於單字品牌（Apple、Notion、Stripe），第二層通常不需要。請改用第三層來排除誤判：
| 品牌 | brand_terms（第一層） | brand_negative_terms（第三層） |
|---|---|---|
| Apple（公司） | ['apple'] | ['apple pie', 'apple cider', 'apple fruit'] |
| Stripe（支付） | ['stripe'] | ['pin stripe', 'stripe pattern'] |
如果使用者回報說明顯與品牌相關的查詢被歸類為資訊型（例如複數或詞序變體未被捕捉到），解決方法幾乎總是新增第二層標記。
執行步驟
-
確認輸入。 如果缺少 brand_terms、gsc_dataset 或 ga4_dataset，請詢問使用者。明確確認任何不尋常的值（例如 days > 90、min_clicks > 25）。
-
探查兩個資料集是否存在。 在執行完整查詢之前，透過 BigQuery MCP
query工具執行兩個快速的探查：SELECT MAX(data_date) FROM \{gsc_dataset}.searchdata_url_impression``SELECT MAX(_TABLE_SUFFIX) FROM \{ga4_dataset}.events_*`` 如果任一探查失敗，則將確切的錯誤資訊提供給使用者並停止。不要繼續執行主查詢。
-
執行歸因查詢。 使用 BigQuery MCP
query工具，搭配attribution.sql中的 SQL，在將<<GSC_DATASET>>和<<GA4_DATASET>>替換為使用者的資料集名稱後執行。更新 DECLARE 區塊以反映使用者的 brand_terms、days、min_clicks、value_per_conversion 和 conversion_events。將max_rows設定為 200 以捕捉長尾資料。 -
呈現輸出。 將結果格式化為按歸因營收降序排序的 Markdown 表格。欄位：查詢、頁面、意圖、點擊次數、歸因工作階段數、歸因轉換數、歸因營收（含貨幣符號）、該頁面的候選查詢數、信心指數。在表格之後，撰寫：
- 2-3 句的摘要標題，總結總點擊次數、工作階段數、轉換數、營收以及品牌佔比。
- 前 3 個高信心度驅動因素（每行一個）。
- 任何值得標記的模式（例如，所有高信心度頁面但無轉換、看起來不尋常的意圖分佈、被子字串規則遺漏的品牌變體）。
-
可選：呈現視覺化圖表。 如果使用者要求儀表板、快照或螢幕截圖，請使用
show_widgetMCP 工具建立一個內嵌的 HTML 小工具。該小工具應包含：4 個指標卡片（點擊次數、工作階段數、轉換數、營收）、一個按意圖顏色編碼的前 12 大查詢歸因營收水平長條圖、一個意圖分佈的堆疊長條圖（點擊次數 vs 工作階段數 vs 營收），以及一個可排序和篩選的表格。
常見陷阱與處理方式
- 品牌詞彙被子字串規則遺漏。「uk model」不包含「uk models」。請始終主動模糊處理品牌清單：包含單數/複數、有空格和無空格、常見拼寫錯誤、內部職稱。如果您看到首頁上的資訊型查詢在原始點擊次數上排名高於品牌查詢，這幾乎總是遺漏了品牌變體。
- 營收到處都是零。 這表示 GA4 沒有填充
ecommerce.purchase_revenue或event_params.value。對於潛在客戶開發網站來說，這是正常的。要嘛接受轉換作為成功指標，要嘛傳遞value_per_conversion，這樣營收就會被估算為轉換次數 x 價值。 - 所有信心指數都是 LOW，因為一切都在首頁。 這是有效的發現，而非錯誤。首頁確實有太多候選查詢，無法乾淨地歸因。將其標記為結構性發現（「內部連結和特定主題的到達網頁可以將此歸因拆分為確定性的區塊」），而不是試圖操作分數。
- 連接率似乎很低。 GSC 和 GA4 對 URL 的正規化方式不同（尾隨斜線、查詢字串、片段）。SQL 會移除兩端的尾隨斜線和查詢字串；如果連接率仍然低於 50%，請檢查協定不匹配（http vs https）或主機名稱差異（www vs 非 www）。
- GA4 自然流量篩選器排除過多內容。 SQL 會篩選出任何事件報告
medium=organic的工作階段。如果使用者的 GA4 設定使用不同的流量來源值（例如 channel grouping 為Organic Search），請編輯ga4_sessionsCTE 中的 WHERE 子句。 - GSC 資料集在一個專案，GA4 在另一個專案。 BigQuery 跨專案查詢完全可行；只需完整限定兩個佔位符，例如
project-a.searchconsole、project-b.analytics_123456789。MCP 服務帳戶需要對兩者都有讀取權限。
輸出格式範例
## [domain] 關鍵字營收歸因，最近 28 天
**時間範圍：** 2026-04-01 至 2026-04-28
**品牌詞彙：** 「...」 | **最小點擊次數：** 5
| 查詢 | 頁面 | 意圖 | 點擊次數 | 歸因工作階段數 | 歸因轉換數 | 歸因營收 | 信心指數 |
|---|---|---|---|---|---|---|---|
| ... | ... | branded | 280 | 263.4 | 19.96 | £9,960 | HIGH |
摘要：903 次點擊、697 個歸因工作階段、39 次轉換、£19,461 營收。品牌查詢佔據 57% 的點擊次數，卻帶來 86% 的轉換。
前 3 個高信心度驅動因素
1. ...
2. ...
3. ...
模式
- ...
- ...
此技能包含的檔案
attribution.sql：參數化查詢SKILL.md：此檔案examples/synthetic_saas_demo.md：供參考的範例輸出