Facebook Ads Analyzer

专业的Facebook广告数据分析Skill，自动分析Ads Manager导出数据并提供优化建议。

功能特点

📊 自动分析：一键分析Facebook广告数据
🎯 智能评级：自动将广告分类为优秀/中等/差
💡 优化建议：提供针对性的优化方案
📈 策略生成：多套投放策略供选择
📄 报告导出：生成CSV和Markdown格式报告

快速开始

最低要求

pip install pandas numpy

基本使用

将Facebook Ads Manager导出的CSV文件告诉Claude：

请分析这个Facebook广告数据：your_file.csv

支持的功能

数据处理

✅ 自动识别UTF-8 BOM编码
✅ 数据清洗和验证
✅ 处理缺失值和异常数据

指标计算

✅ CTR（点击率）
✅ CPC（单次点击费用）
✅ CPM（千次展示费用）
✅ 互动率
✅ 转化率
✅ 综合得分

分析输出

✅ Top 10 / Bottom 10 广告
✅ 广告评级（优秀/中等/差）
✅ 地区对比分析
✅ 优化建议
✅ 投放策略方案

文件结构

.claude/skills/facebook-ads-analyzer/
├── SKILL.md              # Skill定义（核心）
├── QUICKSTART.md         # 快速入门
├── EXAMPLES.md           # 使用示例
├── README.md             # 本文件
├── REFERENCE.md          # API参考
└── scripts/              # 分析脚本
    ├── analyzer.py       # 主分析器
    ├── preprocessor.py   # 数据预处理
    ├── metrics.py        # 指标计算
    ├── diagnostic.py     # 诊断建议
    └── reporter.py       # 报告生成

使用场景

场景1：日常广告分析

分析我的Facebook广告表现

场景2：优化决策

哪些广告应该暂停？

场景3：策略规划

帮我制定下周的投放策略

场景4：地区对比

对比香港和台湾的广告表现

输出格式

results.csv

包含所有广告的详细分析结果：

基本信息（广告系列、广告组、广告名称）
核心指标（花费、展示、点击）
效率指标（CTR、CPC、CPM）
参与指标（互动率、转化率）
评分和评级

analysis_report.md

完整的分析报告，包含：

执行摘要
Top 10 / Bottom 10 广告
详细数据表
优化建议

strategy_proposal.md

投放策略方案，包含：

当前情况分析
3套完整策略
预算分配建议
行动计划

评级系统

综合得分计算

得分 = CTR标准化×30% + CPC标准化×25% + 转化率标准化×25% + 互动率标准化×20%

评级标准

| 评级 | 得分范围 | 占比 | 建议 | |------|---------|------|------| | 🟢 优秀 | > 47分 | Top 20% | 增加预算30-50% | | 🟡 中等 | 26-47分 | Middle 60% | A/B测试 | | 🔴 差 | < 26分 | Bottom 20% | 暂停或重构 |

数据要求

必需列

账户名称
广告系列名称
广告组名称
广告名称
单日
国家/地区
展示次数
已花费金额 (USD)

可选列

点击量（全部）
点击率（全部）
单次点击费用（全部）
公共主页互动
潜在客户人数
消息对话发起次数

最佳实践

定期分析：每周分析一次数据
及时优化：根据建议快速调整
A/B测试：持续测试新素材
关注转化：优化落地页提升转化率
预算分配：向优秀广告倾斜

故障排除

Skill不激活

确保使用关键词："Facebook ads"、"广告分析"
检查文件是否为CSV格式
验证文件来自Facebook Ads Manager

编码错误

确保CSV使用UTF-8编码导出
Skill会自动处理BOM字符

列名不匹配

确保使用中文列名
参考数据要求部分

结果为空

检查CSV是否有数据行
确认日期范围有效

高级功能

自定义分析

只分析香港的数据

批量处理

分析当前目录下所有Facebook广告CSV

定期报告

为我设置每周自动分析

版本历史

v1.0.0 (2026-01-09): 初始版本
- 完整的分析流程
- 综合评分算法
- 评级系统
- 报告生成
- 策略建议

贡献

欢迎提交问题和改进建议！

许可

MIT License

联系方式

如有问题，请查看EXAMPLES.md或REFERENCE.md。