259 lines
10 KiB
Markdown
259 lines
10 KiB
Markdown
# 付费广告审计工具
|
||
|
||
`广告审计` `Claude Code` `Google Ads` `Meta Ads` `营销优化`
|
||
|
||
<p align="center">
|
||
<img src="assets/banner.png" alt="Claude Ads:Claude Code 的付费广告审计技能" width="100%">
|
||
</p>
|
||
|
||
# Claude Ads:Claude Code 的付费广告审计技能
|
||
|
||
面向 Claude Code 的全面付费广告审计与优化技能。涵盖 Google Ads、Meta Ads、YouTube Ads、LinkedIn Ads、TikTok Ads、Microsoft Ads 及 Apple Search Ads,提供 190+ 项审计检查、行业专属模板以及并行子代理委托执行。
|
||
|
||
[](https://claude.ai/claude-code)
|
||
[](LICENSE)
|
||
[](https://github.com/AgriciDaniel/claude-ads/releases)
|
||
[](https://github.com/AgriciDaniel/claude-ads/actions)
|
||
|
||
> **博客:** [阅读完整的广告审计详解](https://agricidaniel.com/blog/claude-code-ad-agency)
|
||
|
||
## 目录
|
||
|
||
- [安装](#安装)
|
||
- [演示](#演示)
|
||
- [快速开始](#快速开始)
|
||
- [命令](#命令)
|
||
- [功能特性](#功能特性)
|
||
- [架构](#架构)
|
||
- [如何分析您的广告](#如何分析您的广告)
|
||
- [常见问题](#常见问题)
|
||
- [依赖要求](#依赖要求)
|
||
- [卸载](#卸载)
|
||
- [相关项目](#相关项目)
|
||
- [许可证](#许可证)
|
||
|
||
## 安装
|
||
|
||
### 一键安装(Unix/macOS/Linux)
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.sh | bash
|
||
```
|
||
|
||
### 一键安装(Windows PowerShell)
|
||
|
||
```powershell
|
||
irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/install.ps1 | iex
|
||
```
|
||
|
||
### 手动安装
|
||
|
||
```bash
|
||
git clone https://github.com/AgriciDaniel/claude-ads.git
|
||
cd claude-ads
|
||
./install.sh # Unix/macOS/Linux
|
||
```
|
||
|
||
```powershell
|
||
.\install.ps1 # Windows PowerShell
|
||
```
|
||
|
||
## 演示
|
||
|
||
<p align="center">
|
||
<img src="assets/demo.gif" alt="Claude Ads 演示" width="100%">
|
||
</p>
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 启动 Claude Code
|
||
claude
|
||
|
||
# 执行完整的多平台审计
|
||
/ads audit
|
||
|
||
# 对单一平台进行深度分析
|
||
/ads google
|
||
/ads meta
|
||
/ads linkedin
|
||
|
||
# 按业务类型进行战略规划
|
||
/ads plan saas
|
||
/ads plan ecommerce
|
||
/ads plan local-service
|
||
|
||
# 跨平台素材审计
|
||
/ads creative
|
||
|
||
# 预算与出价策略审查
|
||
/ads budget
|
||
```
|
||
|
||
## 命令
|
||
|
||
| 命令 | 描述 |
|
||
|---------|-------------|
|
||
| `/ads audit` | 通过并行子代理委托执行完整的多平台审计 |
|
||
| `/ads google` | Google Ads 深度分析(搜索、PMax、展示、YouTube、Demand Gen) |
|
||
| `/ads meta` | Meta Ads 深度分析(FB、IG、Advantage+ 购物) |
|
||
| `/ads youtube` | YouTube Ads 专项分析(可跳过广告、Shorts、Demand Gen) |
|
||
| `/ads linkedin` | LinkedIn Ads 深度分析(B2B、潜在客户开发、TLA) |
|
||
| `/ads tiktok` | TikTok Ads 深度分析(创意、Shop、Smart+) |
|
||
| `/ads microsoft` | Microsoft/Bing Ads 深度分析(Copilot、导入校验) |
|
||
| `/ads creative` | 跨平台素材质量审计与疲劳度检测 |
|
||
| `/ads landing` | 广告落地页质量评估 |
|
||
| `/ads budget` | 预算分配与出价策略审查 |
|
||
| `/ads apple` | Apple Search Ads(ASA)深度分析(广告系列结构、出价、MMP、TAP 版位) |
|
||
| `/ads plan <类型>` | 含行业模板的战略广告计划 |
|
||
| `/ads competitor` | 跨平台竞争对手广告情报分析 |
|
||
|
||
### `/ads audit`
|
||
**完整多平台审计**
|
||
|
||
启动 6 个并行子代理,同时分析您的广告账户:
|
||
- **audit-google**:跨搜索、PMax、展示、YouTube、Demand Gen 的 74 项检查
|
||
- **audit-meta**:跨 Pixel/CAPI、素材、结构、受众的 46 项检查
|
||
- **audit-creative**:21 项跨平台素材质量检查
|
||
- **audit-tracking**:7 项转化追踪健康度检查
|
||
- **audit-budget**:24 项预算与出价策略检查
|
||
- **audit-compliance**:18 项合规性与法规检查
|
||
|
||
生成统一的**广告健康分(0-100)**及优先级行动计划。
|
||
|
||
### `/ads plan <业务类型>`
|
||
**战略广告规划**
|
||
|
||
提供行业专属模板,涵盖平台组合、广告系列架构、素材策略、定向方式、预算指导方针及 KPI 目标。
|
||
|
||
**支持的业务类型:**
|
||
- `saas`:以试用/演示为重点,以 Google + LinkedIn 为主
|
||
- `ecommerce`:购物/PMax,以 ROAS 为导向,关注季节性
|
||
- `local-service`:Google 搜索 + LSA,通话追踪,地理半径定向
|
||
- `b2b-enterprise`:LinkedIn ABM,长销售周期,管道指标
|
||
- `info-products`:Meta + YouTube,网络研讨会/VSL 漏斗
|
||
- `mobile-app`:Meta + Google UAC,必须使用 MMP,LTV:CPI
|
||
- `real-estate`:特殊广告类别(住房),买家/卖家广告系列
|
||
- `healthcare`:HIPAA 合规,LegitScript,受限定向
|
||
- `finance`:特殊广告类别(信贷),必要披露声明
|
||
- `agency`:多客户管理,报告框架
|
||
- `generic`:通用模板,含平台选择问卷
|
||
|
||
## 功能特性
|
||
|
||
### 190+ 项审计检查
|
||
覆盖所有平台的全面检查,配以加权严重性评分:
|
||
|
||
| 平台 | 检查项数 | 核心领域 |
|
||
|----------|--------|-----------|
|
||
| Google Ads | 74 | 搜索、PMax、展示、YouTube、Demand Gen |
|
||
| Meta Ads | 46 | Pixel/CAPI、素材、结构、受众 |
|
||
| LinkedIn Ads | 25 | B2B 定向、TLA、潜在客户开发表单 |
|
||
| TikTok Ads | 25 | 素材优先、Smart+、TikTok Shop |
|
||
| Microsoft Ads | 20 | Google 导入、Copilot、MSAN |
|
||
| Apple Search Ads | 35 | 广告系列结构、出价、创意集、MMP、TAP 版位 |
|
||
|
||
### 广告健康分(0-100)
|
||
含严重性倍数的加权评分算法:
|
||
|
||
| 等级 | 分数 | 所需操作 |
|
||
|-------|-------|-----------------|
|
||
| A | 90-100 | 仅需小幅优化 |
|
||
| B | 75-89 | 存在一些改进空间 |
|
||
| C | 60-74 | 需关注明显问题 |
|
||
| D | 40-59 | 存在重大问题 |
|
||
| F | <40 | 需立即紧急干预 |
|
||
|
||
### 行业自动识别
|
||
从广告账户信号(商品 Feed、转化事件、平台组合、定向模式)自动识别业务类型,并加载行业专属基准与模板。
|
||
|
||
### 质量门禁
|
||
每次审计强制执行的硬性规则:
|
||
- 不得在没有智能出价的情况下推荐广泛匹配(Google)
|
||
- 3 倍淘汰规则:CPA 超过目标 3 倍时立即标记暂停
|
||
- 预算充足性:Meta 每广告组 ≥5 倍 CPA,TikTok 每广告组 ≥50 倍 CPA
|
||
- 学习期保护:学习期内禁止编辑
|
||
- 合规性:自动检查特殊广告类别(住房/信贷/金融)
|
||
|
||
### 参考数据
|
||
23 个内置参考文件,包含 2026 年最新基准数据、出价决策树、平台规范、合规要求及转化追踪实施指南。
|
||
|
||
## 架构
|
||
|
||
```
|
||
~/.claude/skills/ads/ # 主编排器
|
||
~/.claude/skills/ads/references/ # 23 个 RAG 参考文件
|
||
~/.claude/skills/ads-*/ # 17 个子技能
|
||
~/.claude/skills/ads-plan/assets/ # 11 个行业模板
|
||
~/.claude/agents/ # 10 个代理(6 个审计 + 4 个素材)
|
||
```
|
||
|
||
### 工作原理
|
||
|
||
1. **编排器**(`/ads`)将命令路由至专属子技能
|
||
2. **子技能**提供单一领域的深度分析与结构化输出
|
||
3. **代理**在完整审计时并行运行,以获得最快速度
|
||
4. **参考文件**按需加载(RAG 模式),每次分析仅加载所需内容
|
||
5. **模板**提供行业专属战略框架
|
||
|
||
## 如何分析您的广告
|
||
|
||
**Claude Ads 基于您提供的数据运行**,包括从广告平台控制台导出的文件、截图或粘贴的指标数据。它不会自动连接任何广告平台 API。
|
||
|
||
**要获得准确的账户专属建议:**
|
||
1. 导出您的账户数据(建议选取最近 30 天)
|
||
2. 运行相应命令:`/ads google`、`/ads audit` 等
|
||
3. Claude 会首先询问您的行业和预算情况——请提供这些信息以获取相关基准
|
||
4. 在提示时粘贴或分享您的数据
|
||
|
||
### 实时数据集成(可选)
|
||
|
||
如需在无需手动导出的情况下直接访问 API,可在 Claude Ads 的基础上安装 [Google Ads MCP](https://github.com/googleads/google-ads-mcp)。该 MCP 服务器可通过 API 将 Claude 直接连接至您的 Google Ads 账户。
|
||
|
||
## 常见问题
|
||
|
||
**Claude Ads 能自动登录我的广告管理平台吗?**
|
||
不能。Claude Ads 分析您提供的数据(导出文件、截图或粘贴的指标)。它不会自动连接广告平台。如需 Google Ads API 访问,请参阅上方的实时数据集成章节。
|
||
|
||
**它使用的是真实账户数据还是通用基准?**
|
||
基准数据来源于行业研究(WordStream、Triple Whale 等),覆盖 16,000 多个广告系列。这些均为平均值,您的实际结果将因行业、预算规模和账户成熟度而有所不同。运行审计时请务必提供您的行业和月度花费,以获得最相关的对比数据。
|
||
|
||
**广告投放或广告系列创建仍需手动操作吗?**
|
||
是的。Claude Ads 是一款审计与策略工具。它负责发现问题、提供修复建议并制定广告系列计划,但广告的创建、编辑或投放仍需在您的广告平台中手动操作。
|
||
|
||
**为什么某些建议对我的账户规模来说似乎不太合适?**
|
||
月花费 500 美元的账户与月花费 5 万美元的账户,其最佳实践和基准存在显著差异。请务必在开始时告知 Claude 您的预算:例如 *"我为本地水管业务每月在 Google Ads 上花费 2,000 美元"*,比直接运行 `/ads google` 而不提供背景信息的效果要好得多。
|
||
|
||
**它支持 [某平台] 的广告吗?**
|
||
目前支持:Google、Meta(Facebook/Instagram)、YouTube、LinkedIn、TikTok、Microsoft/Bing 以及 Apple Search Ads。Pinterest 及其他平台已列入路线图。
|
||
|
||
## 依赖要求
|
||
|
||
- Claude Code CLI
|
||
- Python 3.10+,含 Playwright(可选,用于实时落地页分析)
|
||
|
||
## 卸载
|
||
|
||
### Unix/macOS/Linux
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.sh | bash
|
||
```
|
||
|
||
### Windows PowerShell
|
||
|
||
```powershell
|
||
irm https://raw.githubusercontent.com/AgriciDaniel/claude-ads/main/uninstall.ps1 | iex
|
||
```
|
||
|
||
## 相关项目
|
||
|
||
- [Claude SEO](https://github.com/AgriciDaniel/claude-seo)——面向 Claude Code 的全面 SEO 分析技能
|
||
|
||
## 许可证
|
||
|
||
MIT 许可证——详见 [LICENSE](LICENSE)。
|
||
|
||
---
|
||
|
||
由 [@AgriciDaniel](https://github.com/AgriciDaniel) 为 Claude Code 构建 |