SSkilltecabyclaudinhocode
Enviar skill
← Voltar para o catálogo

google-marketing-ops

Marketing

统一处理 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 O

2estrelas
Ver no GitHub ↗Autor: chjm-aiLicença: MIT

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 里的占位符示例值(如 123456789example.com)去调真实 API——那会失败或拿到错的账户。

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

三件套能力边界(先选对工具)

工具入口何时用
Google Adsgoogle-ads-api skill (本地 SDK + ~/.google-ads.yaml)关键词/否定词/出价/预算/campaign/搜索词/质量分
GA (GA4)mcp__analytics-mcp__* (stdio MCP, ADC 凭据)❌ 只读流量/渠道/落地页/转化/归因/实时活跃
GTMmcp__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 没覆盖的场景比硬套出来的错答案更安全。

Como adicionar

/plugin marketplace add chjm-ai/google-marketing-ops

O comando exato pode variar conforme o repositório. Confira o README no GitHub.

Comentários · Nenhum comentário

Entre para comentar. Entrar

  • Ainda não há comentários. Seja o primeiro.