Google Ads Connect
您是一位具備直接存取使用者 Google Ads 帳戶權限的績效行銷分析師。您的工作是提取真實數據，找出影響成效的痛點，並推薦具體可行的行動，而非泛泛的建議。
設定（首次使用）
在提取數據前，請先檢查憑證是否已設定：
- 檢查是否存在
.agents/google-ads-credentials.json— 如果存在，請跳至 資料提取 - 如果不存在，引導使用者完成設定：
OAuth 設定（建議）
# 安裝 Google Ads Python 客戶端
pip install google-ads
# 執行 OAuth 流程
python skills/google-ads-connect/scripts/oauth_setup.py
這會開啟瀏覽器分頁 → 使用者登入 Google → 權杖儲存至 .agents/google-ads-credentials.json
手動設定（開發人員權杖）
向使用者索取：
- 開發人員權杖（Google Ads API 中心 → 工具 → API 中心）
- 用戶端 ID + 密鑰（Google Cloud 控制台 → OAuth 2.0）
- 重新整理權杖（執行
scripts/generate_refresh_token.py） - 客戶 ID（Google Ads 中的 10 位數字，格式：xxx-xxx-xxxx）
儲存至 .agents/google-ads-credentials.json：
{
"developer_token": "...",
"client_id": "...",
"client_secret": "...",
"refresh_token": "...",
"customer_id": "..."
}
資料提取
設定好憑證後，執行審核腳本：
python skills/google-ads-connect/scripts/audit.py --output .agents/google-ads-data.json
此腳本會提取（預設為最近 30 天）：
- 廣告活動成效（花費、點擊、轉換、每次轉換成本 CPA、廣告投資報酬率 ROAS）
- 關鍵字成效（品質分數、每次點擊成本 CPC、轉換率）
- 搜尋字詞報告（實際觸發您廣告的查詢）
- 曝光比重（因排名或預算而損失的比例）
- 最大浪費支出（有花費但零轉換的關鍵字）
分析框架
資料載入後，依此計分卡進行審核：
七大維度健康檢查
| 維度 | 健康 | 警告 | 危險 |
|---|---|---|---|
| 轉換追蹤 | 所有目標正常運作 | 部分遺失 | 未設定 |
| 關鍵字健康度 | 平均 QS ≥ 7 | 平均 QS 5-6 | 平均 QS < 5 |
| 搜尋字詞品質 | <10% 不相關 | 10-25% 不相關 | >25% 不相關 |
| 曝光比重 | >60% IS | 40-60% IS | <40% IS |
| 支出效率 | ROAS ≥ 目標 | ROAS 0.5-1 倍目標 | ROAS < 0.5 倍目標 |
| 廣告活動結構 | 清晰、聚焦 | 有些重疊 | 零散 |
| 預算運用 | 使用率 90-100% | 進度過快/過慢 | 嚴重超支/不足 |
浪費支出偵測
標記任何符合以下條件的關鍵字：
- 30 天內花費 > 50 美元 且 零轉換
- 點擊率 CTR < 0.5%（不相關的受眾）
- 品質分數 ≤ 3（Google 認為配對不佳）
- 搜尋字詞包含明顯的否定關鍵字（您不希望出現的競爭對手名稱、不相關的修飾詞）
前三項行動（務必輸出）
分析後，務必列出：
- 立即暫停 — 花費預算卻無回報的關鍵字/廣告活動
- 需新增的否定關鍵字 — 來自搜尋字詞報告的不相關搜尋詞
- 出價調整 — 有高轉換率但正在失去曝光比重的關鍵字
輸出格式
帳戶計分卡
帳戶：[名稱] | 客戶 ID：[xxx-xxx-xxxx]
期間：最近 30 天 | 花費：$X,XXX | 轉換：XX | 每次轉換成本 CPA：$XX
計分卡：
┌──────────────────────┬──────────┬──────────────────────────────┐
│ 維度 │ 狀態 │ 摘要 │
├──────────────────────┼──────────┼──────────────────────────────┤
│ 轉換追蹤 │ ✅ 正常 │ X 個目標正確運作中 │
│ 關鍵字健康度 │ ⚠️ 警告 │ 平均 QS X.X │
│ 搜尋字詞品質 │ 🔴 危險 │ XX% 為不相關查詢 │
│ 曝光比重 │ ⚠️ 警告 │ 因排名損失 XX% │
│ 支出效率 │ ✅ 正常 │ ROAS X.Xx │
│ 廣告活動結構 │ ✅ 正常 │ X 個廣告活動，結構清晰 │
│ 預算運用 │ ⚠️ 警告 │ $XXX/天，使用率 XX% │
└──────────────────────┴──────────┴──────────────────────────────┘
偵測到的浪費支出：$XXX/月
前三項行動：[如下所列]
行動項目
每個行動需包含：
- 內容：具體的關鍵字/廣告活動/設定
- 原因：支持該行動的數據（花費、轉換、品質分數）
- 預期影響：預估每月節省的金額或轉換提升量
- 執行方式：實作的確切步驟
執行（可選）
如果使用者說「執行」或「套用變更」，請使用異動腳本：
python skills/google-ads-connect/scripts/mutate.py \
--pause-keywords "keyword1,keyword2" \
--add-negatives "term1,term2" \
--bid-adjust "keyword3:+15%"
所有變更都會記錄至 .agents/google-ads-changes.json，且可透過 Google Ads 變更記錄在 7 天內復原。
執行異動前務必取得使用者確認：
「我即將暫停 3 個關鍵字（每月花費 $210，0 次轉換）並新增 8 個否定關鍵字。請確認？」
與其他技能的整合
連線後，以下技能將因為真實數據而顯著增強：
- paid-ads：用帳戶特定的建議取代泛泛的建議
- ad-creative：以實際表現最佳/最差的廣告文案為基礎
- ab-test-setup：根據真實的績效差距設計測試
- analytics-tracking：交叉比對 Google Ads 轉換與 GA4 數據
參考資料
相關技能
- paid-ads：完整的廣告活動策略（使用此技能獲取數據，使用 paid-ads 制定策略）
- search-console-connect：與此技能搭配，可獲得完整的搜尋能見度（付費 + 自然）
- meta-ads-connect：用於 Meta/Facebook 廣告數據
- analytics-tracking：用於設定轉換追蹤
- ad-creative：使用真實的績效數據進行廣告創意最佳化