Google Ads Connect 是一个连接 Google Ads API 的技能，用于拉取用户 Google Ads 账户的真实数据，并基于数据给出具体行动建议。
用途 该技能定位为绩效营销分析师，直接访问用户的 Google Ads 账户，拉取真实数据，找出影响表现的问题，并给出具体可执行的建议，而非泛泛而谈。
主要能力
- 拉取广告系列表现：花费、点击、转化、CPA、ROAS。
- 拉取关键词表现：质量得分、CPC、转化率。
- 拉取搜索词报告：实际触发广告的查询。
- 拉取展示份额：因排名与预算造成的损失。
- 识别浪费支出：有花费但零转化的关键词。
- 提供 7 维度健康检查评分卡：转化跟踪、关键词健康、搜索词质量、展示份额、支出效率、广告系列结构、预算利用率。
- 输出 Top 3 行动建议：立即暂停、添加否定关键词、出价调整。
- 可选执行变更：暂停关键词、添加否定关键词、调整出价。
使用方式 首次使用需配置凭据。技能会先检查 .agents/google-ads-credentials.json 是否存在，若存在则直接进入数据拉取。
OAuth 设置（推荐）：
- 安装 Google Ads Python 客户端：pip install google-ads
- 运行 OAuth 流程：python skills/google-ads-connect/scripts/oauth_setup.py 该流程会打开浏览器标签，用户使用 Google 登录，令牌保存到 .agents/google-ads-credentials.json。
手动设置（开发者令牌）： 需要向用户获取以下信息：
- Developer Token（Google Ads API Center → Tools → API Center）
- Client ID + Secret（Google Cloud Console → OAuth 2.0）
- Refresh Token（运行 scripts/generate_refresh_token.py）
- Customer ID（Google Ads 中的 10 位数字，格式：xxx-xxx-xxxx） 保存到 .agents/google-ads-credentials.json： { "developer_token": "...", "client_id": "...", "client_secret": "...", "refresh_token": "...", "customer_id": "..." }
数据拉取： 凭据就绪后，运行审计脚本： python skills/google-ads-connect/scripts/audit.py --output .agents/google-ads-data.json 默认拉取最近 30 天数据。
分析框架： 数据加载后，运行 7 维度健康检查评分卡，各维度分为健康、警告、严重三档。
浪费支出检测： 标记满足以下任一条件的关键词：
- 30 天内花费 > $50 且零转化
- CTR < 0.5%（受众不相关）
- 质量得分 ≤ 3（Google 认为匹配度差）
- 搜索词包含明显的否定项（不想要的竞品名称、不相关修饰词）
Top 3 行动（始终输出）：
- 立即暂停：无回报且烧钱的关键词/广告系列
- 添加否定关键词：来自搜索词报告的不相关搜索词
- 出价调整：高转化但正在丢失展示份额的关键词
输出格式： 账户评分卡，包含账户名、Customer ID、周期、花费、转化、CPA，以及各维度状态与摘要。
行动项： 每项行动包含：What（具体关键词/广告系列/设置）、Why（支持数据：花费、转化、QS）、Impact（预计每月节省或转化提升）、How（具体实施步骤）。
执行（可选）：
如果用户说“do it”或“apply changes”，使用变更脚本：
python skills/google-ads-connect/scripts/mutate.py
--pause-keywords "keyword1,keyword2"
--add-negatives "term1,term2"
--bid-adjust "keyword3:+15%"
所有变更记录到 .agents/google-ads-changes.json，并可在 7 天内通过 Google Ads 变更历史撤销。
执行变更前始终确认，例如：“我即将暂停 3 个关键词（每月花费 $210，0 转化）并添加 8 个否定关键词。确认？”
与其他技能集成： 连接后，以下技能可获得真实数据增强：
- paid-ads：用账户特定建议替代通用建议
- ad-creative：使用实际表现最好/最差的广告文案作为基线
- ab-test-setup：基于真实表现差距设计测试
- analytics-tracking：将 Google Ads 转化与 GA4 交叉核对
适用场景
- 需要基于真实 Google Ads 账户数据进行分析的绩效营销场景。
- 需要识别浪费支出、优化关键词和搜索词、调整出价时。
- 需要将 Google Ads 数据与其他营销技能结合使用时。
限制
- 需要配置 Google Ads API 凭据（OAuth 或开发者令牌）后才能拉取数据。
- 变更操作需用户确认后执行，且可在 7 天内撤销。
- 具体收费、价格、平台支持范围等资料暂未提供。