mcpField
A
ads-google

ads-google

github.com/hainrixz营销与增长10262 次安装3 天前更新
代码仓库

关于 ads-google

ads-google 是用于 Google Ads 账户深度审计的技能，面向需要评估广告表现与设置的用户。它按七步流程检查转化追踪、支出、账户结构、关键词、广告和设置，并生成评分及报告。

主要功能

  1. 01多来源收集广告数据
  2. 02按七类检查账户健康
  3. 03校验 GAQL 数据并去重
  4. 04评估 Performance Max 与 AI Max
  5. 05输出评分及审计报告

适用场景

  1. 01发现无效支出与搜索词问题
  2. 02检查转化追踪和归因设置
  3. 03审查关键词、广告及账户结构

MCP 相关

可选连接 Google Ads MCP 服务，通过 GAQL 查询搜索词、关键词、转化操作和广告系列结构；未配置时可使用数据文件或手动导出。

安装

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

$npx skills add https://github.com/hainrixz/claude-ads --skill ads-google

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

详细介绍

Google Ads 深度分析

数据收集（3 层，优先免费方案）

  • 第 1 层 — MCP（首选）：使用 cohnen/mcp-google-ads 访问 GAQL。自动提取搜索字词报告、关键字数据、转化操作和广告系列结构。设置方法请参阅 mcp-integration.md。
  • 第 2 层 — 直接 API（免费；需设置 OAuth 和开发者令牌）：如果当前工作目录中存在 google-data.json，请读取该文件。用户可通过以下方式生成： 
    python3 scripts/api/google_fetch.py --account-id <customer_id> -o google-data.json
    完整设置说明（开发者令牌申请需要 1-3 个工作日）见 scripts/api/README.md。
  • 第 3 层 — 手动备用方案：导出 Google Ads 账户数据，其中需包含更改历史记录和搜索字词报告。
  • 评估前请先验证：数据涵盖 ≥30 天，且包含搜索字词报告。如果不符合要求，请停止并请求新的导出数据。

然后使用 google-audit.md 作为检查清单，按照 ads/references/audit-methodology.md 中的标准 7 步审计流程执行。进行任何 GAQL 分析前，请先阅读 gaql-notes.md，了解已知字段不兼容问题和去重规则。输出两种结果（依据 audit-output-schema.json 生成的 google-audit-results.json，以及 google-audit-results.md）。

分析内容

转化跟踪（权重 25%）
  • 所有页面均已安装并触发 Google tag（gtag.js）
  • 已启用增强型转化（经哈希处理的第一方数据）
  • 已实现 Consent Mode v2（欧盟/欧洲经济区必需）
  • 转化操作映射正确（主要与次要）
  • 已配置离线转化导入（适用于潜在客户开发）
  • 通过 GTM 实现服务端标记（建议用于提高准确性）
  • 归因模型：优先采用数据驱动型（仅在无法使用时才采用末次点击）
  • 转化延迟分析（转化是否仍在陆续产生？）
浪费的支出（权重 20%）
  • 已检查搜索字词报告（至少覆盖最近 30 天）
  • 否定关键字覆盖充分（共享列表 + 广告系列级）
  • 展示位置审计（排除低质量网站）
  • 无效点击率处于正常范围内（<10%）
  • 广泛匹配仅与智能出价搭配使用（绝不可单独使用）
  • 品牌与非品牌广告系列已分开
  • 地理位置定位精准（避免在国际市场浪费支出）

否定关键字规则（关键：错误的否定关键字会毁掉广告系列）：

  • 绝不要建议使用广泛匹配否定关键字，除非有明确理由；它们的拦截范围过广
  • 对于特定的不相关查询，默认使用完全匹配 [keyword]
  • 对于不相关的意图模式，使用词组匹配 "keyword"
  • 否定关键字应来自实际搜索字词报告中的不相关查询，而非猜测
  • 按主题分组：信息类（how-to、DIY、what is）、求职者类（jobs、careers、salary）、竞争对手类（仅在有意排除时）、免费意图类（free、crack、torrent）
  • 建议在账户级使用共享否定关键字列表，而非仅在广告系列级使用
  • 检查现有否定关键字是否拦截过多（是否有否定关键字意外拦截了可带来转化的查询？）
账户结构（权重 15%）
  • 广告系列级组织符合业务逻辑
  • 广告组主题明确（每组最多 15-20 个关键字）
  • RSA 广告组至少有 3 个有效广告
  • PMax 广告系列结构正确（素材组、信号）
  • 评估 SKAG（如存在，则迁移到主题广告组）
  • 广告系列标签和命名规范一致
关键字（权重 15%）
  • 匹配类型策略合适（从完全匹配到词组匹配，再到广泛匹配）
  • 质量得分分布（平均分力争达到 ≥7）
  • 标记质量得分较低的关键字（<5 = 不合格，5-6 = 警告）
  • 检查关键字蚕食（同一关键字是否出现在多个广告系列中）
  • 跟踪热门关键字的展示次数份额
  • 设置针对设备、位置和受众的关键字出价调整
