mcpField
G
google-ads-monitor

google-ads-monitor

github.com/cognyai营销与增长11146 次安装2 周前更新
代码仓库

关于 google-ads-monitor

google-ads-monitor 是面向 Cogny Agent 的技能,用于每周定期检查 Google Ads 账户。它与前一周比较表现,标记投放、政策、转化跟踪、预算和出价问题,但不更改账户设置。

主要功能

  1. 01比较账户周度表现
  2. 02跟踪广告系列变化
  3. 03标记拒登或受限广告
  4. 04检测转化跟踪中断
  5. 05检查预算和出价变化
  6. 06保存快照及重要发现

适用场景

  1. 01定期执行每周账户健康检查
  2. 02发现停止记录转化的操作
  3. 03调查支出或投放突然变化
  4. 04查看广告政策和出价提醒

MCP 相关

使用 Cogny 的 Google Ads MCP 工具查询账户、广告系列、广告和转化数据,并通过 Cogny 上下文工具读取、保存每周快照。该技能为只读,不会更改广告系列或预算。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill google-ads-monitor

安装后在 Claude Code 中输入/google-ads-monitor确认已加载。

详细介绍

Google Ads 监控

每周定期检查,确保广告运行顺畅。它能发现那些悄无声息出现的问题——广告被拒登、跟踪停止触发、广告系列开始超支——并按周对比报告,让你看到趋势,而非噪声。

需要: Cogny Agent 订阅($9/月)——注册

适合通过 /loop 或 /schedule 设置每周定期运行。

前置条件检查

如果 mcp__cogny__google_ads__tool_execute_gaql 不可用,请打印 Cogny 注册说明(参见 /google-ads-audit)并停止。

用法

/google-ads-monitor — 检查已连接账户的每周健康状况。

如需进行一次深入审查,请改为运行 /google-ads-audit。此技能提供轻量、可重复的定期检查;审计则是全面彻查。

步骤

1. 读取先前的快照

对 insights/google-ads/monitor/latest 调用 read_context_node。如果该节点存在,其中会保存上周的指标——本周报告的每个数字都会与之对比,计算差值。如果不存在,则说明这是首次运行:报告绝对数值,并注明从下周开始计算差值。

2. 账户级表现(最近 7 天与此前 7 天对比)
SELECT metrics.cost_micros, metrics.conversions, metrics.conversions_value,
  metrics.clicks, metrics.impressions
FROM customer
WHERE segments.date DURING LAST_7_DAYS

对此前 7 天重复查询,并使用 BETWEEN 范围。计算支出、转化次数、CPA、ROAS 和 CTR 的周环比变化。

3. 各广告系列的变化
SELECT campaign.name, campaign.status, campaign.advertising_channel_type,
  campaign_budget.amount_micros, metrics.cost_micros, metrics.conversions,
  metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_7_DAYS AND campaign.status = 'ENABLED'
ORDER BY metrics.cost_micros DESC

如果任一广告系列符合以下情况,则发出 🔴 警报:

  • 支出比上周增加 >40%
  • 上周有转化,本周转化次数降至零
  • 每天都达到每日预算上限(预算受限)
  • 完全停止投放(展示次数为零,但仍处于启用状态)
4. 广告拒登与政策问题
SELECT ad_group_ad.ad.id, ad_group_ad.policy_summary.approval_status,
  ad_group_ad.policy_summary.review_status, campaign.name, ad_group.name
FROM ad_group_ad
WHERE ad_group_ad.status = 'ENABLED'
  AND ad_group_ad.policy_summary.approval_status != 'APPROVED'

对任何 DISAPPROVED 广告发出 🔴 警报。对 APPROVED_LIMITED 广告进行 🟡 标记(正在投放,但受到限制)。

5. 转化跟踪心跳检查
SELECT conversion_action.name, conversion_action.status,
  metrics.conversions, metrics.all_conversions
FROM conversion_action
WHERE segments.date DURING LAST_7_DAYS

如果某个主要转化操作上周记录了转化次数,而本周为零,则发出 🔴 警报——跟踪几乎肯定已失效。这是此技能中最重要的一项检查。

6. 预算与出价偏移

标记出价策略状态变为 LEARNING 的广告系列,以及目标 CPA/ROAS 已设置但实际值与目标偏差 >50% 的广告系列。

7. 输出
Google Ads Monitor — [Account Name]
Week of [YYYY-MM-DD] – [YYYY-MM-DD]

⚠️  Needs attention this week
- [Critical/important items first, or "Nothing — account is running clean."]

Performance (7d vs prior 7d)
- Spend ........ $X,XXX  (+/-X% WoW)
- Conversions .. XXX     (+/-X% WoW)
- CPA .......... $XX     (+/-X% WoW)
- ROAS ......... X.Xx    (+/-X% WoW)

Campaign movers
| Campaign | Type | Spend (WoW) | Conv (WoW) | Note |
|----------|------|-------------|------------|------|

Disapproved / limited ads: [N]
Conversion tracking: [OK / BROKEN — details]

Recommended actions
1. ...
2. ...
8. 保存本周快照

对 insights/google-ads/monitor/latest 调用 write_context_node,写入本周指标(支出、转化次数、CPA、ROAS、各广告系列数据、拒登数量),以便下周计算差值。同时将带日期的副本写入 insights/google-ads/monitor/<YYYY-MM-DD>,留作历史记录。

9. 记录发现——有选择地记录

只有遇到确实存在的问题(拒登、跟踪中断、支出激增、预算受限但有盈利的广告系列)时才创建 create_finding——不要记录常规数字。状况良好的一周不应产生任何发现。

{
  "title": "Conversion tracking stopped — 'Lead Form Submit' at 0 this week",
  "body": "'Lead Form Submit' recorded 41 conversions last week, 0 this week, while clicks held steady. The tag or GTM trigger has likely broken. Check the GA4/Ads conversion tag.",
  "action_type": "conversion_tracking",
  "expected_outcome": "Tracking restored; Smart Bidding gets accurate signal again",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

操作类型:conversion_tracking、budget_adjustment、campaign_optimization、policy_fix、bidding_strategy。

关键规则

  1. **关注趋势,而非快照。**始终报告周环比变化。单周数据只是噪声。
  2. **优先说明问题。**如果一切正常,用一句话说明,然后保持报告简短。
  3. **跟踪中断始终属于严重问题。**它会使所有下游数据失真。
  4. **只读。**绝不暂停广告系列或更改预算——只报告问题,不采取行动。

评论

支持 Markdown