google-marketing-ops — Google Ads / GA / GTM 三件套统一入口
本 skill 是 Google 营销工具栈的编排层。它不重复 MCP/API 工具本身的能力描述——三个工具的原子能力由对应的 MCP/SDK 提供。本 skill 提供:
- 路由:把用户意图分发到合适的 playbook
- 组合:告诉 AI 哪些工具配合用、按什么顺序
- 分析:拿到数据后下一步怎么解读,不止于"列出原始数字"
⚠️ 触发后第一件事:读 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,按这个顺序:
- 先读
cross-tool-flows.md看是否是组合任务 - 还不匹配 → 走 setup-check 验证当前可用工具
- 仍然不行 → 老老实实告诉用户"这个场景目前 skill 没覆盖",让用户判断
不要硬套 playbook。playbook 没覆盖的场景比硬套出来的错答案更安全。