广告（权重 15%）
  • RSA：每个广告组至少有 8 个不同的标题、每则广告至少有 3 条描述
  • RSA：广告效力为“良好”或“极佳”（而非“较差”或“一般”）
  • 尽量少用固定位置，并谨慎使用（过度固定会降低 RSA 的灵活性）
  • 广告附加信息：附加链接（≥4）、宣传信息（≥4）、结构化摘要、图片
  • 适当使用动态关键字插入
  • 广告文案包含行动号召、价值主张和差异化优势
设置（权重 10%）
  • ECPC（增强型 CPC）已标记为弃用。迁移到完整的 Smart Bidding（tCPA/tROAS/Maximize）
  • 出价策略应符合广告系列的成熟度和目标
  • 预算节奏：没有受预算限制的广告系列（除非有意为之）
  • 广告投放时段应与营业时间／转化模式一致
  • 根据效果数据设置设备出价调整
  • 地理位置定位：选择“位于”而非“位于或对该地点感兴趣”
  • 网络设置：检查搜索合作伙伴；搜索广告系列退出展示广告网络

GAQL 与数据准确性

分析数据之前，请阅读 ads/references/gaql-notes.md，了解已知的 GAQL 字段不兼容问题、 去重模式和筛选范围最佳实践。关键规则：

  • 在任何分析之前，按 (ad_group_id + keyword_text + match_type) 对关键字去重
  • 仅分析已启用的广告系列和广告组（排除已暂停／已移除的项目）
  • 检查主题一致性（G03）时，仅筛选展示次数 > 0 的关键字
  • 应用旧版 BMM 判断规则：BROAD + Manual CPC = 旧版 BMM，而非有意采用广泛匹配（G17）
  • 仅当搜索词的花费 >$10 且转化次数为 0 时，才标记为浪费的支出（G16）
  • 统计广告系列级否定关键字时，同时计入共享否定关键字列表（G14/G15）

Google Ads MCP 集成（可选）

如需自动收集数据，请连接 Google Ads MCP 服务：

  • 可用工具：search（GAQL 查询）、list_accessible_customers
  • 设置：在 .mcp.json 或 Claude Code MCP 设置中配置
  • 客户 ID：从 CLAUDE.md 的 Accounts > Google Ads 中提取，或询问用户
  • 回退方案：如果未配置 MCP，则改用手动导出数据（默认工作流）

如果可以使用 MCP，请用它自动拉取搜索字词报告、关键字数据、转化操作 和广告系列结构，而不是要求手动导出。

PMax 深入分析

如果存在 Performance Max 广告系列，还需评估：

  • 素材组的多样性（文本、图片、视频、Feed）
  • 是否配置了受众信号（自定义细分受众群、列表、人口统计特征）
  • 是否检查了 URL 扩展设置（退出不相关页面）
  • 是否应用了品牌排除设置（防止蚕食品牌搜索），所有广告主均可使用
  • 所有广告主现在均可使用广告系列级否定关键字
  • 是否使用了搜索主题（2024 年功能）
  • 是否启用最终到达网址扩展；如未启用，需说明理由
  • 是否检查了 Insights 标签页（搜索类别、受众细分）

Search AI Max（2026）

AI Max 在现有搜索广告系列中叠加了广泛匹配和无关键字定位。 平均转化量提升 14%。DSA 预计将在 2026 年第二季度整合到 AI Max 中。 需要强大的否定关键字列表。

如果 Search AI Max 可用／已启用：

  • 评估广泛匹配与 AI Max 的集成
  • 监控自动生成的标题效果
  • 检查搜索字词类别是否相关
  • 评估预算影响（AI Max 可能会调整支出）
  • 检查否定关键字列表是否完整（AI Max 会显著扩大覆盖范围）
  • 评估 DSA 迁移路径（预计将在 2026 年第二季度整合）

Demand Gen 广告系列

已取代 Video Action Campaigns（2026 年 4 月）。视频 + 图片 = 转化量提升 20%。 不支持频次上限。

如果存在 Demand Gen 广告系列，请评估：

  • 是否包含视频 + 图片素材组合（组合格式可带来 20% 的转化量提升）
  • 是否配置了受众信号（自定义细分受众群、相似受众）
  • 转化跟踪是否与上层／中层漏斗目标一致
  • 注意：无法设置频次上限。需手动监控覆盖人数与频次

关键阈值

指标通过警告未通过
质量得分（平均）≥75-6<5
CTR（搜索）≥6.66%3-6.66%<3%
CVR（搜索）≥7.52%3-7.52%<3%
CPC（搜索）≤$5.26$5.26-8.00>$8.00
浪费的支出<10%10-20%>20%
广告效力良好+一般差
无效点击<5%5-10%>10%

输出

Google Ads 健康度评分
Google Ads Health Score: XX/100 (Grade: X)

Conversion Tracking: XX/100  ████████░░  (25%)
Wasted Spend:        XX/100  ██████████  (20%)
Account Structure:   XX/100  ███████░░░  (15%)
Keywords:            XX/100  █████░░░░░  (15%)
Ads:                 XX/100  ████████░░  (15%)
Settings:            XX/100  ██████████  (10%)
交付内容
  • GOOGLE-ADS-REPORT.md：包含 80 项检查结果的完整报告，并标注通过／警告／失败
  • 浪费支出估算（每月美元金额）
  • 按影响程度排序的快速优化建议
  • PMax 专属建议（如适用）
  • 按关键词组列出的关键词健康度矩阵，包含 QS、CTR 和 CVR

评论

支持 Markdown