Google Ads

核心功能

Google Ads Skill 提供双模式灵活接入：

API模式：面向专业用户，基于官方 google-ads Python SDK 执行批量操作。支持 GAQL 查询获取广告系列/关键词级数据、程序化暂停低效关键词、批量修改出价策略。需配置开发者令牌与 OAuth 凭证，适合管理多账户或需自动化报表的场景。

浏览器模式：零配置即用，通过 browser 工具直连 ads.google.com。用户登录后，可导航至关键词视图，利用内置筛选器（Conversions<1 + Cost>$500）快速定位浪费支出，一键下载 CSV 报告并执行暂停操作。无需 API 审批，适合临时审计或权限受限用户。

显著优点

• 双轨架构：API 深度集成 vs 浏览器零门槛，覆盖全技术栈用户
• 审计模板化：内置零转化关键词、空广告组、政策违规等标准化检查清单
• 可视化输出：要求以表格形式呈现 CPA/ROAS 关键指标，决策直观
• 实时干预：浏览器模式下可直接操作账户，非只读工具

潜在局限

• 浏览器依赖：UI 自动化受 Google Ads 界面改版影响，selector 可能失效
• API 门槛：开发者令牌审批周期长（数周），测试令牌功能受限
• 权限风险：工具具备暂停/修改能力，误操作可能导致流量中断
• 数据延迟：API 数据通常延迟 3 小时，非完全实时

适用人群

• 日预算 $1K+ 的 SMB 广告主，需定期清理低效关键词
• 代运营机构优化师，管理多账户需批量报表
• 无技术背景但希望自助审计的市场人员（浏览器模式）

常规风险

| 风险类型 | 说明 | 缓释措施 |

|---------|------|---------|

| 操作风险 | 批量暂停可能误伤高价值词 | 建议先下载备份，小批量测试 |

| 合规风险 | 浏览器自动化需遵守 Google Ads 服务条款 | 避免高频请求，模拟人工操作间隔 |

| 数据安全 | API 凭证（yaml/环境变量）泄露可导致账户被控 | 使用专用服务账号，最小权限原则 |

核心功能

该 Skill 提供 Google Ads 广告账户的全方位管理能力，采用独特的双模式设计：

API 模式：面向专业用户，基于官方 google-ads Python SDK 实现批量操作，支持广告系列查询、关键字暂停、预算调整等高级功能，适合大规模账户管理。

浏览器自动化模式：为无 API 权限用户提供开箱即用的解决方案，通过 browser 工具直接操作 ads.google.com 网页界面，完成性能查看、零转化关键词筛选、一键暂停等日常任务。

显著优点

| 优势 | 说明 |

|------|------|

| 零代码风险 | 纯 Markdown 文档型技能，无可执行代码，所有示例均为官方 SDK 标准用法 |

| 双模式覆盖 | 同时满足专业开发者（API）和普通广告主（浏览器）需求 |

| 实战导向 | 内置「零转化高消费关键词检测」「空广告组审计」等 5 大检查清单 |

| 输出标准化 | 强制要求表格化报告，直接产出可执行的优化建议 |

潜在局限

• API 模式门槛高：需申请 Google Ads API 开发者令牌（Developer Token），审批周期 1-3 个工作日
• 浏览器模式依赖 UI 稳定性：Google Ads 界面改版可能导致选择器失效
• 无实时竞价功能：不涉及自动出价策略调整，专注账户结构优化
• T3 来源：个人开发者维护，无企业级 SLA 保障

适合人群

• 中小企业广告主：无技术团队，通过浏览器模式自助优化
• SEM 优化师：批量审计多账户，快速定位浪费支出
• 电商运营：周期性检查转化跟踪状态，防止预算空转

常规风险

| 风险类型 | 说明 | 缓解措施 |

|----------|------|----------|

| 误操作暂停 | 批量暂停可能误伤有效广告 | 强制要求二次确认，建议先下载备份 |

| OAuth 令牌泄露 | API 模式需保管 `google-ads.yaml` | 使用环境变量替代硬编码，定期轮换 |

| 数据延迟 | Google Ads 报告存在 3-8 小时延迟 | 关键决策前确认数据时间戳 |

隐私与合规

完全符合 GDPR 数据最小化原则——Skill 本身不存储任何用户数据，所有操作均在用户自有 Google Ads 账户内完成，无第三方数据共享。