谷歌广告复制品
公共Alpha--生成器预览 我构建了一个OpenClaw代理,通过意图分析而不是出价自动化来管理谷歌广告账户。所有三层——阅读→ 草稿→ 应用-是实时的,并在真实账户上进行测试。对于想要尝试意图优先方法的建筑商和机构来说,这是一个早期版本。
大多数谷歌广告问题不是竞价问题。 他们是 意图混合问题.
你的账户正在购买不同类型的搜索——买家、比较购物者、研究人员、求职者、赠品猎人——并将它们混合在一起。当这种情况发生时,出价会针对噪音进行优化,注册系统管理人会获得通用性,好的流量会补贴坏的流量,每个预算决策都会被扭曲。
Google Ads Copilot是一个人工智能代理,可以读取搜索行为,构建持久的意图图,发现浪费,隔离信号,并将帐户正在学习的内容转化为结构、复制和规模决策。每一条建议都被分为可审查的草案。没有你的批准,什么都不会改变。
不是仪表板。不是出价优化工具。不是通用的审计清单。
有记忆力的战略家。
______________________________________________________________________
运作原理
READ → DRAFT → APPLY| 层 | 发生了什么 |
|---|---|
| 阅读 | 通过谷歌官方推送真实账户数据 google-ads-mcp MCP服务器(只读)。或者使用手动CSV导出——无论哪种方式都是相同的分析引擎。 |
| 草稿 | 每一个可操作的发现都变成了一个具体的建议——具体的负面因素、结构变化、预算变动、RSA方向——供人类审查。 |
| 应用 | 对已批准的草稿进行受控回写。实时范围: 添加负面关键字, 暂停关键字/广告组,以及 活动每日预算变化 通过舱单支撑的护栏。模拟运行、明确确认、每次操作验证、完整审计跟踪、即时撤销。 |
看 建筑.md 了解完整的设计、安全模型和路线图。
______________________________________________________________________
运行它的两种方法
连接模式(推荐)
将MCP服务器与OAuth+开发人员令牌连接,代理会自动提取实时数据——搜索词、关键字、转换、预算,一切都通过GAQL。
您将获得:实时帐户数据、自动帐户发现、稀疏帐户的日期范围回退、针对目标关键字的交叉引用搜索词以及开箱即用的健康检测。
设置: ./install.sh auto → /google-ads connect setup → 你活着。看 data/mcp-config.md 了解详情。如果您的主持人使用非默认技能路径,请用以下内容覆盖它 CLAUDE_TARGET=... 或 OPENCLAW_TARGET=....
导出模式(零点设置)
从谷歌广告中粘贴CSV。分析引擎是一样的——你只需手动输入即可。适用于您还没有API访问权限的一次性审核或帐户。
这两种模式产生的分析和草稿质量相同。
______________________________________________________________________
它能做什么
三层共15项技能。完整的操作员工作流程在 操作员手册.md.
运行帐户
| 命令 | 发生了什么 |
|---|---|
/google-ads connect | 设置、健康检查、选择帐户 |
/google-ads daily | 今天重要的是——流血的竞选、浪费、机会 |
/google-ads audit | 对所有层面进行全面的战略审查 |
/google-ads draft-summary | 查看排队的内容、优先级以及映射的依赖关系 |
分析
| 命令 | 发生了什么 |
|---|---|
/google-ads search-terms | 查找浪费、信号、消息线索、路由问题。对于PMax繁重的帐户,当经典搜索词行不可用时,会回退到查询行可见性模式 |
/google-ads intent-map | 构建账户的持久意图模型 |
/google-ads negatives | 带有范围、风险和抵押品注释的具体负面信息 |
/google-ads tracking | 该帐户是否足够值得信赖以进行优化? |
/google-ads structure | 活动/广告组重组建议 |
/google-ads rsas | RSA指示来自实际买家语言 |
/google-ads budget | 基于信号质量的预算/缩放决策 |
/google-ads plan | 从头开始规划或重建帐户架构 |
/google-ads pmax | 通过意图污染透镜进行PMax分析 |
/google-ads landing-review | 登录页面诊断——跟踪、用户体验与两者 |
法案
| 命令 | 发生了什么 |
|---|---|
/google-ads apply [draft] | 执行批准的草案——试运行、确认、验证、记录 |
/google-ads undo [rev-id] | 立即反转任何应用的操作 |
/google-ads apply log | 对所有应用内容的完整审计跟踪 |
______________________________________________________________________
为什么存在
大多数谷歌广告工具都会报告指标、执行通用最佳实践或自动出价。他们谁也没想过这个账户是什么 *实际购买*.
Google Ads Copilot从搜索意图开始——人们键入了什么,他们的意思是什么,以及帐户结构是否反映了这一现实。
| 这意味着什么 | |
|---|---|
| 意图优先 | 读取搜索行为,而不仅仅是指标 |
| 记忆 | 跨课程复合学习——永远不要从头开始 |
| 以决策为导向 | 每个输出都以“做什么”结尾,而不是“发生了什么” |
| 起草阶段 | 您可以阅读、批准或拒绝的具体提案 |
| 循环中的人类 | 没有您的明确确认,任何事情都不会改变 |
| 安全写入 | 最小爆炸半径优先,完整审计跟踪,即时撤销 |
| 适用于任何地方 | 实时API或手动导出-相同的引擎 |
______________________________________________________________________
入门指南
5分钟内试用(导出模式)
./install.sh auto- 从Google Ads导出搜索词(过去30天,CSV)
/google-ads search-terms→ 粘贴你的数据- 检查
workspace/ads/drafts/因为它发现了什么
完整设置(连接模式)
- 配置MCP服务器: data/mcp-config.md
./install.sh auto- 从提交的模板创建本地凭据/env文件:
cp data/google-ads-adc-authorized-user.template.json data/google-ads-adc-authorized-user.json cp data/google-ads-mcp.test.env.example.sh data/google-ads-mcp.test.env.sh
- 填写你的真实价值观,然后
source data/google-ads-mcp.test.env.sh ./scripts/test-mcp.sh验证连接/google-ads connect setup→ 发现您的帐户,选择一个,编写工作区/google-ads daily或/google-ads audit→ 实时数据流自动- 对于PMax繁重的帐户,请使用
./scripts/test-search-terms.sh验证查询可见性和回退行为 - 审阅草稿→ 批准→ 应用→ 验证
该仓库不提供任何真实的凭据或实时测试文件。仅提交模板。
从发布捆绑包安装
您可以像往常一样从仓库安装,也可以从打包的捆绑包安装:
./install.sh auto
./install.sh /path/to/google-ads-copilot-0.2.0.tar.gz auto
./install.sh /path/to/google-ads-copilot-0.2.0 openclaw发布包由以下组件构建 ./scripts/package/build-release.sh .
看 演示工作流.md 了解整个周期的指导性演练。
环境变量:
| 变量 | 必填 | 备注 |
|---|---|---|
GOOGLE_APPLICATION_CREDENTIALS | 是 | OAuth/ADC凭据JSON路径 |
GOOGLE_CLOUD_PROJECT | 是 | 谷歌云项目ID |
GOOGLE_ADS_DEVELOPER_TOKEN | 是 | 谷歌广告开发者令牌 |
GOOGLE_ADS_LOGIN_CUSTOMER_ID | 如果MCC | 经理帐户ID(无破折号) |
______________________________________________________________________
工作空间内存
每节课都很复杂。代理人写信给 workspace/ads/ --在运行之间生存的持久知识库:
| 文件 | 目的 |
|---|---|
account.md | 帐户配置文件和设置 |
goals.md | 业务目标和关键绩效指标 |
intent-map.md | 持久的搜索行为模型 |
queries.md | 查询模式和集群 |
negatives.md | 排除历史 |
winners.md | 什么有效,为什么有效 |
tests.md | 主动测试和假设 |
findings.md | 分析说明 |
change-log.md | 什么时候发生了变化 |
learnings.md | 这个账户教会了我们什么 |
drafts/ | 分阶段行动建议 |
audit-trail/ | 应用会话日志+反向注册表 |
使用草稿文件名 YYYY-MM-DD-[account-slug]-[type].md多草案审计也会产生 _batch-YYYY-MM-DD-[account-slug].md 作为一个持久的审计数据包,同时 _summary.md 仍然是实时优先级积压快照。
______________________________________________________________________
包结构
google-ads-copilot/
├── README.md # This file
├── ARCHITECTURE.md # Three-layer design doc
├── APPLY-LAYER.md # Apply layer design (safety, reversibility, audit)
├── OPERATOR-PLAYBOOK.md # Full operator workflow loop
├── CHANGELOG.md # Release history
├── LICENSE
├── install.sh
│
├── google-ads/ # Orchestrator skill
│ ├── SKILL.md
│ └── references/ # Strategic playbooks
│
├── scripts/ # Helper scripts + apply layer CLI
│ ├── apply-layer/ # Write-path CLI (bash + curl + jq)
│ └── list-customers.sh # Account discovery
│
├── skills/ # Analytical skills (15 skills)
│ ├── google-ads-apply/
│ ├── google-ads-audit/
│ ├── google-ads-budget/
│ ├── google-ads-connect/
│ ├── google-ads-daily/
│ ├── google-ads-draft-summary/
│ ├── google-ads-intent-map/
│ ├── google-ads-landing-review/
│ ├── google-ads-negatives/
│ ├── google-ads-plan/
│ ├── google-ads-pmax/
│ ├── google-ads-rsas/
│ ├── google-ads-search-terms/
│ ├── google-ads-structure/
│ └── google-ads-tracking/
│
├── data/ # Data layer (MCP config, GAQL recipes)
├── drafts/ # Draft templates per action type
├── examples/ # Sanitized example outputs
├── evals/ # Eval suite
└── workspace-template/ # Blank workspace for new accounts______________________________________________________________________
适用范围
| 行动 | 状态 | 风险 | 撤销 |
|---|---|---|---|
| 添加活动级别的负面关键字 | ✅ Live | Low | 删除负片 |
| 添加广告组级别的负面关键字 | ✅ 就绪 | 低 | 删除负极 |
| 暂停关键字 | ✅ 就绪 | 低 | 重新启用关键字 |
| 暂停广告组 | ✅ 就绪 | 中等 | 重新启用广告组 |
| 设置活动每日预算 | ✅ 实时(清单支持) | 中等 | 恢复之前的状态 amount_micros |
预算仅适用于活动日常预算,需要 ## Apply Manifest JSON块加硬护栏:每个动作最多30%,最小有意义增量,7天冷却,跟踪置信度门,待定跟踪草稿块,预算中性默认值,以及 confirm budgets 确认。
仍被排除在外: 共享预算、投标策略更改、活动创建、RSA编辑、启用暂停实体、删除。
______________________________________________________________________
接下来是什么
这是一个公开的alpha。分析引擎和应用层是可靠的——在真实货币的真实账户上进行了测试。当前下一步:
- 预算申请后扩大写作行动
- 更多来自真实(匿名)帐户的示例演练
- 更广泛的决策质量和写路径回归评估覆盖范围
- 包装和发布自动化,以实现更广泛的分销
如果你为客户或自己的企业运行谷歌广告,试试看。打破它。告诉我缺少了什么。
______________________________________________________________________
许可证
看 许可证.
