Chanlinnn/google-ads-agent-skills / skills/analyze-google-ads
analyze-google-ads
Verified通过只读 Google Ads MCP 分析账户、广告系列、搜索词、素材、转化、CPA、ROAS、预算限制及效果异常。用于广告审计、周期比较、购买口径核查、PMax 或电商广告诊断和优化建议。Analyze Google Ads performance with explicit conversion definitions and evidence. 不执行广告创建、预算调整、启停或其他写入。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
| agents/openai.yaml | config | 475 B |
| assets/example-report.md | markdown | 1.5 KB |
| references/metrics.md | markdown | 4.3 KB |
| references/playbooks.md | markdown | 4.5 KB |
| references/report.md | markdown | 1.4 KB |
references/playbooks.md
View on GitHub# 查询与分析路径
## 通用查询规则
每次开始一种资源查询前,读取 `metadata_get_resource_metadata`,核实字段、筛选、排序和 segment 兼容性。读取当前工具 schema;本包对应的 `search_search` 接受 `customer_id`、`resource`、`fields`、`conditions`、`orderings`、`limit` 和可选 `login_customer_id`,返回列表,不提供分页 token。
先查客户或 Campaign 未细分控制总量,再查异常的主要贡献者。绩效查询使用明确起止日期。库存/配置资源无日期字段时不要强加日期条件。
历史绩效查询不按 `campaign.status = ENABLED` 或 `status != REMOVED` 过滤,因为状态是当前值,可能排除历史期内仍有花费的实体。用户明确限定“目前启用的广告”时可按该范围分析,但要标明不代表账户历史总量。清单查询与历史绩效查询分别执行。
### 完整性与规模
- 总量查询尽可能不加细分维度,避免重复聚合。
- `LIMIT 100` 等只适用于明确的 top-N 探索。返回行数达到上限时,完整性未获证明;少于上限也要检查宿主截断。
- 需要全量时,按不重叠日期段或已知实体集合拆分,逐片验证;单日仍过大则继续按实体拆分。不能凭空使用该工具没有的分页参数。
- 分片合并记录唯一键,避免重叠区间和重复 Campaign。与独立控制总量核对;无法完成就报告覆盖范围和未覆盖部分。
- 查询转化动作与成本用不同结果表时,先确认关联键和一对多关系,不把成本重复扩展。
- 批量读取先低并发;对可重试的服务端限流使用有上限退避,持续失败记录缺失,不把错误当零。策略拒绝不是普通网络错误。
## 账户盘点和体检
1. 发现直接访问身份及 MCC 层级,按用户选择确定范围,去重客户。
2. 读取币种和时区;暂停、取消账户是否纳入取决于盘点/历史问题,不凭名称猜品牌或授权边界。
3. 拉本期与对比期的花费、展示、点击、转化数与价值,并核对转化口径。
4. 按**绝对花费/购买贡献变化**定位主要 Campaign,再看百分比;低基数波动单独标注。
5. 只有对应字段兼容、且对解释有帮助时才下钻日期、设备、网络或广告形式。
## Search 与搜索词
关键词使用 `keyword_view`,用户实际查询使用 `search_term_view` 等适合当前广告类型的资源。不要把关键词与搜索词混淆。
识别高花费、弱购买贡献或意图不符的主题,结合账号规模与转化滞后评估证据。不给“花费达到固定金额就否词”等跨账户硬规则。搜索词报告可能受隐私门槛限制,无法用其行合计强行解释全部点击。
输出候选优化清单、依据、需要人工核实的意图和观察窗口,不应用否定关键词。
## PMax、素材和购物广告
- 受众信号用于帮助系统学习,系统可以触达信号外用户。素材组命名不是实际受众测量。[官方受众信号说明](https://support.google.com/google-ads/answer/14530785)
- 素材评级是系统反馈,不是因果增量实验。先核对投放机会、格式、量级和落地页,避免把弱表现都归因于创意。
- 素材组一般不拥有独立可分配的 Campaign 预算;不要从标签或结构推断预算已隔离。
- 购物报表区分广告商品和已售商品。Feed 分组/标签解决选品结构,不自动解决单品归因问题。
## 预算与出价建议
核对共享预算、出价策略、预算受限和排名受限的证据。预算利用率高不等于加预算会盈利;观察平均 ROAS 也不能直接预测边际 ROAS。
建议说明调整对象、理由、待验证假设、业务约束和复查时间。没有利润率、库存或业务目标时,只报告条件化建议,不编造统一“达标 ROAS”。
## 转化异常与追踪
转化数上升而价值不变时,先查动作构成、默认价值、目标变化和回补,不立即认定广告效率提升。
购买为零时分清:没有成交、成交未回传、回传未归因、数据尚未成熟、报告范围不一致。其他 Campaign 有同一动作不证明目标 Campaign 无问题,也不支持“全站标签完全缺失”的结论。
API 不包含某个界面警告的具体依据时,将原因记为待核查,建议查看对应 UI 诊断或由用户提供已脱敏证据。不要仅为消除警告建议把加购加入购买出价目标,也不要未经排查重复安装标签。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |