google-marketing-ops

---
name: google-marketing-ops
description: 统一处理 Google Ads / Google Analytics 4 / Google Tag Manager 三件套的配置、调试、查数据、跨工具联动、周报闭环。覆盖以下场景必须触发——Ads 任何写操作或读分析（关键词、否定词、出价、预算、campaign、搜索词、质量分、Extensions、地理定向、周报、决策日志、维护计划、ads 优化）；GA 任何查询或分析（流量来源、渠道分布、Organic/Paid Search、落地页、转化、漏斗、归因、活跃用户、实时数据、property 配置）；GTM 任何配置或调试（tag、trigger、variable、container、版本发布、预览模式、埋点验证）；跨工具联动（Ads 改完怎么验、转化数据对不上、埋点发了 GA 没收到）；环境配置（google-ads.yaml、ADC 凭据、analytics-mcp 安装、GTM OAuth、新机器初始化、setup check）。也包含「Google 工具」「营销三件套」「跑一份报表」「拉一下数据」等模糊表达，只要触及 Ads/GA/GTM 任一就走本 skill。**项目特定信息（property ID、域名、文件路径等）从 `local/project-context.md` 读取，跨项目复用时无需改本仓库。**
---

# google-marketing-ops — Google Ads / GA / GTM 三件套统一入口

本 skill 是 Google 营销工具栈的编排层。**它不重复 MCP/API 工具本身的能力描述**——三个工具的原子能力由对应的 MCP/SDK 提供。本 skill 提供：

1. **路由**：把用户意图分发到合适的 playbook
2. **组合**：告诉 AI 哪些工具配合用、按什么顺序
3. **分析**：拿到数据后下一步怎么解读，不止于"列出原始数字"

## ⚠️ 触发后第一件事：读 local/project-context.md

**任何任务（包括看似简单的"拉一份报表"）开始前，先读 `local/project-context.md`** 拿到本项目的：
- GA Property ID
- 主站/副站域名
- Ads 工具仓库路径与数据缓存位置
- GTM Container ID
- 周报/维护计划/决策日志文件路径
- W 周起点

**没有这个文件**：跳到 `playbooks/setup-check.md` 引导用户从 `local/project-context.md.example` 复制一份并填写。**不要**用本 SKILL.md 里的占位符示例值（如 `123456789`、`example.com`）去调真实 API——那会失败或拿到错的账户。

**有这个文件**：把里面的实际值替换进 playbook 的示例代码，再调 API。

## 三件套能力边界（先选对工具）

| 工具 | 入口 | 读 | 写 | 何时用 |
|---|---|---|---|---|
| **Google Ads** | `google-ads-api` skill (本地 SDK + `~/.google-ads.yaml`) | ✅ | ✅ | 关键词/否定词/出价/预算/campaign/搜索词/质量分 |
| **GA (GA4)** | `mcp__analytics-mcp__*` (stdio MCP, ADC 凭据) | ✅ | ❌ 只读 | 流量/渠道/落地页/转化/归因/实时活跃 |
| **GTM** | `mcp__gtm__*` (HTTP MCP, OAuth) | ✅ | ✅ | tag/trigger/variable/container/版本发布 |

**关键边界**：

- **改埋点 = GTM**，**看埋点效果 = GA**。Ads 改了出价想验证转化，是 GA 的事，不是 Ads 的事（Ads 后台只看自己的转化口径，GA 才能看完整漏斗）。
- **GA 不能写**——想改自定义维度/受众/事件创建规则，得走 Admin API（本 skill 暂不覆盖）或 GTM。
- **Measurement Protocol** 是发数据，不是改配置。本 skill 不覆盖。

## 任务路由（决定读哪个 playbook）

按用户意图首词优先选：

| 用户说 | 读 playbook |
|---|---|
| "新机器 / 这台电脑 / setup / 配置 / 凭据没了 / 装一下 / 接一下 GA" | `playbooks/setup-check.md` |
| "加否定词 / 暂停关键词 / 改出价 / 改预算 / 新建 campaign / 加 Extensions / 改地理定向" | `playbooks/ads-config.md` |
| "查搜索词 / 看质量分 / 拉关键词数据 / campaign 表现 / Ads 审计 / GAQL" | `playbooks/ads-analysis.md` |
| "GA / 流量 / 渠道 / 落地页 / 转化漏斗 / 归因 / 实时活跃 / 拉一下报表" | `playbooks/ga-analysis.md` |
| "GTM / tag / trigger / variable / 容器 / 发版 / 预览 / 埋点没收到" | `playbooks/gtm-debug.md` |
| "Ads 改完看效果 / 转化对不上 / 埋点是否生效 / 投放联动" | `playbooks/cross-tool-flows.md` |
| "周报 / W数字 / 维护计划 / 决策日志 / Ads 改完闭环" | `playbooks/weekly-review.md` |

**模糊场景**：
- 任务跨 2 个以上工具 → 优先 `cross-tool-flows.md`
- 不确定 → 先读 `setup-check.md` 确认本机能用哪些工具，再回头分流

## 通用原则

### 1. 数据 ≠ 答案

每次拉数据后必须做下一步分析：归因、对比、识别异常。**只列原始数字不算完成任务**。每个 playbook 的最后一段都是"分析下一步"，必读。

### 2. 写操作必须确认

Ads / GTM 的写操作（暂停 campaign、改预算、发布 GTM 版本）必须先把 diff 给用户看，确认后再执行。GA 是只读，不存在这个问题。

### 3. 凭据出问题先跑 setup-check

任何工具调用失败（401/403/permission denied/credentials not found）→ 先读 `setup-check.md` 排查，**不要直接换工具绕过**。绕过会掩盖配置问题，下次还会出。

### 4. 跨工具数据对不上是常态

Ads 后台转化数 vs GA 转化数 vs GTM 触发数三方有差异是正常的，不要花时间凑一致。差异原因写进 `cross-tool-flows.md`。归因模型、采样、时区、阈值四个口径就足够解释 90% 的不一致。

### 5. 周报闭环不能断（如果项目采用 W 周制度）

是否启用 W 周制度，看 `local/project-context.md` 是否填了「W1 起点」。启用了的话，任何 Ads 写操作完成后主动提示用户走 weekly-review 闭环。

## 失败兜底

如果任务没匹配上面任何一个 playbook，按这个顺序：

1. 先读 `cross-tool-flows.md` 看是否是组合任务
2. 还不匹配 → 走 setup-check 验证当前可用工具
3. 仍然不行 → 老老实实告诉用户"这个场景目前 skill 没覆盖"，让用户判断

不要硬套 playbook。playbook 没覆盖的场景比硬套出来的错答案更安全。