Google Ads管理

技能简介

该技能提供两种模式管理 Google Ads 账户：API 模式支持批量操作，适合有开发能力的用户；浏览器自动化模式无需 API 凭证，通过控制已登录的 ads.google.com 页面完成常见任务。

业务背景

广告投放人员常面临多账户数据分散、低效关键词持续消耗预算的问题。该技能支持两种接入方式：有开发能力的团队可通过API批量拉取全账户数据；运营人员也可在浏览器登录状态下，直接对当前页面执行查询与优化操作，无需等待技术排期。

落地案例：某电商大促后，优化师需清理表现差的关键词。浏览器模式下，技能自动遍历已登录账户中的广告系列，按日期范围和消耗阈值筛选出零转化但花费超500元的关键词列表，一键暂停并生成审计报告。API模式则用于每周一早会前，自动汇总各账户的转化成本数据表，替代手工复制粘贴。

能做什么

• 查询广告系列、关键词的消耗与转化数据
• 识别零转化高消费的关键词，减少浪费支出
• 暂停表现不佳的广告系列或关键词
• 审计转化追踪配置与账户健康度
• 下载报表数据供离线分析

使用说明

安装依赖

# 验证 Python 环境
python3 --version

# API 模式需安装 google-ads SDK
pip install google-ads

配置检查

# 检查 API 配置文件是否存在
ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null

# 验证 SDK 安装
python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"

模式选择

1. 若存在 ~/.google-ads.yaml 或 GOOGLE_ADS_* 环境变量，使用 API 模式
2. 若无 API 凭证，选择浏览器模式：用户登录 ads.google.com 后，点击 Clawdbot Browser Relay 工具栏图标启用

常用操作示例

获取广告系列效果（浏览器模式）：

1. 导航至 ads.google.com/aw/campaigns
2. 设置日期范围
3. 截取广告系列表格，解析名称、状态、预算、消耗、转化、单次转化成本

查找零转化关键词：

1. 进入关键词视图，添加筛选条件：转化次数小于 1、消耗大于设定阈值
2. 按消耗降序排列，截取表格分析

暂停关键词：

1. 在关键词或广告系列视图勾选目标项
2. 点击”修改”下拉菜单选择”暂停”，确认操作

输入与输出

见下方输入与输出表格。

风险提示

• API 模式需要有效的开发者令牌和 OAuth 凭证，配置不当可能导致请求失败
• 浏览器模式依赖用户保持登录状态，会话过期需重新授权
• 暂停或修改广告设置会直接影响线上投放，操作前建议确认影响范围
• 涉及真实广告花费，审计操作建议在非高峰时段进行

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jdrhyne/google-ads/SKILL.md
来源类型：GitHub 仓库