Google Marketing Ops

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 没覆盖的场景比硬套出来的错答案更安全。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: chjm-ai
• Source: chjm-ai/google-marketing-ops
• License: MIT

Install and usage instructions live in the source repository linked above.