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/metrics.md
View on GitHub# 指标与口径
## 基础计算
| 指标 | 规则 |
|---|---|
| 花费 | `sum(metrics.cost_micros) / 1,000,000` |
| CTR | 点击合计 / 展示合计 |
| CPC | 花费合计 / 点击合计 |
| 点击口径转化率 | 明确选择的转化数 / 点击数,必须标注分母 |
| Google 转化率 | 按当前 API 指标定义;`conversions_from_interactions_rate` 的分母为 interactions,不能笼统替换成 clicks |
| CPA | 花费 / 已明确口径的转化数 |
| 购买 ROAS | 同范围、同币种的购买归因价值 / 花费 |
| 环比 | `(本期 - 上期) / 上期`;基期为零时显示绝对差和 `N/A` |
所有比率先汇总分子与分母,再计算;不要平均各 Campaign 的 ROAS 或 CPA。仅带 `_micros` 或官方定义为 micros 的字段才除以一百万,普通 `conversions_value` 不作该转换。转化数可因归因分配而为小数。零分母显示 `N/A`,保留精度到最终展示。
多个币种分别出表;若用户明确要求统一币种,保留原币种、汇率来源和日期,统一换算相关金额后再算比率。跨时区比较说明采用各自完整自然日还是用户指定的统一口径。
依据:[Google 指标字段定义](https://developers.google.com/google-ads/api/fields/latest/metrics)。字段可用性仍以当前 MCP 元数据为准。
## 转化不等于购买
先核对 `conversion_action` 的类别、来源、计数方式、价值、primary/secondary 和当前可用的目标设置字段,再看账户默认目标、Campaign 专属目标以及自定义目标。名字叫 Purchase 也不能代替语义检查。
`metrics.conversions`、`metrics.all_conversions`、对应价值及按转化发生日期的指标不能互换。Secondary 动作通常不用于常规优化,但加入自定义目标后可能参与出价;只看 primary 标志可能误判。[自定义目标说明](https://support.google.com/google-ads/answer/11461796)
对销售分析,按购买动作单独查询转化数与价值;把加购、页面浏览或留资列为漏斗诊断。不要把默认事件价值当成销售收入。当前目标配置不能完整重建历史配置,历史调整需结合可获得的变更记录或用户资料。
按转化动作细分的查询可能只支持转化相关指标。成本、展示和点击应另查匹配范围的控制总量,再按明确的账户、Campaign、日期关联;**不要在每个转化动作上重复计入成本**。存在跨账户转化跟踪时,检查转化归属和可访问范围。
## 归因与日期
Google 的 Conversions 可能包含不同交互类型;不能一律写成“纯点击归因”。展示后转化与互动观看转化分别确认;实际可拆分字段取决于广告类型与 API 版本。[互动观看转化](https://support.google.com/google-ads/answer/10048752)
交互日期和转化发生日期回答不同问题。近期转化会回补,归因调整和模型化结果也会影响报表。以账户时区处理日期;默认不含今天。短期结果注明读取时间、数据新鲜度与观察窗口,不承诺已稳定。
平台归因价值不等于利润、增量收入或财务净收入。退款、税费、运费、币种转换和订单去重需要额外业务数据。
## 全站购买与单品收入
推广单个商品的 Campaign,可能归因到其他商品订单。不能凭 Campaign 名称将其全部 Purchase value 认作本品销售。
具备购物车商品数据时,可探索 `cart_data_sales_view`、已售商品 ID 等当前兼容资源与字段;区分**被广告展示的商品**和**实际售出的商品**。有些商品明细成功返回不证明订单覆盖完整。普通转化价值与购物车收入可能定义不同,未对齐前不能相减推算“其他品类收入”。[购物车数据报表](https://developers.google.com/google-ads/api/docs/shopping-ads/reporting)
后台商品净销售额 / 广告花费若缺少可核实的归因,只能另命名为经营效率参考,不能叫该 Campaign 的归因 ROAS。多个广告平台的购买不可直接相加,需另行去重或说明重叠。
## App、游戏与线索
安装、注册、首购、应用内购买分别解释,不能汇为同一种有价值用户。没有可用的 MMP、SKAN 或队列数据时,不从平台短期 ROAS 推断 LTV、留存或回本周期。Lead 数量不代表有效商机,需要 CRM 质量结果支持。
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 | Unverified | 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 |