Google Ads

📊 零配置接入 Google Ads,安全操控投放与报表

通过 OAuth 安全接入 Google Ads API,支持账户查询、GAQL 报表分析及 campaign/audience 的读写操作,所有写入需用户确认。

收藏
10.7k
安装
2.3k
版本
0.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

google-ads-campaigns 是 OpenClaw 生态中针对 Google Ads 平台的官方集成技能,通过 ClawLink 托管服务实现 OAuth 认证与 API 代理,用户无需自行配置 Google Ads API 凭证即可使用。

主要功能模块

| 模块 | 能力 | 典型场景 |
|------|------|---------|
| **账户管理** | 列出可访问客户、获取账户详情 | 多账户切换、权限核查 |
| **Campaign 操作** | 查询、创建、修改广告系列 | 预算调整、状态启停、新建推广计划 |
| **Ad Group 管理** | 广告组列表、详情查看、创建 | 精细化投放单元配置 |
| **受众与列表** | 受众查询、Customer Match 列表创建与成员添加 | 再营销受众包构建、高价值用户上传 |
| **GAQL 报表** | 执行 Google Ads Query Language 查询 | 自定义绩效分析、跨维度数据透视 |

执行工作流设计

技能采用安全优先的分层调用策略

  • 读操作(list/get/search)可直接执行
  • 写操作(create/update/delete)强制遵循 describe → preview → confirm → execute 流程

技术架构特点

  • 零配置接入:ClawLink 托管 OAuth 令牌,聊天中无需暴露 API key
  • 实时工具发现:通过 clawlink_list_tools --integration google-ads 获取动态工具目录
  • 错误透明化:400/403/404 等错误直接透传,不虚构结果

显著优点

1. 降低使用门槛:封装 OAuth 流程与 GAQL 语法细节,非技术用户也能操作复杂报表
2. 安全设计完善:写入操作必须经 clawlink_preview_tool + 用户显式确认,避免误操作

3. 动态工具发现:工具目录实时同步 Google Ads API 版本,避免硬编码过时能力

4. 多租户友好:支持同一 Google 账户下的多 Customer ID 切换

潜在局限

1. 依赖 ClawLink 服务可用性:若 claw-link.dev 服务中断,全部功能失效
2. OAuth 权限边界:受限于用户 Google 账户的 Ads 权限范围,无法跨账户操作

3. GAQL 学习成本:复杂报表仍需掌握 Google Ads 字段命名与 SQL-like 语法

4. 延迟问题:代理架构增加一层网络跳转,大规模数据查询可能较慢

适合人群

  • 广告主/优化师:需要快速查询 campaign 状态、拉取自定义报表
  • 营销运营团队:管理多账户,需批量检查或调整投放设置
  • 代理商:为多个客户账户做定期数据审计与配置变更

常规风险

| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 误操作风险 | 错误的 campaign 更新可能导致广告停投或超支 | 强制 preview + 用户确认流程 |
| 数据泄露 | Customer Match 上传涉及用户 PII | 依赖 Google OAuth 的安全传输,ClawLink 声称不存储数据 |
| 第三方依赖 | ClawLink 作为中间服务商,存在 supply chain 风险 | 建议关注 claw-link.dev/verify 的审计状态 |
| 权限漂移 | OAuth 授权范围可能随时间变化 | 定期执行 `clawlink_list_integrations` 验证连接健康 |

总体评估

该技能在安全性设计(强制确认流程)与易用性(零配置接入)之间取得较好平衡,适合将 Google Ads 操作引入对话式工作流。但对于关键业务场景,建议保留 Google Ads 原生界面作为复核手段。

Google Ads 内容

手动下载zip · 5.5 kB
skill-card.mdtext/markdown
请选择文件